The Constitution of the MehguViewer Ecosystem.
MehguViewer.Proto contains the strict specifications, OpenAPI definitions, and architectural documentation that all MehguViewer implementations must adhere to. If it is not in this repo, it does not exist.
| Resource | Description |
|---|---|
| 📘 Documentation | The concepts, trust models, and logical flow. |
| 🔒 Auth API Spec | OIDC, Token exchange, and Global Preferences. |
| 📚 Core API Spec | Series data, Comment snapshots, and Asset delivery. |
Implementations of MehguViewer must respect the following standards defined in this repository:
We do not use raw integers or UUIDs. All IDs must follow the URN schema to facilitate Federation.
urn:mvn:user:{uuid}urn:mvn:series:{uuid}urn:mvn:asset:{hash}
- Auth Server: Handles Identity. It never stores Manga or Comments.
- Core Node: Handles Content. It never stores User Passwords or Emails.
All APIs must return strictly typed Problem Details:
{
"type": "urn:mvn:error:not-found",
"title": "Series Not Found",
"status": 404,
"detail": "The series with ID urn:mvn:series:xyz does not exist on this node.",
"instance": "/api/v1/series/xyz"
}This repository is built using Fumadocs.
# Install dependencies
pnpm install
# Start the dev server
pnpm devThe OpenAPI specifications are located in:
./openapi/auth/openapi.yaml./openapi/core/openapi.yaml
Any changes to YAML files are automatically validated against the schema on Push.
MehguViewer.Proto © 2025