50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
|
# 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
|
||
|
|
|
||
|
|
```sh
|
||
|
|
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:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
pnpm setup
|
||
|
|
pnpm build
|
||
|
|
```
|
||
|
|
|
||
|
|
The deployable static application is written to `build/`.
|
||
|
|
|
||
|
|
## NAS deployment
|
||
|
|
|
||
|
|
Suwayomi uses the custom WebUI directory:
|
||
|
|
|
||
|
|
```text
|
||
|
|
/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:
|
||
|
|
|
||
|
|
```text
|
||
|
|
/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.
|