Quickstart

This guide walks you through seeding sample data and exploring the Marketlum UI.

Seed Sample Data

After installation, populate the database with realistic sample data:

pnpm seed:sample

This creates interconnected data across all entity types: agents, value streams, values, exchanges, offerings, invoices, and more.

To start fresh, use the --reset flag to truncate all tables before seeding:

pnpm seed:sample -- --reset

Start the development servers:

pnpm dev

Navigate to http://localhost:3000/login and log in with admin@marketlum.com / password123.

Page	What you'll find
Value Streams	Hierarchical view of value flows, with circle packing visualization
Agents	Market participants (organizations, individuals, virtual actors)
Values	Products, services, rights, and relationships with parent-child hierarchies
Exchanges	Transactions between agents with flow graphs
Offerings	Bundled values with pricing components
Invoices	Financial documents between agents
Agreements	Governance documents with templates

The API exposes a Swagger UI at http://localhost:3001/api/docs where you can explore and test all endpoints interactively.