GitDXD — Forgejo theme & homepage

A custom theme + landing page for a self-hosted Forgejo 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
`2026-dark`	Default. Obsidian-midnight dark with electric cyan, emerald-teal, violet & coral accents, crisp 1px specular borders, and ambient glow (inspired by Omarchy, JetBrains, GitHub, GitLab, CachyOS, Hack Club & Lovable)
`aurora-light`	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

Copy the files into your Forgejo custom directory:
```
./install.sh /path/to/forgejo/custom
```
(Usually /var/lib/forgejo/custom, /home/forgejo/custom, or the CustomPath shown in Site Administration → Configuration.)

Add this to app.ini and restart Forgejo:

[ui]
THEMES = forgejo-auto,forgejo-light,forgejo-dark,2026-dark,aurora-dark,aurora-light,gruvbox-dark,gruvbox-light,gruvbox-soft-dark,terminal
DEFAULT_THEME = 2026-dark

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.

templates/custom/header.tmpl injects a neumorphic sun/moon switch into the navbar (left of Register when logged out). It flips between 2026-dark and aurora-light, stores the choice in localStorage under dxd-theme-2026, 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

This project is licensed under the GNU General Public License, version 3 only (GPL-3.0-only).

See LICENSE for the full text.

3.2 KiB Raw Permalink Blame History