OSPREY · HEADLESS CMS

Content infrastructure for developers.

Free, open-source, self-hosted. A headless CMS that starts with code — typed collections, REST API, visual page builder, plugin marketplace, and CLI setup wizard. Multi-tenant by design.

Start free → Request demo →

Free Open source Self-hosted EU-hosted available

collection.config.ts

import  defineCollection  from '@osprey/core'

export default defineCollection(
  name: 'BlogPost',
  slug: 'blog-posts',
  auth: true,
  fields: [
     name: 'title',   type: 'text',  required: true  ,
     name: 'slug',    type: 'slug',  from: 'title'  ,
     name: 'body',    type: 'richtext'                ,
     name: 'cover',   type: 'media'                   ,
     name: 'status',  type: 'select',
      options: ['draft', 'published']          ,
     name: 'author',  type: 'relation',
      to: 'Users'                            ,
  ],
  hooks: 
    beforeCreate: [setPublishedAt],
  ,
)

@osprey/core · TypeScript schema valid

9 Core packages

7 Plugins

7 Starter templates

72 CLI tests

TypeScript Schema first

EU Data residency

THE ADMIN

Real captures.
Not mockups.

Screenshots of the shipped admin — editor, collections, and dashboard. Dark theme, the way the console ships.

CAPABILITIES

Everything a CMS
should be.

Code-first architecture that generates the admin panel, REST API, and typed client SDK from your schema — with zero lock-in.

Code-first collections

Define your data schema in TypeScript. Osprey generates the admin CRUD UI, REST API endpoints, and a fully-typed client SDK from a single config file. Zod-validated, Prisma-backed.

15+ field types: text, richtext, slug, select, relation, media, number, date…
Lifecycle hooks: beforeCreate, afterUpdate, afterDelete
Per-locale field validation with Zod

Visual page builder

Two editor modes: Flow (vertical list with properties panel) and Canvas (1440px freeform drag/resize with 8 handles, layer panel, breakpoint switcher). 11 block types included.

Multi-tenant by design

Every collection query is scoped to a tenant via TenantContext. OspreyDB enforces isolation at the database layer — no cross-tenant data leaks by construction.

Plugin ecosystem

Install SEO, blog, contact-form, ecommerce, analytics, redirects, or scheduled-publish with one line. Build your own plugin with the definePlugin API.

7 starter templates

Get running in minutes: vetrina, corporate, blog, landing-page, saas-pricing, portfolio, ecommerce. All starters include seed pages and a frontend example.

CLI + web wizard

osprey setup walks you through project creation interactively. Or use the web wizard at /setup, or run the native osprey-launcher installer.

HOW IT WORKS

From schema to API
in minutes.

Write your collection definition once. Osprey takes care of the database schema, admin UI, REST endpoints, and typed SDK — you just write the product.

Define collections

Type-safe field definitions with validation, hooks, and relations.

Push schema

osprey schema-push migrates your database and regenerates the Prisma client.

Query via SDK

Fully-typed @osprey/client with filters, pagination, locale, and media resolution.

Deploy

Self-host on your own server or use the Altovar-managed instance.

// @osprey/client — typed response, zero casting
import  OspreyClient  from '@osprey/client'

const osprey = new OspreyClient(
  endpoint: process.env.OSPREY_URL,
  apiKey: process.env.OSPREY_API_KEY,
)

const posts = await osprey.blogPosts.find(
  where:  status: 'published' ,
  locale: 'en',
  limit: 10,
  populate: ['cover', 'author'],
)

// posts.docs is typed: BlogPost[]
// posts.totalDocs, posts.page, posts.totalPages

# GET — paginated list with filters
GET /api/v1/blog-posts
  ?where[status]=published
  &locale=en
  &limit=10
  &populate=cover,author

# Response

  "docs": [ /* BlogPost[] */ ],
  "totalDocs": 148,
  "page": 1,
  "totalPages": 15,
  "hasNextPage": true


# Auth: Bearer token or API key header
Authorization: Bearer <token>

# Interactive setup wizard
$ osprey setup

  ? Project name: my-cms
  ? Starter template: [blog]
  ? Database URL: postgresql://...
  ? Admin email: [email protected]
  ? EU-hosted deployment: yes

  ✓ Schema pushed
  ✓ Admin user created
  ✓ Dev server running at localhost:3000

# Add a collection
$ osprey collection-add

