Get started with EmForge

Everything you need to install, configure, and customize EmForge themes and plugins.

⚡ Quick Start

Get a new EmDash site running with the Forge theme in under 5 minutes.

# 1. Create a new EmDash site
npm create emdash@latest my-site
# 2. Install the Forge theme
cd my-site
pnpm add @emforge/forge-theme
# 3. Start the dev server
pnpm dev
# Open http://localhost:4321

🎨 Forge Theme

Collections

Forge includes three content collections: Posts (blog articles with categories/tags), Pages (static pages with marketing blocks), and Projects (portfolio items with client/year metadata).

Marketing Blocks

8 block types for landing pages: Hero, Features, Pricing, Testimonials, FAQ, CTA, Stats, and Logo Cloud. Add them to any page via the EmDash editor.

Theming

Customize via CSS custom properties in src/styles/theme.css. Full spacing scale (1-32), type scale (xs-6xl), light/dark modes, and gradient definitions. No Tailwind required.

Dark Mode

Built-in dark mode with prefers-color-scheme detection, cookie persistence, and FOUC prevention. Toggle with the .dark class.

Visual Editing

All content elements support EmDash's click-to-edit for logged-in admins. Titles, featured images, and body content are editable inline on the live site.

🔍 SEO Plugin

Installation

pnpm add @emforge/plugin-seo

Then add to your astro.config.mjs:

import { seoPlugin } from "@emforge/plugin-seo";
plugins: [seoPlugin()]

Features (Free Tier)

  • ✅ XML Sitemap generation at /sitemap.xml
  • ✅ Enhanced meta tags + Open Graph + Twitter Cards
  • ✅ JSON-LD structured data (BreadcrumbList, Organization, WebSite)
  • ✅ Auto 301 redirects on slug changes
  • ✅ 404 monitoring dashboard
  • ✅ SEO admin widget with content scores

Features (Pro Tier — $49/year)

  • 🌟 Readability scoring (Flesch-Kincaid)
  • 🌟 Keyword density analysis
  • 🌟 Advanced structured data (FAQ, HowTo, Product)
  • 🌟 Social media preview cards
  • 🌟 Internal linking suggestions
  • 🌟 Full SEO audit reports

🚀 Deployment

EmDash sites deploy to Cloudflare Workers with D1 (database) and R2 (media storage).

# Create database + media bucket
wrangler d1 create my-site-db
wrangler r2 bucket create my-site-media
# Update wrangler.jsonc with IDs, then deploy
wrangler deploy

Hosting cost: ~$5/month on Cloudflare's Workers Paid plan. Includes edge CDN, automatic SSL, and global distribution across 300+ data centers.

Need Help?

We're here to help you build on EmDash.

Email Support EmDash GitHub →