Add Forgejo theme and homepage

README.md

@@ -0,0 +1,75 @@
+# GitDXD — Forgejo theme & homepage
+
+A custom theme + landing page for a self-hosted [Forgejo](https://forgejo.org)
+instance. Soft (neumorphic) UI, a colourful default palette, and a
+GitHub/GitLab-style logged-out homepage.
+
+## What's inside
+
+| Path | Purpose |
+| --- | --- |
+| `themes/` | All CSS themes plus the shared neumorphic layer |
+| `templates/home.tmpl` | Logged-out landing page |
+| `templates/home_forgejo.tmpl` | "Why not GitHub?" section used by the landing page |
+| `templates/custom/header.tmpl` | Navbar dark/light toggle (CSS + JS) |
+| `assets/img/` | Logo, favicon and the homepage reason icons |
+| `app.ini.example` | The only config you need, with **no secrets** |
+| `install.sh` | Copies everything into a Forgejo `custom/` directory |
+
+## Themes
+
+| Theme | Notes |
+| --- | --- |
+| `aurora-light` | **Default.** Soft slate base, blue primary, teal links |
+| `aurora-dark` | Neutral-charcoal dark variant |
+| `gruvbox-dark` / `gruvbox-light` | Gruvbox palette with the soft-UI layer |
+| `gruvbox-soft-dark` | Legacy alias for `gruvbox-dark` |
+| `mono-dark` / `mono-light` | Greyscale variants (retired from the default picker) |
+| `terminal` | Phosphor-green terminal palette + soft UI |
+| `forgejo-dark` / `forgejo-light` / `forgejo-auto` | Overrides of the built-in palettes + soft UI |
+
+`theme-neumorphism.css` is the shared soft-UI layer imported by every theme.
+`_base-forgejo-*.css` are snapshots of Forgejo 15.0.0's built-in themes; the
+`theme-forgejo-*.css` overrides import them. Replace the snapshots if you
+upgrade Forgejo and want the newer built-in palettes.
+
+## Install
+
+1. Copy the files into your Forgejo custom directory:
+
+   ```sh
+   ./install.sh /path/to/forgejo/custom
+   ```
+
+   (Usually `/var/lib/forgejo/custom`, `/home/forgejo/custom`, or the
+   `CustomPath` shown in *Site Administration → Configuration*.)
+
+2. Add this to `app.ini` and restart Forgejo:
+
+   ```ini
+   [ui]
+   THEMES = forgejo-auto,forgejo-light,forgejo-dark,aurora-dark,aurora-light,gruvbox-dark,gruvbox-light,gruvbox-soft-dark,terminal
+   DEFAULT_THEME = aurora-light
+   ```
+
+3. Hard-refresh the browser (`Ctrl+Shift+R`). Forgejo serves custom CSS with a
+   6-hour cache at a version-pinned URL, so a normal reload may keep the old
+   styles.
+
+## Navbar dark/light toggle
+
+`templates/custom/header.tmpl` injects a neumorphic sun/moon switch into the
+navbar (left of *Register* when logged out). It flips between `aurora-light`
+and `aurora-dark`, stores the choice in `localStorage` under `dxd-theme`, and
+applies it before the page paints.
+
+## Security / no secrets
+
+This repository intentionally contains **only** theme files, templates and
+images. It does **not** include `app.ini`, database files, access tokens,
+runner credentials, logs, or any user data. `app.ini.example` contains just the
+`[ui]` theme settings.
+
+## License
+
+No license is included yet. Add one if you want others to reuse this.