Demo Control Center
Health Soup Demo Guide
Use this page as your quick-start guide for running the Health Soup demo.
Start with search, show transparent care options, then switch experiences to show
provider operations, employer visibility, finance, broker, and admin views.
Start here
- Open Preview Search.
- Search for a service like Annual Visit, Sick Visit, or Primary Care.
- Click a result to show pricing, distance, includes/excludes, and scheduling context.
- Log in as a provider to show request handling and care confirmation.
- Switch to employer/admin/finance views to show visibility, governance, and platform operations.
#users Seeded Users & Roles
All demo users use password: demo123. Sign in with username/email + password only.
If a user has multiple experiences, they will be prompted to choose one after sign-in and can later use
the in-app Switch experience control in the top-right app shell.
| Role | Username | Email | Password |
| Admin | admin.one | admin.one@healthsoup.local | demo123 |
| Admin | admin.two | admin.two@healthsoup.local | demo123 |
| Finance Manager | finance.one | finance.one@healthsoup.local | demo123 |
| Broker | broker.one | broker.one@healthsoup.local | demo123 |
| Employee + Broker | broker.employee | broker.employee@healthsoup.local | demo123 |
| Employer | employer.one | employer.one@badgerprecisionwi.com | demo123 |
| Employer | employer.two | employer.2@healthsoup.local | demo123 |
| Provider | provider.schen | provider.schen@care.local | demo123 |
| Provider | provider.mwebb | provider.mwebb@care.local | demo123 |
| Provider | provider.3 | provider.3@care.local | demo123 |
| Employee | employee.alex | alex.rivera@badgerprecisionwi.com | demo123 |
| Employee | employee.jordan | jordan.kim@badgerprecisionwi.com | demo123 |
| Employee | employee.3 | taylor.brooks@badgerprecisionwi.com | demo123 |
#flows Walkthrough Flows
1. Employee / Member Experience
- Start at /preview/search.
- Search for care and compare price, distance, availability, and includes/excludes.
- Click a result to show details without losing search context.
- Use the schedule/request action to show the next step.
Talking point: “This is the front door — clear options before the system gets complicated.”
2. Provider Flow
- Log in as provider.schen or another provider.
- Show blocks/services, profile, locations, availability, and appointment queue.
- Show how providers confirm care delivery instead of chasing claim complexity.
Talking point: “Providers define care, manage requests, and get paid for delivery — not paperwork.”
3. Employer Visibility
- Log in as employer.one.
- Show eligibility, employer profile, plan documents, banking, and reporting visibility.
- Explain how employers can support access without gatekeeping care decisions.
Talking point: “Employers get clearer access pathways and better visibility into adoption.”
4. Finance / Broker / Admin
- Use finance.one to show fee control and point allocation concepts.
- Use broker.one to show linked employers and commission context.
- Use admin.one to show platform governance and operational controls.
Talking point: “The demo is more than a directory — it models a multi-sided operating system.”
#instructions Run Instructions
- Start app:
npm run dev
- Reset data:
npm run reset
- Run migrations:
npm run migrate
- Seed data:
npm run seed
- Default password:
demo123
If the app looks stale after a code change, restart the dev server and hard-refresh the browser.
#notes Internal Notes
- This is a demo environment — no real PHI, claims, payments, or production account handling.
- Focus the story on simplicity, transparency, and reducing layers.
- Health Soup is the demo experience layer, not necessarily the final business name.
- The broader business model is the Multi-Stakeholder Cooperative connecting employers and providers.
- Known future issue: employer and provider points are currently demo-derived and may not balance perfectly.
#troubleshooting Troubleshooting
- Port already in use: stop the old Node process or run
npx kill-port 3000.
- Login fails: confirm username/email and password
demo123.
- Wrong role appears: use the top-right Switch experience control if the user has multiple roles.
- Missing demo data: run
npm run reset.
- Search results look wrong: confirm seed data loaded and refresh the browser.
How to tell the story
Start with the problem: healthcare is complex, delayed, and hard to understand.
Then show the shift: members can see, compare, choose, schedule, confirm, and pay through a simpler experience.
Bring it home with the core line:
Pick your care. Know your price.
The demo does not claim to replace clinical judgment. It shows how clearer services, visible pricing,
and aligned employer/provider participation could make access to care easier.