Documentation

Practical product docs for setting up, mapping, editing, and operating BaseBuddy.

Docs/Production readiness

Production readiness

Check BaseBuddy setup, app-data backups, storage, permissions, safe editing, and operations before production use.

Before inviting editors, verify:

AreaReady means
App dataThe selected app-data backend exists, validates, is backed up, and is not committed
Env secretsAuth secret, database URL, and optional storage keys are set outside the repo
AuthLocal owner sign-in works
ContentThe content database is reachable
MappingSaved mapping persists after reload
EditingSave writes dirty mapped fields only
PublishingPublish, unpublish, and archive remain explicit actions
StorageMapped media/files upload and render correctly
PermissionsOwners, admins, editors, authors, and viewers see the expected actions

Run:

shpnpm setup:check
pnpm basebuddy doctor

With the default backend, use a host with persistent writable storage for basebuddy-data/. If the server replaces the app filesystem on every deploy, setup changes made from the UI will not survive. For immutable or multi-server hosts, use Supabase/Postgres app data.