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: actors, 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
Actors	Market participants (organizations, individuals, virtual and AI agents), with hierarchy and financials
Values	Products, services, rights, and relationships with parent-child hierarchies
Exchanges	Transactions between actors with flow graphs
Offerings	Bundled values with pricing components
Invoices	Financial documents between actors
Agreements	Governance documents with templates
Value Streams	Grouping of values and activity into flows, with circle packing visualization
Activity	Audit trail of human and AI agent actions

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