# Astro + EmDash Local Workshop

> A local-first portfolio starter for learning EmDash on Node.js and SQLite, with no cloud account or domain needed.

Source: https://emdashcmseverything.com/templates/astro-emdash-local-workshop/

- Format: Community theme
- Status: available
- Version: 0.0.3
- Price: Free
- Stack: Astro 7 + EmDash CMS + Node.js + SQLite
- License: MIT
- Repository: https://github.com/pwlee-xyz/astro-emdash-local-workshop
- Published: 2026-11-07

## Overview

This teaching starter runs an editable portfolio site on one computer with Node.js, SQLite, and local file storage. It is based on the official portfolio template, adjusted to have no cloud dependencies so it suits classrooms.

## Included

- Create and manage works in /_emdash/admin, upload images, save drafts, and publish them to a regular Astro page.
- pnpm run init:local creates a local .env with its own encryption key, and a documented reset command clears practice data.
- A follow-up chapter maps the local pieces to Cloudflare Workers, D1, and R2 for later deployment. The guide is written in Traditional Chinese.

## Create a project

```sh
git clone https://github.com/pwlee-xyz/astro-emdash-local-workshop.git
cd astro-emdash-local-workshop
pnpm install
pnpm run init:local
pnpm dev
```

## Compatibility and source

Documented stack: Astro 7 + EmDash CMS + Node.js + SQLite. License: MIT. Verified against upstream sources on 2026-11-11. Review before adopting: [repository](https://github.com/pwlee-xyz/astro-emdash-local-workshop).
