Documentation

Learn how BaseBuddy maps existing Postgres and Supabase content into a safe editing workspace.

Looking for a Supabase CMS?See how BaseBuddy works as an open-source Supabase CMS.New to BaseBuddy?Understand what BaseBuddy is and what it leaves untouched.Setting it up?Install locally, add env values, and pass setup checks.Mapping tables?Learn how tables and fields become the editor.Setting up with an agent?Use schema inspection, mapping drafts, and CLI verification for agent-led setup.Need every CLI command?Use commands for setup, projects, users, mapping, sidebar, and storage metadata.Going production?Check deployment, Auth, storage, permissions, and operations.

Common starting points

Start where most people start.

IntroductionUnderstand what BaseBuddy is, what it changes, and what it deliberately leaves alone.Supabase CMSLearn how BaseBuddy works as an open-source Supabase CMS for existing tables, saved mappings, media, SEO, and permissions.WordPress-like editor for SupabaseSee how BaseBuddy gives Supabase projects a familiar editor experience without changing the underlying database schema.InstallationInstall BaseBuddy, open onboarding, and create BaseBuddy app data.First-run setupCreate BaseBuddy app data from onboarding or the CLI.ConfigurationUnderstand BaseBuddy app data, env values, database roles, and storage settings.Agent CLI setupLet an AI agent set up BaseBuddy projects with CLI commands, schema inspection, mapping drafts, and verification before saving.CLI referenceUse the BaseBuddy CLI to set up, inspect, and update BaseBuddy app data safely.Projects and mappingsCreate projects, map existing tables, save mapping revisions, and test a mapping before editors use it.Permissions and teamsManage roles, effective permissions, owner boundaries, author scopes, invites, and access troubleshooting.

All pages

Operations

Deployment, limits, backups, monitoring, and production maintenance.

DeploymentRun BaseBuddy in production with durable app data, restricted database roles, and verified TLS.OperationsBack up, upgrade, and operate a BaseBuddy install safely.Production readinessCheck BaseBuddy setup, app-data backups, storage, permissions, safe editing, and operations before production use.TroubleshootingDiagnose BaseBuddy setup, sign-in, mapping, save, upload, and deployment issues.SecurityUnderstand BaseBuddy app data, credentials, auth, TLS, storage, and diagnostics safety.Caps and rate limitsUnderstand upload limits, request body limits, API rate limits, page sizes, and why bounded reads matter.

Start

The fastest path from a fresh install to a working BaseBuddy project.

IntroductionUnderstand what BaseBuddy is, what it changes, and what it deliberately leaves alone.How BaseBuddy worksLearn the runtime flow from setup to mapping, editing, saving, publishing, and permissions.InstallationInstall BaseBuddy, open onboarding, and create BaseBuddy app data.First-run setupCreate BaseBuddy app data from onboarding or the CLI.ConfigurationUnderstand BaseBuddy app data, env values, database roles, and storage settings.App data storage optionsCompare basebuddy-data, a separate Supabase/Postgres database, and the same database as your content before choosing where BaseBuddy stores setup state.Agent CLI setupLet an AI agent set up BaseBuddy projects with CLI commands, schema inspection, mapping drafts, and verification before saving.

Concepts

The product model behind projects, mappings, storage contracts, and editor fields.

Core conceptsLearn the terms BaseBuddy uses for projects, mappings, storage contracts, semantic roles, and field behavior.Safe editing modelUnderstand how BaseBuddy avoids accidental writes, hidden conversions, and unsafe production database changes.Supabase CMSLearn how BaseBuddy works as an open-source Supabase CMS for existing tables, saved mappings, media, SEO, and permissions.WordPress-like editor for SupabaseSee how BaseBuddy gives Supabase projects a familiar editor experience without changing the underlying database schema.Postgres CMSLearn how BaseBuddy works as a self-hosted Postgres CMS for existing schemas, mapped fields, and safe content editing.

SEO Guides

Focused pages for common Supabase CMS, Postgres CMS, and self-hosted CMS searches.

Self-hosted Supabase CMSLearn how BaseBuddy works as a self-hosted Supabase CMS with app-data setup, saved mappings, and safe editor workflows.CMS for existing Postgres databaseSee how BaseBuddy turns an existing Postgres database into an editor without forcing a new CMS content model.

Mapping

How existing tables, fields, relations, and storage shapes become editable UI.

Projects and mappingsCreate projects, map existing tables, save mapping revisions, and test a mapping before editors use it.Mapping fields and relationsMap scalar fields, semantic roles, authors, categories, tags, helper rows, join tables, and relation selectors.Storage contract and UISee how BaseBuddy chooses editor controls from storage primitives, value kinds, semantic roles, and patch modes.

Editing

How editors work with content, publishing states, media, files, and safe saves.

Editing contentUnderstand the content list, editor controls, markdown behavior, validation, save behavior, and read-only fields.Publishing workflowsConfigure and use explicit publish, unpublish, and archive actions without hiding workflow changes inside Save.Media and filesConfigure media libraries, file libraries, Supabase Storage, S3-compatible storage, limits, and private URLs.

Access

Roles, permissions, team access, and author-scoped behavior.

Permissions and teamsManage roles, effective permissions, owner boundaries, author scopes, invites, and access troubleshooting.

Comparisons

Fair comparisons against CMS, Supabase CMS, and internal admin panel options.

BaseBuddy vs DirectusCompare BaseBuddy and Directus for Supabase/Postgres content editing, existing schemas, APIs, permissions, and editor workflows.BaseBuddy vs StrapiCompare BaseBuddy and Strapi for Supabase CMS use cases, existing database schemas, content modeling, and editor workflows.BaseBuddy vs Payload CMSCompare BaseBuddy and Payload CMS for Next.js teams, Supabase/Postgres content editing, and existing schema support.BaseBuddy vs WordPressCompare BaseBuddy and WordPress for teams that want a familiar editor on top of Supabase or Postgres data.BaseBuddy vs building an internal admin panelCompare BaseBuddy with a custom internal admin panel for editing content in an existing Supabase or Postgres database.BaseBuddy vs SupawaldCompare BaseBuddy and Supawald for Supabase CMS projects, storage-based content, mapped database tables, media, and editor workflows.BaseBuddy vs SupamodeCompare BaseBuddy and Supamode for Supabase CMS projects, existing schemas, self-hosting, permissions, and editor workflows.

Reference

Extra material for contributors, glossary-style reference, and deeper details.

ReferenceQuick reference for config setup, supported storage patterns, permissions, file types, limits, and glossary terms.CLI referenceUse the BaseBuddy CLI to set up, inspect, and update BaseBuddy app data safely.ContributingSet up local development, understand the codebase, run tests, write docs, and follow security disclosure rules.