Your database.
Your infrastructure.

Connect SCHMA to your PostgreSQL database. Model and manage structured content while keeping your data in infrastructure you control.

Your data shouldn't be tied to your CMS.

Traditional content management systems treat your database as proprietary storage, metering database size and restricting direct access. SCHMA is built on a different model: your database stays in your infrastructure, and SCHMA provides the workflow layer around it.

Three architectural principles of database sovereignty.

Decoupling the content workflow plane from persistent database storage transforms reliability, cost predictability, and developer autonomy.

Infrastructure sovereignty

You control the PostgreSQL database that stores your content. Host on Supabase, Neon, AWS RDS, Railway, or self-hosted servers with root access, firewall rules, and your own hosting accounts.

Capacity independence

SCHMA does not impose a database-size quota on customer-owned PostgreSQL. Storage limits, row counts, and IOPS are governed entirely by your database provider—with no markups or artificial caps.

SQL coexistence

Content lives in standard relational tables inside your schema. Editorial teams manage structured content in Studio, while developers query tables directly using standard SQL, ORMs, and existing tools.

Your database. SCHMA's content workflow.

Your PostgreSQL instance stores all content payloads and revisions as standard relational tables. SCHMA connects over encrypted TLS to orchestrate schema modeling and editorial workflows, while serving published content through an edge-cached delivery layer that shields your database from frontend read volume.

TECHNICAL ARCHITECTURE|Dual-Access Data Plane
SSL Required · Port 5432 / 6543 · Direct SQL & Edge Delivery

Customer PostgreSQL

01 / Persistence
public.schma_entriesContent payloads and drafts in JSONB
public.schma_revisionsImmutable audit log snapshots
Application SchemasCustom tables with direct SQL joins
Direct SQL: Unrestricted query access via psql, Prisma, Drizzle

SCHMA Engine

02 / Orchestration
Studio Content Modeling11 visual field types, staged DDL migrations
Global Edge Cachings-maxage=60 cache acceleration

Consumers & Clients

03 / Client Tier
Modern FrontendsNext.js, Remix, Astro applications
TypeScript SDK@schmadev/client typed interface
Sovereign database state

If you disconnect SCHMA, your content remains in standard PostgreSQL tables in your database. Zero proprietary conversion or export lock-in.

No platform custody

SCHMA stores connection credentials encrypted at rest and never assumes exclusive custody or operational restriction over your database instance.

Direct SQL query access

Join content tables directly with internal user or product records using standard SQL queries without routing through CMS APIs.

Your database. Your limits.

SCHMA supports two database ownership models: connect your own PostgreSQL infrastructure with zero database-size quotas from SCHMA, or use managed PostgreSQL provisioned by SCHMA with plan allocations. Media storage and delivery API requests are accounted separately.

Customer-Owned PostgreSQLUnmetered
Unmetered
No database-size quota imposed by SCHMA
SCHMA-Managed StorageTurnkey
100 MB / 1 GB
Free: 100 MB · Pro: 1 GB
Disk governance & scaling
Customer-Owned PostgreSQL
Governed by your provider

Storage capacity, disk limits, compute, and IOPS auto-scaling are governed strictly by your database provider (Supabase, Neon, AWS RDS, Railway).

SCHMA-Managed Storage
Turnkey provisioning

Automated TLS setup, schema migrations, and daily maintenance without configuring external cloud database infrastructure.

Plan availability & limits
Customer-Owned PostgreSQL
Available on all plans

Zero database-size quota on Free and Pro. Pro adds host migration tooling, multiple connection targets, and audit logging.

SCHMA-Managed Storage
Fixed plan allocations

Fixed database storage allocations: 100 MB on Free and 1 GB on Pro.

Data custody & SQL access
Customer-Owned PostgreSQL
100% customer custody

You retain direct SQL query access via psql, Prisma, Drizzle, and BI tools. If you disconnect, data stays in your database.

SCHMA-Managed Storage
Export portability

Export structured content records anytime via delivery APIs and standard JSON formats with zero platform lock-in.

Compatibility requirement
Customer-Owned PostgreSQL
PostgreSQL 15+ & pgvector

