coming-from
EmDash for Astro Developers
Add database-backed, editor-managed content to a server-rendered Astro site.
Official Docs
Official EmDash documentation imported into this 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, and the Atmosphere.
guides
Backups and recovery
Export selected site data, create restorable database and media backups, and recover D1 or SQLite deployments.
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
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
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 and 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
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
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
Why EmDash
Evaluate EmDash's editing model, architecture, operating requirements, and trade-offs.