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

   ./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:

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