test-e2e

A SpecVerse project — define your domain, generate your application.

Quick Start

# 1. Edit your specification
#    Open specs/main.specly and define your models

# 2. Generate code
npm run setup

# 3. Start development (two terminals)
npm run dev:backend       # Terminal 1: API server on http://localhost:3000
npm run dev:frontend      # Terminal 2: React app on http://localhost:5173

Project Structure

test-e2e/
├── specs/
│   └── main.specly              # Your specification (edit this)
├── manifests/
│   └── implementation.yaml      # Technology stack config
├── generated/
│   └── code/                    # Generated application (don't edit)
├── docs/                        # Documentation and diagrams
├── CLAUDE.md                    # AI development guide
└── package.json

Commands

| Command | Description | |---------|-------------| | npm run validate | Validate your specification | | npm run build | Validate + generate code | | npm run setup | Build + install deps in generated code | | npm run dev:backend | Start backend dev server | | npm run dev:frontend | Start frontend dev server | | npm run start | Start production server | | npm run gen:docs | Generate documentation | | npm run gen:diagrams | Generate Mermaid diagrams | | npm run clean | Remove generated output |

Workflow

1. Edit specs/main.specly — define models, relationships, behaviors, views
2. Validate with npm run validate
3. Generate with npm run build (or npm run setup on first run)
4. Run with npm run dev
5. Iterate — edit the spec, regenerate, test

Customizing the Spec

The template includes a simple starter model. Replace it with your domain:

components:
  Test-e2e:
    version: "1.0.0"
    description: "Your application"

    models:
      User:
        attributes:
          id: UUID required auto=uuid4
          name: String required
          email: Email required unique
          createdAt: DateTime auto=now

      Post:
        attributes:
          id: UUID required auto=uuid4
          title: String required
          content: String
          createdAt: DateTime auto=now
        relationships:
          author: belongsTo User

Technology Stack

Configured in manifests/implementation.yaml:

• Backend: Fastify + TypeScript
• Database: PostgreSQL + Prisma ORM
• Frontend: React + Vite

Prerequisites

Install the SpecVerse CLI:

npm install -g @specverse/self

Learn More

• SpecVerse User Guide
• SpecVerse Golden Rules