# Storypane

> Storypane is an MIT-licensed, open-source headless CMS and Storyblok alternative. It combines block-level collaborative editing, live preview, nested content, and schema migrations with source ownership and bring-your-own Postgres.

Teams can edit separate blocks in the same story, with editing locks, presence, and autosave. Content, block definitions, and assets have dedicated libraries. Operators choose their database provider and location, and control database access, network policies, backups, and retention. Infrastructure costs and technical limits still apply.

The recommended team setup is one production space for content editors with schema read-only enabled, plus a linked development space per developer. Developers sync, change schemas, deploy and test in dev, then review and promote deployed migrations to production. Other dev spaces explicitly sync after a promotion. Both block-library parents and nested-block rules travel with migrations. Cloning excludes bulk content/media but reviews required schema-default dependencies; copied stories stay unpublished. Credentials and integrations are configured separately per space. Frontends use the delivery credentials and deployed types of their target space.

The management API, SDK, CLI, and stdio MCP adapter support automation with scoped credentials and the CMS authorization rules. Customizations belong directly in application code; the downloadable skills guide agents through existing services and tests. Example integration prompts on the website are illustrative requests, not prebuilt integrations.

The CMS runs on Node/Docker. Cloudflare hosts this static marketing website only; the CMS does not run on Workers. Railway implementation is documented, but a fresh installation and hosted template remain unverified and gated. The homepage collaboration screenshot uses labelled demo collaborators.

## Start here

- [Product overview](https://storypane.dev/): Collaboration, source ownership, developer workflow, and bring-your-own database.
- [Documentation index](https://storypane.dev/docs/): Getting started, self-hosting, API, SDK, webhook, and example-site guides.
- [Production and development spaces](https://storypane.dev/docs/development-workflow/): Recommended team setup, environment switching, cloning, reviewed promotion, explicit sync, and CLI credentials.
- [Editor quickstart](https://storypane.dev/docs/editor/): Create a space, define blocks and fields, add stories and media, publish, and connect live preview.
- [Install Storypane](https://storypane.dev/docs/getting-started/): Generate local credentials and follow the Docker, source, or agent-assisted setup workflow.
- [Source repository](https://github.com/lkuich/storypane): CMS source and canonical Markdown documentation.
- [For agents](https://storypane.dev/docs/agents/): Download and installation instructions for customization and deployment skills.

## Product and automation

- [Customization skill](https://storypane.dev/skills/storypane-customize/SKILL.md): Entry point for small, direct changes to a Storypane checkout.
- [Management API, CLI, and MCP](https://storypane.dev/docs/management-api/): Automation, scoped tokens, and management operations.
- [SDK and schema migrations](https://storypane.dev/docs/sdk/): Versioned schemas, conflict handling, generated types, and CI deployment.
- [Webhooks](https://storypane.dev/docs/webhooks/): Signed, retried delivery from the transactional outbox.

## Hosting

- [Node installation guide](https://storypane.dev/docs/self-hosting/): Local and production setup, backups, upgrades, and recovery.
- [Cloudflare Workers Static Assets](https://storypane.dev/docs/cloudflare/): Static website hosting and legacy CMS resource cautions.
- [Railway status](https://storypane.dev/docs/railway/): Independent runtime implementation and current limitations.
- [Deployment verification](https://storypane.dev/docs/verification/): Fresh-install acceptance checklist and dated historical results.

## Website source

- [Website GitHub repository](https://github.com/lkuich/storypane-www): Astro source for this site.
- [Cloudflare Workers Static Assets website setup](https://storypane.dev/deploy/cloudflare/): Build settings for the static marketing site.
- [MIT license](https://storypane.dev/LICENSE.txt): Website license; the CMS repository also carries an MIT license.
- [Third-party notices](https://storypane.dev/THIRD_PARTY_NOTICES.md): Font, shader, and icon license information.