Migrate to Nextra 4, bring the wiki into /docs, and redesign the homepage#8
Open
JoHena wants to merge 3 commits into
Open
Migrate to Nextra 4, bring the wiki into /docs, and redesign the homepage#8JoHena wants to merge 3 commits into
JoHena wants to merge 3 commits into
Conversation
added 3 commits
July 3, 2026 13:42
Moves pages/*.mdx into content/ using Nextra 4's content-directory convention, replaces theme.config.tsx + _app.tsx with app/layout.jsx and a nested (docs) route group for the Nextra Layout/Navbar/Footer, and adds the required app/[...mdxPath] catch-all and mdx-components.jsx. Pins zod to 4.3.6 via yarn resolutions to work around a shipped nextra-theme-docs@4.6.1/zod-4.4.x incompatibility, and disables webpack's persistent cache (silently hangs the build on this machine). The homepage moves to a dedicated app/page.jsx (a literal route can't share a segment with an optional catch-all, and per-page theme overrides for it don't apply reliably in dev). The two redirect pages (tachiyomi-extension, tracker-oauth) move their hook logic into real client components since App Router pages are server components by default.
Brings the 5 existing wiki pages (configuration, extensions, local source, data directory, troubleshooting) into a proper /docs section with internal links, and adds two new pages authored from the Suwayomi-Server README: a clients overview and an FAQ. Clients render as a custom card grid (icon, title, description) via ClientIcon/ClientCard rather than Nextra's built-in Cards.Card, which was too compact and squished the icon/title/text together.
Replaces the plain centered hero with a multi-panel "manga page" composition: a dark stage holding a main panel (title/subtitle), two info panels (extensions, any client), a full-width screenshot of the bundled WebUI, and a CTA panel up top - all bordered with visible gutters between them, using the actual Suwayomi logo (pulled from the Suwayomi-Server repo) as a stamped corner badge and the project's real teal/black brand colors instead of placeholder ones.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Troubleshooting) now live in a /docs section on the site, plus two new pages: an FAQ and a Clients overview.
Framework migration (Nextra 2 → 4)
Docs content
since I wrote that copy rather than moving existing text
Homepage