# 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:

```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. 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.