1.5 KiB
Material You fork maintenance
This branch keeps Suwayomi behavior upstream-compatible and confines the visual fork to theme services, navigation components, manga presentation, and reader chrome.
Update from upstream
git fetch origin
git switch codex/material-you
git rebase origin/master
pnpm test:material-you
pnpm format:check
pnpm lint
pnpm tsc
pnpm build
Resolve upstream conflicts by preserving server requests, GraphQL types, routing, reader state, and settings behavior. Material You additions should remain presentation-only.
Build
Use Node 24 or newer and pnpm 11.1.2 or newer:
pnpm setup
pnpm build
The deployable static application is written to build/.
NAS deployment
Suwayomi uses the custom WebUI directory:
/vol4/1000/docker-software/manga-stack/suwayomi/webUI
Before each release, copy server.conf and the complete live webUI/ directory into a timestamped directory below:
/vol4/1000/docker-software/.integration-backups/
Upload build/ to a sibling staging directory, compare file counts and hashes, then rename the staging directory to webUI in one operation. Keep webUI.flavor=CUSTOM and the automatic WebUI update interval at 0. Recreate only the suwayomi service and force-refresh browser/PWA caches.
Rollback
Stop or recreate only Suwayomi, move the failed live webUI/ aside, restore the backed-up webUI/ and server.conf, then recreate Suwayomi. Verify HTTP 200, the GraphQL { __typename } query, hashed assets, and container logs before closing the rollback.