Replace Strapi CMS with PocketBase

Strapi + Postgres are gone in favor of PocketBase: a single Go binary
with embedded SQLite, built-in admin UI and per-collection API rules.
No content existed yet, so this is a clean swap with no data migration.

Collections and rules are defined as code in pocketbase/pb_migrations/
and applied automatically on first boot. Draft & Publish has no native
PocketBase equivalent, so it's reproduced with a nullable `publishedAt`
field enforced by listRule/viewRule, matching the old Strapi semantics.

Routing flips: PocketBase's admin UI and REST/file API are hardwired to
`/_/` and `/api/*` at the domain root (its own dashboard assets and API
calls reference those paths directly, so a stripped path prefix like
`/admin/*` would break them). `/api` is therefore reserved for
PocketBase now, and the frontend's Nitro endpoints move to `/content/*`
(frontend/server/routes/content/, not server/api/). A `/admin` vanity
route in Nitro (not Caddy) redirects to `/_/`, so it works the same in
dev, where Caddy isn't part of the stack, and in production.

frontend/server/utils/strapi.ts becomes pocketbase.ts; queries.ts is
rewritten for PocketBase's filter/sort/fields/expand query syntax.
StrapiImage becomes MediaImage (no width/height — PocketBase file
fields don't store dimensions, and the cover images already reserve
their aspect ratio via CSS, so this is not a regression).

docs/*.md, CLAUDE.md and README.md are updated in the same commit.
This commit is contained in:
2026-09-11 11:25:14 +02:00
parent 91540224a9
commit 49c42ecc96
64 changed files with 546 additions and 22706 deletions
+17
View File
@@ -0,0 +1,17 @@
FROM alpine:3.20 AS download
ARG PB_VERSION=0.40.3
RUN apk add --no-cache unzip curl ca-certificates
RUN curl -Lo /tmp/pb.zip \
https://github.com/pocketbase/pocketbase/releases/download/v${PB_VERSION}/pocketbase_${PB_VERSION}_linux_amd64.zip \
&& unzip /tmp/pb.zip -d /pb
FROM alpine:3.20 AS runtime
RUN apk add --no-cache ca-certificates wget
WORKDIR /pb
COPY --from=download /pb/pocketbase /usr/local/bin/pocketbase
COPY pb_migrations ./pb_migrations
COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
RUN chmod +x /usr/local/bin/docker-entrypoint.sh
EXPOSE 8090
ENTRYPOINT ["docker-entrypoint.sh"]
CMD ["pocketbase", "serve", "--http=0.0.0.0:8090"]
+10
View File
@@ -0,0 +1,10 @@
#!/bin/sh
set -e
# Idempotent: safe to run on every start, including restarts of an existing
# pb_data volume (upsert, not create).
if [ -n "$POCKETBASE_ADMIN_EMAIL" ] && [ -n "$POCKETBASE_ADMIN_PASSWORD" ]; then
pocketbase superuser upsert "$POCKETBASE_ADMIN_EMAIL" "$POCKETBASE_ADMIN_PASSWORD"
fi
exec "$@"
@@ -0,0 +1,26 @@
/// <reference path="../pb_data/types.d.ts" />
migrate((app) => {
const collection = new Collection({
type: 'base',
name: 'categories',
listRule: '',
viewRule: '',
createRule: null,
updateRule: null,
deleteRule: null,
fields: [
{ type: 'text', name: 'name', required: true, max: 160 },
{ type: 'text', name: 'slug', required: true, max: 160, pattern: '^[a-z0-9]+(-[a-z0-9]+)*$' },
{ type: 'autodate', name: 'created', onCreate: true },
{ type: 'autodate', name: 'updated', onCreate: true, onUpdate: true },
],
indexes: [
'CREATE UNIQUE INDEX idx_categories_slug ON categories (slug)',
'CREATE UNIQUE INDEX idx_categories_name ON categories (name)',
],
})
app.save(collection)
}, (app) => {
app.delete(app.findCollectionByNameOrId('categories'))
})
@@ -0,0 +1,45 @@
/// <reference path="../pb_data/types.d.ts" />
// publishedAt mirrors Strapi's Draft & Publish semantics: empty = draft, set
// (and not in the future) = published. listRule/viewRule enforce this, so an
// unpublished or scheduled article is invisible to the public API by
// construction, not by a check in application code.
migrate((app) => {
const categories = app.findCollectionByNameOrId('categories')
const collection = new Collection({
type: 'base',
name: 'articles',
listRule: "publishedAt != '' && publishedAt <= @now",
viewRule: "publishedAt != '' && publishedAt <= @now",
createRule: null,
updateRule: null,
deleteRule: null,
fields: [
{ type: 'text', name: 'title', required: true, max: 160 },
{ type: 'text', name: 'slug', required: true, max: 160, pattern: '^[a-z0-9]+(-[a-z0-9]+)*$' },
{ type: 'text', name: 'content', required: true },
{
type: 'file',
name: 'cover',
maxSelect: 1,
maxSize: 10485760,
mimeTypes: ['image/png', 'image/jpeg', 'image/webp', 'image/avif', 'image/gif'],
},
{ type: 'text', name: 'coverAlt', max: 200 },
{ type: 'relation', name: 'category', collectionId: categories.id, maxSelect: 1 },
{ type: 'date', name: 'publishedAt' },
{ type: 'text', name: 'authorName', max: 160 },
{ type: 'autodate', name: 'created', onCreate: true },
{ type: 'autodate', name: 'updated', onCreate: true, onUpdate: true },
],
indexes: [
'CREATE UNIQUE INDEX idx_articles_slug ON articles (slug)',
'CREATE INDEX idx_articles_category ON articles (category)',
'CREATE INDEX idx_articles_published ON articles (publishedAt)',
],
})
app.save(collection)
}, (app) => {
app.delete(app.findCollectionByNameOrId('articles'))
})