Thought I'd do a separate post about the new add-on I made for customizing my Bookface scheme for Friendica's "Frio" theme. Once a server admin has installed and activated it for users it would appear under Main Menu > Settings > Addons > Bookface Customizations:

The original intention of using CSS variables was to allow easy localization of the pseudo-element text labels to other languages, and let you customize more than just the "accent color" for the theme.

Only the entries you change are included in the override stylesheet added to the site. If you leave an entry blank it will not be included.

There is no validation for what you enter in the text fields to check that it is in correct format or is usable. For colors any valid CSS color declaration should work (color names, hex codes, rgb, rgba, color-mix work but gradients and images do not. You should be able to enter any Unicode text in the label variables, just be careful to escape single quotes/apostrophes with a backslash.

There is nothing to prevent you from making color combinations that will render an unusable interface. There is also nothing to prevent you from making a really, really ugly user interface, but you're the only one who will have to look at it.

This add-on's color options do not work well with "Bookface Auto" since it will automatically pick Light Mode or Dark Mode based on the device settings. It's really hard to find color combos that will work equally well in both modes. But, again, there's nothing to stop you from trying. It doesn't detect which of the Bookface schemes you've enabled.

Lastly, make sure you tick the "Enable Customizations" checkbox at the top to apply your custom settings. That checkbox gives you an easy way to turn them off and on.

Also be aware these settings, being stored on the server in your account preferences, will be applied regardless of what browser or device you use to access your account.

Okay, now that I've totally scared you out of using it, here's where server admins can go get it:

Bookface Custom Add-On Download

I have tested it in both the current stable 2024.12 and 2025.7 Release Candidate versions.

@Friendica Admins @Friendica Support #Bookface #themes #addons