Node.js / TypeScript Event-Sourced Service

An event-sourced backend scaffolded by @eventmodelers/cli. It uses Emmett over Postgres for the event store, Express for the HTTP layer, and Flyway for schema migrations.

Features are built as vertical slices under src/slices/, generated from the slices on your Eventmodelers board by the agent in .build-kit/.

Prerequisites

• Node.js 20 or later (the dev/start scripts use node --env-file)
• Docker and Docker Compose (for local Postgres)
• Flyway CLI on your PATH (for npm run flyway:migrate)
• Claude Code if you want to run the build agent

Getting started

1. Start Postgres:

   docker compose up -d
   

2. Create your .env:

   cp .env.example .env
   

   Or run ./setup-env.sh to be prompted for host, port, database, user and password.

3. Activate the baseline migration and apply it:

   mv migrations/V1__schema.sql.example migrations/V1__schema.sql
   npm install
   npm run flyway:migrate
   

   V1__schema.sql creates the processor dead-letter queue table the runtime expects. Add your own V2__*.sql, V3__*.sql and so on as slices introduce projections.

4. Run the server:

   npm run build   # slice routes and processors are loaded from dist/
   npm run dev
   

The API is on http://localhost:3000, with Swagger UI at http://localhost:3000/api-docs and the raw OpenAPI document at http://localhost:3000/swagger.json.

Scripts

Learn more

• Eventmodelers
• Emmett documentation

License

Licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) — see LICENSE.