equity-scenario-sim

GitHub: Stackbilt-dev/equity-scenario-sim · MIT

Part of the Stackbilt ecosystem. A sophisticated cap table simulator designed to model partnership negotiations and understand the financial impact of bringing on new partners. Adjust deal structures, vesting schedules, and performance milestones to see real-time effects on ownership percentages and exit payouts.

Quick Start

git clone https://github.com/Stackbilt-dev/equity-scenario-sim.git
cd equity-scenario-sim
yarn install     # or: npm install
yarn dev         # or: npm run dev

Open http://localhost:5173 in your browser.

Prerequisites: Node.js v18+, npm v9+. Yarn recommended on Windows.

Features

Core Modeling

Two Partnership Paths — compare Path A vs. Path B deal structures side by side
Flexible Investment Vehicles — model priced rounds or SAFEs with custom valuations
Milestone-Based Vesting — performance equity that unlocks based on real business milestones
Dynamic Cap Table — live ownership distribution visualization as you adjust parameters
Founder Flexibility — model multiple founders with custom equity splits

Analysis & Planning

Exit Waterfall — detailed exit scenario modeling (conservative / base / optimistic)
Milestone Timeline — interactive vesting schedule visualization
Pool Target Planning — set desired option pool percentage with actionable recommendations
Exit Payouts — exact dollar amounts per stakeholder at different valuations

Scenario Management

Save Scenarios — store deal structures with names and descriptions
Scenario History — access saved scenarios with timestamps
Persistent Storage — scenarios saved in browser localStorage

Safety Guardrails

Built-in warnings for common deal structure pitfalls:

Check	Threshold
Partner equity cap	Max 12% per partner
Employee option pool minimum	Min 8%
Founder concentration risk	Warn if single founder >70%
Founder equity disparity	Warn if disparity >3× between co-founders

Guardrail violations appear as visual health indicators — they warn, they don’t block.

Use Cases

Modeling equity splits before bringing on a new partner or co-founder
Comparing SAFE vs. priced round structures at different cap levels
Understanding dilution impact of a new option pool before the round
Running exit scenarios to align expectations before closing a deal

This is a planning and negotiation tool, not legal or financial advice.