custom styling for forgejo
  • CSS 86.2%
  • Go Template 12%
  • Vim Snippet 1.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-02 12:05:29 +02:00
custom added header tmpl 2026-09-02 12:00:27 +02:00
icon added icon 2026-09-02 12:03:45 +02:00
app.ini.snippet Initial Commit 2026-09-02 11:58:02 +02:00
README.md Update README.md 2026-09-02 12:05:29 +02:00

sooorge forgejo theme

Sooorge (git.sooox.cc) reskinned to match my portfolio sooox.cc

Built for Forgejo 16.0.2+gitea-1.22.0. Uses Forgejo's supported customization points only

Layout

This mirrors Forgejo's custom/ directory (WORK_PATH/custom, i.e. /var/lib/forgejo/custom on this instance):

custom/
├── public/assets/css/custom.css      # theme override, loaded via header.tmpl hook
└── templates/
    ├── home.tmpl                     # full override of the anon landing page
    └── custom/header.tmpl            # injects <link> to custom.css into <head>
app.ini.snippet                       # [ui] section to merge into app.ini (not a full app.ini)

Deploy

cp -r custom/* /var/lib/forgejo/custom/
chown -R git:git /var/lib/forgejo/custom
# merge app.ini.snippet's [ui] section into /etc/forgejo/app.ini by hand
systemctl restart forgejo

When you edit custom.css, bump the ?v=N query string in custom/templates/custom/header.tmpl: Forgejo serves it with Cache-Control: private, max-age=21600 (6h), so browsers won't pick up a change at the same URL until then otherwise.