2026-09-09 15:28:27 +02:00
|
|
|
# Documentation
|
|
|
|
|
|
|
|
|
|
Technical documentation for this repository. For setup, deployment and day-to-day commands, see
|
|
|
|
|
the root [README.md](../README.md); for coding conventions and constraints, see
|
|
|
|
|
[CLAUDE.md](../CLAUDE.md). These docs explain the *structure and behavior* of the system in more
|
|
|
|
|
depth than either of those.
|
|
|
|
|
|
|
|
|
|
- [architecture.md](./architecture.md) — services, routing, request flow, environment variables.
|
2026-09-11 11:25:14 +02:00
|
|
|
- [content-model.md](./content-model.md) — PocketBase collections, admin panel, permissions, editorial workflow.
|
2026-09-09 15:28:27 +02:00
|
|
|
- [frontend.md](./frontend.md) — Nuxt routes, server (Nitro) endpoints, data flow, SEO.
|
|
|
|
|
|
|
|
|
|
## What this repository is
|
|
|
|
|
|
|
|
|
|
A blog website with two faces:
|
|
|
|
|
|
|
|
|
|
- **Public site** — anonymous visitors read articles and browse categories. Fully server-rendered,
|
|
|
|
|
no login, no client-side calls to the CMS.
|
2026-09-11 11:25:14 +02:00
|
|
|
- **Admin panel** — the site owner logs into PocketBase's admin UI (`/admin`, redirects to `/_/`)
|
|
|
|
|
to write, edit and publish articles and categories. This is the only way content changes; there
|
|
|
|
|
is no other CMS and no public user accounts.
|
2026-09-09 15:28:27 +02:00
|
|
|
|
2026-09-11 11:25:14 +02:00
|
|
|
One codebase, two runtime components (Nuxt frontend, PocketBase — CMS and database in one
|
|
|
|
|
process), fronted by a single Caddy reverse proxy on one domain.
|
