Overview
Documentation for the National Commerce web app.
Welcome to the documentation for the National Commerce platform. The web app connects to ShipHero and helps your team manage inventory, purchase orders, shipments, and forecasts.
This site explains what each screen does, how the code fits together, and how data moves through the system.
Who this is for
These docs serve three readers:
- Business analysts and clients — read the feature guides to learn what each screen does.
- Developers — read Getting Started and Architecture to run and extend the app.
- Everyone — use the Glossary to learn the domain terms.
Start here
Feature guides
What each screen does — dashboard, inventory, purchase orders, forecast, shipments, and settings.
Getting Started
Run the web app locally and learn the daily commands.
Architecture
The stack, the monorepo layout, and the patterns the team follows.
Glossary
Definitions for brands, accounts, SKUs, orders, shipments, labels, and purchase orders.
Data Flows
How data moves between ShipHero, the Cloudflare worker, N8N, and Supabase.
Keep these docs current
Living documentation
Update the MDX files under apps/docs/content/docs as the system changes.
Treat these pages as a living reference, not a snapshot.