cole-maxwell1
b21d961929
Extend theme-aware logo switching to the home page hero logo, which previously never changed with the active color scheme, and keep the navbar logo switching in the same CSS-only mechanism. Replace the header template synchronization script with theme CSS background images so logos render correctly at first paint, work with JavaScript disabled, and avoid WebKit replaced-element repaint behavior. Hide the upstream images as layout placeholders and use selectors that outrank Gitea's navbar hover styles. Add an AGENTS.md guide documenting repository scope, theme and template constraints, verification expectations, and the manual deployment flow.
CodeCraftsmen Gitea Theme
Custom themes and branding for the CodeCraftsmen Gitea instance.
Compatibility
The theme supports Gitea 1.27.x. Each custom theme imports the matching built-in Gitea theme and overrides only the CodeCraftsmen palette, typography, and logo. This allows new upstream theme variables to retain their Gitea defaults.
The repository intentionally avoids overriding Gitea's internal templates. The navbar logo is replaced through theme CSS so Gitea template changes are applied normally during upgrades.
Installation
Copy public and templates into the instance's Gitea custom path, configure
the available themes, and restart Gitea:
[ui]
THEMES = gitea-auto,gitea-light,gitea-dark,codecraftsmen-auto,codecraftsmen-light,codecraftsmen-dark
DEFAULT_THEME = codecraftsmen-auto
The homelab repository vendors these files under
ansible/roles/gitea/files/theme so a Gitea rebuild does not depend on this
repository being available from the Gitea instance.
Upgrade Process
- Update the imported Gitea version locally.
- Compare the custom palette with the built-in light and dark themes for that exact release.
- Test anonymous, authenticated, and administrator pages with light, dark, and auto themes.
- Synchronize the reviewed files into the homelab Gitea role.
Assets
The font and branding files are project-supplied assets. Their presence in this repository does not grant redistribution rights. Confirm the applicable font and brand licenses before making the repository public or redistributing it.