Skip to content

Get started

How to use the production Manga Sync surface and its Paperback source.

Updated View as Markdown
For humans

Manga Sync is a personal-first layer between a canonical manga identity and the providers you read from. The public surface is intentionally small: use the docs to understand the workers, then use the API or Paperback source.

The production surface

There is one public hostname:

https://df.criccadamus.eu

The router serves the Nimbus documentation at the hostname root and mounts the health check and sync API under /api/*, plus the Paperback source repository under /paperback/.

First steps

Read the worker map

Start with the router, then follow the links to the SyncApi and PaperbackCatalog pages.

Search canonically

Use GET /api/v1/canonical/search?q=... to search AniList and MyAnimeList records before matching provider-specific entries.

Install the source

Add the production URL from the source repository page in Paperback, then configure its personal API token in the source settings. Save titles to your library before reading so chapter reads sync.

The sync model

The canonical record is the stable identity. MangaDex and Comix are provider adapters matched to that identity; neither provider owns the personal record. Changes are written to the personal Durable Object first, and remote sync is a separate operation.

Provider login state stays with the client that owns it. In particular, Paperback browser cookies are not sent through the sync API.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close