SCHMA requires a customer-owned PostgreSQL 15+ database with the pgvector extension installed and enabled, and standard SSL/TLS. Supports direct port 5432 or transaction poolers on port 6543.

SCHMA-Managed Storage
Managed connection layer

Provisioned automatically with managed connection poolers and zero external networking configuration required.

Custody model:100% Customer Provider Custody
Managed capacity:100 MB (Free) · 1 GB (Pro)
MEDIA & ASSETSObject Storage
Independent Media & Asset Storage

Media library assets (images, documents, and static uploads) are served from global CDN object storage and accounted separately from PostgreSQL database storage. Media uploads do not consume database disk space.

Tier limits:Free: 100 MB · Pro: 1 GB
DELIVERY TRAFFICEdge API Cache
Edge Delivery API Allowances

Published content queries are edge-cached globally with standard cache headers. REST (/v1/delivery/entries) and GraphQL endpoints share workspace monthly request allowances.

Tier quotas:Free: 10k/mo · Pro: 100k/mo

From connection to delivery.

A practical technical progression that fits directly into your developer stack without proprietary wrappers or opaque abstractions.

01

Connect your database

Provide your PostgreSQL connection string over SSL during workspace initialization. SCHMA creates dedicated public.schma_* tables, leaving your application schemas untouched and ready for content modeling.

02

Model structured schemas

Define content types visually in Studio using canonical field types, validation rules, and relations. Staged migrations generate dynamic editorial forms for your team.

03

Author and publish entries

Editorial teams compose content with live drafts and immutable version history written to your PostgreSQL instance. Committing entries invalidates the edge cache for instant delivery.

04

Deliver via edge APIs

Query published content using the @schmadev/client TypeScript SDK, REST (/v1/delivery/entries), or GraphQL endpoints with global edge caching and automatic type safety.

app/articles/page.tsx
import { createClient } from "@schmadev/client";

// Initialize client with environment credentials
const schma = createClient({
  apiKey: process.env.SCHMA_DELIVERY_KEY!,
  workspace: "production",
});

// Fetch published entries backed by your PostgreSQL database
const { data: articles } = await schma.delivery.listEntries({
  type: "article",
  limit: 10,
  populate: ["author"],
});

console.log(articles[0].title); // Fully typed response
// Standard Delivery Response Headers
Cache-Control: public, s-maxage=60, stale-while-revalidate=300
X-Ratelimit-Limit: 300 req/min (Pro)
X-Quota-Remaining: Delivery requests pool

Clear ownership. Clear responsibilities.

An explicit division between the database infrastructure you operate and the content management and delivery services SCHMA provides.

Infrastructure & Hosting
Customer responsibility
Provider hosting & compute

You operate the database host account (Supabase, Neon, AWS RDS, Railway, or self-hosted) and manage storage capacity, compute resources, and disk scaling.

SCHMA responsibility
Encrypted credential handling

Database connection strings are encrypted at rest using AES-256-GCM and accessed solely to perform authorized content operations.

Backups & Schema DDL
Customer responsibility
Backups & point-in-time recovery

Database backups, WAL archiving, retention policies, and disaster recovery procedures are configured and executed by your database provider.

SCHMA responsibility
Isolated schema migrations

SCHMA applies non-destructive, idempotent DDL updates confined strictly to dedicated public.schma_* content tables.

Network & Traffic Delivery
Customer responsibility
Network security & access control

You configure SSL enforcement, IP allowlists, firewall perimeters, and connection routing (direct port 5432 or transaction poolers).

SCHMA responsibility
Edge delivery acceleration

Published content is cached and served across global edge nodes with standard cache headers (s-maxage=60), insulating your database from read spikes.

Data Access & Events
Customer responsibility
Application tables & permissions

You maintain full control over custom application schemas, user permissions, and direct SQL queries without CMS interference.

SCHMA responsibility
Webhook delivery & signatures

Content events dispatch outbound webhooks with cryptographic HMAC-SHA256 signatures, timestamp verification, and exponential retry handling.

Custody model:Customer Provider Governance
Security model:AES-256 Control Plane

Frequently asked questions.

Your database. Your workflow. Your next step.

Connect your PostgreSQL database to SCHMA and manage structured content within the infrastructure you already run.