em—dash

Installation Guide

Two ways to install plugins from the community marketplace.

Download & Manual Install

  1. 1 Find a plugin on the marketplace and click "Download".
  2. 2
    Extract the .tgz archive to your EmDash plugins directory:
    tar -xzf plugin-name-1.0.0.tgz -C ./plugins/
  3. 3 Restart your EmDash instance.

Only published versions that pass our AI security audit are available for download.

Use as Your Plugin Registry

Point your EmDash CMS instance at this marketplace, then browse and install plugins from the admin dashboard at Plugins › Marketplace.

Add the marketplace URL to your Astro config and enable the sandbox runner so installed plugins can run in isolated workers: 

// astro.config.mjs
import { emdash } from "emdash/astro";

export default defineConfig({
  integrations: [
    emdash({
      marketplace: "https://emdashcms.org",
      sandboxRunner: true,
    }),
  ],
});

Then, signed in as an admin:

  1. Open the EmDash admin panel and go to Plugins › Marketplace
  2. Browse or search for a plugin and open its detail page
  3. Review the capability consent dialog and click Install

The plugin bundle is downloaded from this marketplace, copied into your site’s own R2 bucket, and loaded into the sandbox runner. The marketplace is a distribution channel only — once installed, your site never depends on us at runtime.

The marketplace browser, install flow, and sandbox runner are all part of EmDash CMS itself. Check the EmDash installing-plugins docs for full setup details and the capability consent model.

For Plugin Authors

  1. 1 Sign in with GitHub to access your publisher dashboard.
  2. 2 Register your plugin with a unique ID.
  3. 3 Upload a version — either a manual .tgz upload or connect a GitHub repository for automatic releases.
  4. 4
    Every version is run through an AI security audit:
    • Passed versions are published automatically.
    • Flagged versions are published with warnings.
    • Failed versions are rejected.
Get Started

API Reference

The marketplace API is available at https://emdashcms.org/api/v1

GET
/plugins

Search and browse plugins

GET
/plugins/{id}

Plugin details

GET
/plugins/{id}/versions/{version}/bundle

Download bundle

POST
/plugins/{id}/installs

Track installations

The API is compatible with the EmDash CMS MarketplaceClient interface.