How to Use the UI
How to Use the Uniph.ai Frontend
This guide explains how to use the web UI for Uniph.ai.
Prerequisites
- Backend API running (default:
http://localhost:3001). Start it from the repo:cd backend && npm run dev. - Frontend running (default:
http://localhost:3000). From this folder:npm run dev.
Ports
| App | Port | URL | |----------|------|------------------------| | Frontend | 3000 | http://localhost:3000 | | Backend | 3001 | http://localhost:3001 |
Open the frontend URL in your browser to use the UI. The backend is for the API only.
Routes
| Route | What you can do | |--------------------|------------------| | / | Landing page: product overview and entry to app/docs | | /dashboard | Primary experience: set intent, get outcomes, monitor high-level progress | | /goals/[id] | Goal detail: status, tasks, and concise progress | | /mission-control| Risk, approvals, reliability snapshots, and KPI gates | | /settings/ | Optional tuning (channels, agent identities, memory) |
Step-by-step
1. Open the app
Go to http://localhost:3000. You’ll see the landing page.
2. Start from intent
Go to /dashboard. If you are a new user, ambient onboarding starts automatically and prepares your first outcome.
3. Confirm only what matters
In dashboard and goal views, focus on:
- Objective intent
- Task progress
- Risk/approval prompts (only when blocked or sensitive)
The execution context runs behind the scenes.
4. Use Mission Control when needed
Open /mission-control for:
- Approval inbox
- Reliability and friction KPIs
- High-level execution summaries
5. Optional setup
Use /settings/channels, /settings/agents, and /settings/memory only for optional tuning and advanced control.
Environment
To point the frontend at a different API (e.g. staging), create frontend/.env.local:
NEXT_PUBLIC_API_URL=http://your-api-host:3001
Restart the dev server after changing env.
More docs
- Project README — Overview and architecture
- Quickstart — API examples (curl, Node, Python)
- API Reference — REST endpoints
- Reference Agents — Research, Reviewer, Summary, etc.
For frontend dev (scripts, structure), see the frontend README in the repo.