Local development

Prerequisites

• Node.js 22 (nvm use in repo root)
• pnpm 10+
• Docker (for helpdesk and optional Directus)
• Fly CLI and Wrangler (for deploys only)

Install

git clone <repo-url>
cd SoulTalesIreland
pnpm install

Run apps

pnpm dev:frontend
pnpm dev:dashboard
pnpm dev:docs

Use different ports when running multiple Astro apps:

pnpm --filter soultales-docs dev -- --port 4322

Environment files

Each package may need its own .env. Check package READMEs and .env.example files. At minimum:

• frontend: Directus URL/token, auth secrets
• dashboard: Clerk, Stripe, Directus
• backend: database and storage (or use Docker Compose)

Directus scripts

Partner setup scripts are in dashboard/scripts/. Run against a staging Directus instance first.