Page Map
The frontend has 58+ pages organized across 26 page directories in apps/web/src/pages/. Each directory maps to a feature domain.
Page Directory Structure
apps/web/src/pages/
├── accounts/ # Social account management
├── admin/ # Super admin dashboard
├── ads/ # Ad campaigns & auto-boost
├── ai-brain/ # AI brain / chat interface
├── ai-tools/ # AI generation tools
├── analytics/ # Performance analytics
├── approvals/ # Approval workflows
├── audience/ # Audience CRM & segments
├── auth/ # Login, register, OAuth, OTP
├── checkout/ # Payment flow
├── client/ # Client portal (limited access)
├── commerce/ # Revenue dashboard & orders
├── competitors/ # Competitor tracking
├── composer/ # Multi-platform post composer
├── conversation-engine/ # ICE bot configuration
├── conversations/ # Unified inbox
├── dashboard/ # Main overview with KPIs
├── drafts/ # Draft posts
├── ecommerce/ # Store management
├── intelligence/ # Gap analysis & insights
├── landing/ # Public landing page
├── posts/ # Published posts list
├── predictions/ # AI predictions
├── pricing/ # Plan comparison
├── reports/ # Client report generation
└── scheduler/ # Schedule management
Complete Page Inventory
Authentication (/auth)
| Page | Route | Description | Access |
|---|---|---|---|
| Login | /login | Email/password + OAuth login | Public |
| Register | /register | Account creation + onboarding | Public |
| Forgot Password | /forgot-password | Password reset request | Public |
| Reset Password | /reset-password/:token | Password reset form | Public |
Core
| Page | Route | Description | Min Role |
|---|---|---|---|
| Dashboard | / | Main overview with key metrics, charts, recent activity | VIEWER |
| Landing | /landing | Public-facing landing page | Public |
Content & Publishing
| Page | Route | Description | Min Role |
|---|---|---|---|
| Composer | /composer | Multi-platform post creation with preview | EDITOR |
| Composer (Edit) | /composer/:id | Edit an existing post | EDITOR |
| Posts | /posts | Published posts list with filters | VIEWER |
| Drafts | /drafts | Draft posts awaiting publication | VIEWER |
| Scheduler | /scheduler | Scheduled posts with calendar view | VIEWER |
AI Tools
| Page | Route | Description | Min Role |
|---|---|---|---|
| AI Tools | /ai-tools | Caption generation, rewriting, hashtags, CTA, translation, image generation | EDITOR |
| AI Brain | /ai-brain | AI chat interface for content brainstorming | EDITOR |
Analytics & Intelligence
| Page | Route | Description | Min Role |
|---|---|---|---|
| Analytics Dashboard | /analytics | Performance dashboard with time-series charts | VIEWER |
| Post Analytics | /analytics/posts/:id | Per-post metric breakdown | VIEWER |
| A/B Tests | /analytics/ab-tests | A/B test management and results | EDITOR |
| Predictions | /predictions | AI engagement and revenue predictions | VIEWER |
| Intelligence | /intelligence | Gap analysis, algorithm insights | VIEWER |
Competitors
| Page | Route | Description | Min Role |
|---|---|---|---|
| Competitor List | /competitors | Track competitor social profiles | VIEWER |
| Competitor Detail | /competitors/:id | Competitor snapshot history and comparison | VIEWER |
Automation
| Page | Route | Description | Min Role |
|---|---|---|---|
| Workflow List | /workflows | All workflows with status | VIEWER |
| Workflow Editor | /workflows/:id | Visual drag-and-drop workflow builder (@xyflow/react) | EDITOR |
Conversations
| Page | Route | Description | Min Role |
|---|---|---|---|
| Inbox | /conversations | Unified conversation inbox across all platforms | EDITOR |
| Conversation Engine | /conversation-engine | ICE bot configuration, escalation rules, experiments | ADMIN |
Audience & CRM
| Page | Route | Description | Min Role |
|---|---|---|---|
| Audience | /audience | Audience profiles, segments, tags, interaction graph | VIEWER |
E-Commerce & Commerce
| Page | Route | Description | Min Role |
|---|---|---|---|
| E-Commerce | /ecommerce | Store connections, product catalog, templates | EDITOR |
| Commerce Dashboard | /commerce | Revenue dashboard, order tracking, coupons | VIEWER |
Ads
| Page | Route | Description | Min Role |
|---|---|---|---|
| Ad Campaigns | /ads | Meta Ads, TikTok Promote, auto-boost rules | EDITOR |
Social Accounts
| Page | Route | Description | Min Role |
|---|---|---|---|
| Accounts | /accounts | Connect and manage social platform accounts | ADMIN |
Agency & Collaboration
| Page | Route | Description | Min Role |
|---|---|---|---|
| Approvals | /approvals | Approval request queue | EDITOR |
| Reports | /reports | Client report generation | EDITOR |
| Client Portal | /client | Limited client view | CLIENT |
Billing
| Page | Route | Description | Min Role |
|---|---|---|---|
| Pricing | /pricing | Plan comparison and selection | VIEWER |
| Checkout | /checkout | Payment flow (Stripe/Paymob) | ADMIN |
Admin (Super Admin)
| Page | Route | Description | Min Role |
|---|---|---|---|
| Admin Dashboard | /admin | Platform-wide metrics and overview | SUPER_ADMIN |
| Admin Users | /admin/users | User management across all workspaces | SUPER_ADMIN |
| Admin AI Usage | /admin/ai-usage | AI consumption tracking per workspace | SUPER_ADMIN |
| Admin Billing | /admin/billing | Revenue management and subscription oversight | SUPER_ADMIN |
Page Count by Domain
| Domain | Pages | Directory |
|---|---|---|
| Authentication | 4 | auth/ |
| Content & Publishing | 5 | composer/, posts/, drafts/, scheduler/ |
| AI | 2 | ai-tools/, ai-brain/ |
| Analytics & Intelligence | 5 | analytics/, predictions/, intelligence/ |
| Competitors | 2 | competitors/ |
| Automation | 2 | workflows/ (in scheduler/) |
| Conversations | 2 | conversations/, conversation-engine/ |
| Audience | 1 | audience/ |
| E-Commerce & Commerce | 2 | ecommerce/, commerce/ |
| Ads | 1 | ads/ |
| Accounts | 1 | accounts/ |
| Agency | 3 | approvals/, reports/, client/ |
| Billing | 2 | pricing/, checkout/ |
| Admin | 4 | admin/ |
| Other | 2 | dashboard/, landing/ |
| Total | 38+ | (many directories contain multiple sub-pages) |
Cross-Reference
- Routing -- React Router configuration and route protection
- Components -- shared UI components used across pages
- State Management -- Zustand stores and TanStack Query
- API Reference -- backend routes these pages consume