Getting Started
external-readySet up local development and run backend + consoles.
Prerequisites
- Node.js 24+
- Bun 1.3+
- Docker
Setup
git clone <repo-url>
cd athas-boilerplate
bun install
cp apps/backend/.env.example apps/backend/.env
cp apps/admin-console/.env.example apps/admin-console/.env
cp apps/client-console/.env.example apps/client-console/.env
docker compose up -d
docker compose -f infra/docker/docker-compose.services.yml up -dRun apps
bun x nx serve backend
bun x nx serve admin-console
bun x nx serve client-consoleVerify
- Backend health:
http://localhost:3000/health - Admin console:
http://localhost:4200 - Client console:
http://localhost:4201
For full troubleshooting and optional services (MailPit/MinIO), see docs/guides/getting-started.md.