Get Started

Clone and build

Moment is distributed as a monorepo. Clone it and build all packages.

git clone https://github.com/mmmnt/mmmnt.git
cd mmmnt
pnpm install
pnpm turbo build

Write your first specification

Create a .moment file describing your domain. Here's a minimal example with one bounded context, an aggregate, a command, and an event.

context "Shop" [Core]

  aggregate "Product"
    identity productId: UUID

    command CreateProduct
      input name: string, price: Money
      precondition nameNotEmpty: "Name must not be empty"
      emits ProductCreated

    event ProductCreated
      productId: UUID
      name: string
      price: Money
      createdAt: DateTime

  value-object Money
    amount: number
    currency: string

  invariant SHOP-01 "Product name must not be empty"
    scope Product

Parse and generate

Run the Moment CLI to parse your specification, derive test topologies, and generate all artifacts.

# Parse the specification into IR
moment parse shop.moment

# Derive test topologies and scenarios
moment derive

# Generate all output artifacts
moment generate --all

# Or run everything in watch mode
moment watch shop.moment

Explore what was generated

Moment produces several artifact types from your specification:

• TypeScript interfaces — Discriminated union types, readonly fields, and aggregate classes ready for implementation
• Test scaffolds — Pre-populated .spec.ts files with types, setup steps, and assertion stubs
• Gherkin features — BDD scenarios covering every command, event, precondition, and invariant
• Spec documents — Markdown with Mermaid diagrams for living documentation
• AsyncAPI contracts — Event-driven API documentation

CLI command highlights

Moment ships with 20+ CLI commands. Here are the ones you'll use most.