overview
Agent Skills
Install EmDash agent skills so AI coding assistants use current EmDash APIs when they build sites, write plugins, and port WordPress projects.
Official Docs
Official EmDash documentation imported into this site.
coming-from
EmDash for Astro Developers
Add database-backed, editor-managed content to a server-rendered Astro site.
coming-from
Astro for WordPress Developers
Learn the Astro concepts used by EmDash sites through familiar WordPress patterns.
coming-from
EmDash for WordPress Developers
Map WordPress content, templates, and extensions to an EmDash Astro site.
concepts
Architecture
How an Astro site, EmDash, the admin panel, and the data stores work together.
concepts
Collections and fields
Choose collection behavior and field types, and understand how later changes affect content.
concepts
Content model
How collections, fields, entries, generated types, and seed files describe site content.
contributing
Architecture (internals)
How EmDash works under the hood, for people contributing to EmDash itself.
contributing
Documentation Style Guide
The writing, structure, and code-sample conventions for EmDash documentation.
deployment
Manage core database migrations
Run EmDash's internal schema migrations as a serialized deployment step.
deployment
Choose a database
Choose and configure SQLite, D1, Hyperdrive, PostgreSQL, or libSQL for EmDash.
deployment
Deploy to Node.js
Deploy EmDash to a long-running Node.js server with persistent data services.
deployment
Configure the object cache
Cache query results in Cloudflare KV or memory to serve reads without querying the database on every request.
deployment
Configure the plugin sandbox
Run sandboxed plugins on Cloudflare Workers or Node.js, with the bindings, resource limits, and failure modes of each sandbox runner.
deployment
Evolve a deployed site's schema
Change the schema and content model of a live EmDash site, and keep your seed file in sync.
deployment
Manage secrets and keys
Where every EmDash secret lives, how to provide it, and what happens when you rotate or lose it.
deployment
Choose media storage
Choose and configure R2, S3-compatible, or local media storage for EmDash.
deployment
Update EmDash
Move an existing site to a new EmDash release, from reading the release entries to verifying the deployed site.
overview
EmDash Docs MCP
Connect your AI coding assistant to the EmDash documentation so it can answer questions and find the right pattern from real docs.
overview
Add EmDash to an existing Astro project
Configure a Node.js Astro site to edit and query EmDash content locally.
overview
Create your first EmDash site
Scaffold a local EmDash site, complete setup, and publish an edit.
guides
Atmosphere Login
Sign in to EmDash with an Atmosphere account — the open-network identity behind Bluesky and the wider AT Protocol ecosystem.
guides
Authentication
Passkey-first authentication with pluggable providers for GitHub, Google, Microsoft, and the Atmosphere.
guides
Backups and recovery
Create and verify restorable database, media, and key backups for every supported EmDash database.
guides
Build pages with blocks
Define versioned block types, add a blocks field, and render the stored composition with Astro components.
guides
Move to a New Domain
Switch a site's public address with the Change domain dialog, and keep signing in after the move.
guides
Dark Mode
Follow the visitor's color scheme, let editors pick a dark counterpart for an image, and render the right one with the Image component.
guides
Email Setup
Configure email delivery for magic links, invites, and account recovery — in development and production.
guides
Internationalization (i18n)
Translate content into multiple languages with per-locale publishing, slugs, and automatic fallback.
guides
Navigation Menus
Create menus in the admin and render locale-aware navigation in an Astro layout.
guides
Page Layouts
Let editors choose different layouts for individual pages using a template field.
guides
Querying Content
Query, order, paginate, and render EmDash content in server-rendered Astro pages.
guides
Relations
Link entries across content types with relations and reference fields, pick entries in the editor, and read the links in a template.
guides
Built-in SEO Features
The search engine optimization (SEO) features EmDash provides, what each one outputs, and how to enable them.
guides
Site transfer
Export a complete EmDash site as a site package, import it into a new empty site, and verify the result with an import receipt.
guides
Working with Content
Create, edit, publish, schedule, and safely delete content in the EmDash admin.
migration
Content import
Understand the WordPress import sources, conversion behavior, API shapes, and retry boundaries.
migration
Port WordPress Plugins
Choose an EmDash plugin format and map WordPress hooks, storage, routes, and admin UI.
plugins
Distributing native plugins
Build, inspect, publish, and install a native plugin package from npm.
plugins
Portable Text rendering components
Define a plugin block in the editor and provide its Astro renderer on the public site.
plugins
React admin extensions
Add generated settings, React pages, dashboard widgets, field widgets, editor panels, and content-list columns to a native plugin.
plugins
API Routes
Expose REST endpoints from your sandboxed plugin for the admin UI and external integrations.
plugins
Capabilities and security
Declare what your plugin needs, and understand what the sandbox enforces.
plugins
Choosing a plugin format
Pick between sandboxed and native plugins before you start writing code.
plugins
The `emdash-plugin` CLI
Scaffold, build, validate, publish, and maintain a sandboxed plugin.
plugins
Automated plugin releases
Publish sandboxed plugins from GitHub Actions through the EmDash release service.
plugins
The plugin manifest
Reference for emdash-plugin.jsonc identity, access, storage, admin UI, and registry fields.
plugins
Migrating to the plugin CLI
Breaking changes for sandboxed-plugin authors, and how to update your plugin.
plugins
Bundling and publishing
Bundle a sandboxed plugin and publish it to the EmDash plugin registry.
plugins
Test sandboxed plugins
Run plugin hooks and routes through EmDash's production sandbox boundary in Vitest.
plugins
Your first sandboxed plugin
Scaffold, register, and run a sandboxed plugin that responds to content saves.
plugins
Installing plugins
Install sandboxed plugins from the EmDash registry or register plugins from npm.
plugins
Migrate from Marketplace
Move an existing EmDash site from Marketplace discovery to the plugin registry.
plugins
The plugin registry
Discover, review, and install sandboxed plugins from the EmDash registry.
plugins
Querying the registry
Build a plugin directory, search page, or release feed against the registry's public discovery API with @emdash-cms/registry-client.
plugins
Upgrading plugins on your site
Breaking changes for sites that install EmDash plugins, and how to adapt your project.
reference
Content Lifecycle
State transitions, revisions, permissions, conflicts, and hooks for EmDash content.
reference
MCP Server Reference
Authentication, protocol behavior, and the complete tool inventory for the MCP server.
reference
REST API Reference
The public HTTP contract, authentication rules, and complete OpenAPI operation inventory.
themes
Create a Theme
Build a reusable EmDash Astro template with server-rendered routes and an initial seed.
themes
Port a WordPress Theme
Convert a WordPress theme into a server-rendered EmDash Astro template.
overview
Upgrade to EmDash 1.0
Breaking changes between EmDash 0.x and 1.0, and how to update your site.
overview
Why EmDash
Evaluate EmDash's editing model, architecture, operating requirements, and trade-offs.