# 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.