Local development
/ Run the dashboard locally for widget, SDK, Desk Center, and org work. Docs are at docs.humaner.io — not part of the OSS dev server.
Prerequisites
- Node.js ≥ 20, pnpm 9
- Postgres (local or Supabase) for dashboard
- Env vars in apps/dashboard/.env.local
- Your support agent HTTP endpoint
Quick start
Terminal
git clone https://github.com/humaner/humaner.git
cd humaner
pnpm install
pnpm dev:dashboard # local dashboard on port 3001Documentation: https://docs.humaner.io/oss. Marketing site (humaner.io) is not required for integration or Desk Center development.
What you can change
| Area | Path |
|---|---|
| Widget | apps/dashboard/public/widget.js |
| React SDK | packages/react |
| API routes | apps/dashboard/app/api/v1/ |
| Handoff framework + Desk | apps/dashboard/app/dashboard/desk/ |
| Organization | apps/dashboard — org and members |
| Dashboard UI | apps/dashboard |
BYO agent locally
Point agent chat config at your runtime, then test handoff into Human Desk. See Desk Center → Connect your agent.