# Generate TypeScript types
$ osprey generate-types

ARCHITECTURE

Nine packages.
One coherent system.

@osprey/core

Field types, collections, Zod validation, Prisma codegen, query engine, locale support, hooks, globals, plugin framework, page and block types.

@osprey/admin

Admin panel, collection browser, visual page builder V1 (flow) + V2 (canvas), site structure editor, plugin marketplace.

@osprey/api

REST API routes: CRUD, media upload, globals, pages. Auto-generated from collection config.

@osprey/client

Typed SDK, PagesClient, SiteClient, BlockRenderer (@osprey/client/react) — React optional, no dep for non-React consumers.

@osprey/cli

setup · init · dev · build · schema-push · generate-types · collection-add · starters · link. 72 passing tests.

@osprey/db

TenantContext, OspreyDB class, CRUD with tenant-scoped isolation at the database layer.

@osprey/auth

JWT (jose HS256), API key authentication, and Edge middleware for route protection.

@osprey/media

S3-compatible storage, presigned URL generation, media metadata, image resizing pipeline.

@osprey/themes

defineTheme, hex-to-HSL CSS token generation, 4 preset themes for the admin panel.

PLUGINS

Extend in
one line.

Official plugins ship with Osprey. Build and publish your own with the plugin API — or browse the admin marketplace.

SEO
Meta tags, OG image, structured data, sitemap generation.
Blog
Posts, categories, tags, authors, RSS, reading time.
Ecommerce
Products, variants, cart, orders, Stripe integration.
Contact Form
Submissions, spam filtering, webhook delivery, email notifications.
Analytics
Privacy-first page views and events, no third-party tracking.
Redirects
Managed 301/302 redirect rules with wildcard support.
Scheduled Publish
Queue content to publish or unpublish at a specific datetime.

STARTER TEMPLATES

Ship in
minutes.

Every starter includes seed pages, a complete collection config, and a FRONTEND_EXAMPLE.md showing how to wire the Osprey SDK.

Blog

Posts, tags, authors, RSS, SEO plugin pre-configured.

Landing Page

Hero, features, pricing, FAQ, CTA — all as page builder blocks.

SaaS Pricing

Pricing tiers, feature comparison table, testimonials, waitlist form.

Ecommerce

Product catalog, cart, checkout, order management, Stripe Connect.

Portfolio

Projects, case studies, skills, contact form, dark theme.

Corporate

Multi-page company site with news, team, services, and localization.

Vetrina

Single-product showcase site with gallery, specs, and booking form.

PAGE BUILDER

Visual editing
that doesn't fight you.

Switch between Flow mode (structured vertical list) and Canvas mode (freeform 1440px workspace with drag, resize, z-order, and breakpoint preview). Designers and developers stay in sync.

Flow mode

Blocks in a vertical list. Each block has a property panel on the right. Ideal for content-heavy pages.

Canvas mode

Pixel-perfect layout at 1440px. Drag, resize with 8 handles, set z-index, preview at desktop / tablet / mobile. Layout stored as { x, y, w, h, z } in the block record.

STACK

Modern defaults.
No black boxes.

Osprey is built on open standards and battle-tested infrastructure. You own your data. You own your deployment.

Node runtime App Router, Server Components, API routes

PostgreSQL Primary datastore, multi-tenant schemas

Prisma 6 ORM, migrations, typed queries

Zod Runtime validation, schema-derived types

S3-compatible Media storage — any S3 endpoint

Auris IAM Optional SSO, OAuth2, PKCE, OIDC

Turborepo Monorepo build pipeline, caching

Vitest Unit and integration tests, 72 CLI specs

GET STARTED

Free. Open source.
Self-hosted.

Run Osprey on your own server, or ask us about a managed EU-hosted instance. No vendor lock-in. Ever.

Start free → Talk to us

LICENSE Open Source

DEPLOYMENT Self-hosted or EU-managed

COST Free

DATA EU jurisdiction

Content infrastructure for developers.

Real captures.Not mockups.

Everything a CMSshould be.

Code-first collections

Visual page builder

Multi-tenant by design

Plugin ecosystem

7 starter templates

CLI + web wizard

From schema to APIin minutes.

Nine packages.One coherent system.

Extend inone line.

Ship inminutes.

Visual editingthat doesn't fight you.

Modern defaults.No black boxes.

Free. Open source.Self-hosted.