Repository navigation
0.4.0
Release 0.4.0
Pull request, issue, release and dashboard pages were compared against GitHub page by page and brought in line with it. The account-level issue, pull request, milestone and notification pages get GitHub's list layout for the first time. The theme no longer serves a font: like GitHub's own pages it uses the visitor's system fonts, so it matches GitHub on every machine.
Compatibility
This release targets Forgejo 16.
It was tested against Forgejo 16.0.3, including the bundled template overrides.
Changelog
Features
- Dashboard: Give the issue, pull request, milestone and notification pages GitHub's list layout by @whereareiam in #82
Changes
- Fonts: Use GitHub's font lists and stop serving Mona Sans by @whereareiam in #80
- Pull request: Draw timeline connectors only between neighbouring entries by @whereareiam in #79
- Issues: Lay out the new issue page like GitHub's, match list and state details by @whereareiam in #78
- Pull requests: Match GitHub's list layout by @whereareiam in #70
- Pull requests: Match GitHub's timeline text, tabs, merge box and editor by @whereareiam in #69
Fixes
- Pull request: Make the Update branch menu a single-choice menu by @whereareiam in #84
- Pull request: Show a scheduled merge as a merge box section by @whereareiam in #83
- Organization: Match GitHub's header and drop the doubled line above the repository list by @whereareiam in #74
- Releases: Match GitHub's release details, single-release view and new-release form by @whereareiam in #81
- Pull request: Stop the merge menu jumping, keep the header still between tabs, tidy the reviewer row by @whereareiam in #77
- Pull request: Match GitHub's state colours for closed, draft, merged and blocked pull requests by @whereareiam in #76
- Pull request: Restyle the review panel and diff comment forms, keep primary buttons green on focus by @whereareiam in #75
- Pull request: Match GitHub's reaction picker, merge box and merge button states by @whereareiam in #73
- Pull request: Align the merge box states, method menu and merge form with GitHub by @whereareiam in #72
- Templates: Version the theme stylesheet so updates bypass the browser cache by @whereareiam in #71
Installation
- Base:
theme-github-base.tar.gz— standard light, dark, auto, and soft-dark themes. - Accessibility:
theme-github-accessibility.tar.gz— colorblind and high-contrast themes. - Extras:
theme-github-extras.tar.gz— Pink, Gitea-compatible, and Catppuccin palettes. - Templates:
theme-github-templates.tar.gz— Forgejo template overrides with their required JavaScript and page-specific CSS.
Install theme CSS into <forgejo-data>/public/assets/css and extract the template archive into <forgejo-data>. See the installation guide.
Upgrading from 0.3.0
Replace the theme CSS, the templates, and everything under public/assets/css and public/assets/js from the template archive together, then restart Forgejo. The templates and their assets must come from the same release: this release adds component and page stylesheets under public/assets/css/components, and the templates link each asset by its content version.
Fonts. There is no theme-github-fonts.tar.gz any more. The theme keeps GitHub's font lists ("Mona Sans VF" and "Monaspace Neon" first) but serves no font files, exactly as GitHub's repository pages do, so text renders in the system fonts unless those fonts are installed. You can delete <forgejo-data>/public/assets/fonts/MonaSansVF-v2.0.27.woff2 and its licence file; nothing references them. If you mount that directory separately, the mount can go too.
New template overrides. This release adds overrides for the new issue page (repo/issue/new.tmpl), the dashboard issue, pull request and milestone lists (user/dashboard/issues.tmpl, user/dashboard/milestones.tmpl) and the notifications page (user/notification/notification_div.tmpl). If you maintain your own overrides of these, yours are replaced by the archive.
Appearance changes you may notice.
/issues,/pulls,/milestonesand/notificationshave a sidebar with the views and their counts; the dashboard context switcher moved from a bar across the page to the top of that sidebar.- A pull request's timeline draws a line only between neighbouring entries. It no longer runs past the last entry or alongside review boxes. This is a deliberate departure from GitHub.
- Closed pull requests show a red state label, drafts a solid grey one, and a merged pull request's box has a purple border.
- A single release shows a "Releases / title" breadcrumb instead of the Releases/Tags bar.
- Green buttons stay green after a click; they previously turned blue until they lost focus.
Forgejo links the theme-github-*.css files itself and lets browsers cache them for up to six hours. Since 0.3.0 the theme adds its own version to that link, so an upgrade is picked up without a hard reload.
Template overrides are intended for the tested Forgejo version. Forgejo's native permissions and visibility rules remain in effect.