pnpm create emdash@latest potluck --pm pnpm --install --yes, per https://docs.emdashcms.com/ ("Create your first EmDash site"); the --yes defaults are cloudflare + blog. Replaces the old madmode/ starter (never committed). Generated-by: create-emdash 1.2.0, run by Claude Opus 5.5
69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
# EmDash Blog Template (Cloudflare)
|
|
|
|
A clean, minimal blog built with [EmDash](https://github.com/emdash-cms/emdash) and deployed on Cloudflare Workers with D1 and R2.
|
|
|
|
[](https://deploy.workers.cloudflare.com/?url=https://github.com/emdash-cms/templates/tree/main/blog-cloudflare)
|
|
|
|

|
|
|
|
## What's Included
|
|
|
|
- Featured post hero on the homepage
|
|
- Post archive with reading time estimates
|
|
- Category and tag archives
|
|
- Full-text search
|
|
- RSS feed
|
|
- SEO metadata and JSON-LD
|
|
- Dark/light mode
|
|
|
|
## Pages
|
|
|
|
| Page | Route |
|
|
|---|---|
|
|
| Homepage | `/` |
|
|
| All posts | `/posts` |
|
|
| Single post | `/posts/:slug` |
|
|
| Category archive | `/category/:slug` |
|
|
| Tag archive | `/tag/:slug` |
|
|
| Search | `/search` |
|
|
| Static pages | `/pages/:slug` |
|
|
| 404 | fallback |
|
|
|
|
## Screenshots
|
|
|
|
| | Desktop | Mobile |
|
|
|---|---|---|
|
|
| Light |  |  |
|
|
| Dark |  |  |
|
|
|
|
## Infrastructure
|
|
|
|
- **Runtime:** Cloudflare Workers
|
|
- **Database:** D1
|
|
- **Storage:** R2
|
|
- **Framework:** Astro with `@astrojs/cloudflare`
|
|
|
|
## Local Development
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm dev
|
|
```
|
|
|
|
Open http://localhost:4321/_emdash/admin and complete the setup wizard. EmDash runs database migrations and applies the blog seed during setup. The site is available at http://localhost:4321.
|
|
|
|
## Deploying
|
|
|
|
```bash
|
|
pnpm wrangler login
|
|
pnpm deploy
|
|
```
|
|
|
|
The first deployment provisions the named D1 database and R2 bucket from `wrangler.jsonc`. See [Deploy to Cloudflare](https://docs.emdashcms.com/deployment/cloudflare/) for production setup, or use the deploy button above.
|
|
|
|
## See Also
|
|
|
|
- [Node.js variant](../blog) -- same template using SQLite and local file storage
|
|
- [All templates](../)
|
|
- [EmDash documentation](https://docs.emdashcms.com/)
|