Apps — Index
Leadmetrics v3 ships seven apps. Each folder below contains the full spec for that app: screens, navigation flows, and any app-specific technical docs.
| App | Folder | Audience | Tech | Status |
|---|---|---|---|---|
| Dashboard | apps/dashboard | Tenant admins & members | Next.js | Partial [Live] |
| DM Portal | apps/dm-portal | Internal DM reviewers | Next.js | Partial [Live] |
| Manage | apps/manage | Super admins | Next.js | Partial [Live] |
| Auth | @leadmetrics/middleware (shared) | All users | Fastify JWT (HS256) | Core [Live] |
| Knowledge Base | apps/knowledgebase | Internal Leadmetrics team | Nextra v4 + Next.js | [Live] |
| Dashboard Mobile | apps/dashboard-mobile | Tenant users on mobile | React Native + Expo | [Live] |
| DM Mobile | apps/dm-mobile | DM reviewers on mobile | React Native + Expo | [Live] |
CLI (lm) | apps/cli | Internal Leadmetrics / DM team | Node.js + Ink | [To Build] |
Knowledge Base is not a standalone app. Dataset management (create, configure, embedding model, crawler schedule) lives in Manage. Tenants and DM reviewers upload/remove docs and use the sandbox from within Dashboard and DM Portal respectively. See Manage — Knowledge Base Screens.
Shared UI docs
Design decisions that apply across all apps live in docs/ui/:
| Doc | What it covers |
|---|---|
| UI Layer | App setup, auth, SSE, SendGrid integration |
| Design System | Colors, typography, spacing, component patterns |
| Responsive Design | Breakpoints, shell layout, nav patterns |
| Theming | Dark/light mode, CSS variables, no-flash strategy |
API surfaces
Each app has a matching API surface on the Fastify backend. See docs/api/ for the full API reference.
| App | API prefix | Doc |
|---|---|---|
| Dashboard | /dashboard/v1 | api/dashboard.md |
| DM Portal | /dm/v1 | api/dm.md |
| Manage | /admin/v1 | api/admin.md |
| Auth | /auth/v1 | api/auth.md |
| Mobile | /mobile/v1 | api/mobile.md |
| Agents (control plane) | /agent/v1 | api/agents.md |