Demo Mode
Explore GridWork HQ with sample data before connecting your real integrations.
Demo Mode
Demo mode lets you explore every dashboard page with realistic sample data — no integrations required. It is designed for evaluating the product, taking screenshots, and running presentations.
Enabling Demo Mode
Set the environment variable in gridwork-hq/.env.local:
DEMO_MODE=trueWhen DEMO_MODE=true, API routes that depend on external services (Notion, Stripe, GitHub) return mock responses instead of making real API calls. This lets the entire dashboard render without any configured integrations.
What Changes in Demo Mode
| Area | Normal Behavior | Demo Mode Behavior |
|---|---|---|
| Client Tracker | Fetches from Notion API | Returns 3 mock clients |
| Finance Panel | Fetches from Stripe | Returns mock revenue and invoice data |
| Pipeline Kanban | Shows real job history | Shows 5 sample pipeline jobs |
| Cron Dashboard | Shows real cron status | Shows 8 sample cron entries |
| Activity Feed | Shows real events | Shows 10 sample activity items |
| Metric Cards | Live data from integrations | Static mock values |
Seeding Demo Data
You do not need to set DEMO_MODE=true to use seeded data. From the dashboard:
- Log in and navigate to Mission Control
- The WelcomeBanner appears on first run
- Click Load Demo Data
- The seed function populates the SQLite database with sample records
Seeded records include:
- 3 demo clients
- 5 pipeline jobs
- 8 cron entries
- 10 activity items
All seeded records are marked with is_demo: true in the database.
Clearing Demo Data
To remove all seeded data:
- Click Clear Demo Data in the WelcomeBanner
- The
clearDemoDatafunction removes every record whereis_demo = true - Your real data (if any) is untouched
This is a safe operation — only records explicitly flagged as demo data are deleted.
Use Cases
- Evaluating before purchase — see what every page looks like with data
- Screenshots and marketing — capture polished dashboard views
- Presentations — demo the product to your team without exposing real client data
- Development — work on UI changes without needing live integrations
Combining with Real Data
You can load demo data alongside real integrations. Demo records appear in the same views as your real data. When you are done, click Clear Demo Data to remove only the sample records.