Files
gitea-custom/README.md
T
cole-maxwell1 0483209214 feat(theme): align custom themes with Gitea 1.27
Import upstream Gitea light and dark themes so new defaults and syntax styles remain compatible across upgrades. Replace the custom navbar template with CSS-based logo overrides and remove redundant Chroma and CodeMirror assets.

Add theme color-scheme metadata, correct relative asset paths, apply CSP nonces to analytics scripts, and document installation, compatibility, upgrade, and licensing requirements.
2026-09-07 16:24:29 -05:00

1.5 KiB

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

  1. Update the imported Gitea version locally.
  2. Compare the custom palette with the built-in light and dark themes for that exact release.
  3. Test anonymous, authenticated, and administrator pages with light, dark, and auto themes.
  4. 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.