Frontend Route Map

Public Route

/

• Marketing and pricing presentation.
• Privy login entrypoint.
• Redirects authenticated users to /dashboard.

Auth Utility Route

/auth/device

• User enters CLI/MCP user_code.
• Calls POST /api/auth/device/approve with user bearer token.

Application Routes (Authenticated)

/dashboard

• Lists agents from GET /api/agents.
• Supports delete flow via DELETE /api/agents/:id.
• Links to create and detail pages.

/dashboard/create

• Creates agent via POST /api/agents.
• Immediately provisions via POST /api/agents/:id/provision.

/dashboard/agent/[id]

• Loads agent via GET /api/agents/:id.
• Machine controls: start/stop/provision/delete.
• Cloning via POST /api/agents/:id/clone.
• Runtime updates via status + grant endpoints.
• Gateway token fetch for embedded OpenClaw and shell tabs.
• Telegram and WhatsApp connection actions.

/settings

• User profile read/update.
• Subscription checkout and credit checkout.
• Billing usage and portal session flow.
• Runtime spend request approve/deny queue.
• Runtime spend policy create/update/revoke per controller agent.
• Runtime delegation list/create/revoke.
• Local API key management UI (localStorage-backed).

Supporting Behavior

• Agents and details use polling hooks for state freshness.
• Privy auth guard redirects unauthenticated users to home.
• API base URL is derived from NEXT_PUBLIC_API_URL with local fallback.