# CodeCraftsmen Gitea Theme

Custom themes and branding for the CodeCraftsmen Gitea instance.

## Compatibility

The theme supports Gitea 1.27.x and is currently synchronized with Gitea 1.27.3.
The light and dark themes are self-contained copies of the matching built-in
theme variable sets with CodeCraftsmen palette and typography overrides. The
auto theme conditionally imports those two local theme files according to the
user's preferred color scheme.

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:

```ini
[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. Compare the custom light and dark variable sets with the built-in themes from
   the exact target release.
2. Add, remove, or rename variables to match that release while preserving the
   CodeCraftsmen palette values.
3. Test anonymous, authenticated, and administrator pages with all six themes,
   including both system color schemes for the two 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.