Mai-Tai Site Map - Page Structure & Navigation

gistfile0.txt

# Mai-Tai Site Map

A tree-style overview of all pages and their purposes.

## Page Structure

```
mai-tai.dev/
│
├── /                           # Landing page (public)
│   └── Hero, features, CTA → Login/Register
│
├── /login                      # Login page (public)
│   └── Email/password form
│
├── /register                   # Registration page (public)
│   └── Create account form
│
└── [Authenticated Routes]      # Requires login
    │
    ├── /dashboard              # Main dashboard
    │   ├── Quick stats (projects, messages, agents)
    │   ├── Recent activity feed
    │   └── Quick actions (new project, etc.)
    │
    ├── /projects               # Project list
    │   ├── Grid of user's projects
    │   ├── Create new project button
    │   └── Project cards with quick stats
    │
    ├── /projects/[id]          # Single project view
    │   │
    │   ├── [Channel List View]     # Default when no channel selected
    │   │   ├── List of channels with agent bindings
    │   │   ├── Create channel button
    │   │   └── Edit/delete channel actions
    │   │
    │   ├── [Chat View]             # When channel is selected
    │   │   ├── Breadcrumb: project / #channel
    │   │   ├── Message list with real-time updates
    │   │   ├── Message input with send button
    │   │   ├── Agent status indicator (if agent bound)
    │   │   └── Member avatars
    │   │
    │   └── [Settings Modal]        # Gear icon
    │       ├── General tab (name, description, archive)
    │       ├── API Keys tab (create, list, delete, channel binding)
    │       └── Dude Mode toggle
    │
    ├── /settings               # User settings
    │   ├── Profile section (name, email, avatar)
    │   ├── Password change
    │   └── Account preferences
    │
    ├── /admin                  # Admin panel (admin users only)
    │   ├── User management
    │   ├── System stats
    │   └── Feature flags
    │
    ├── /agents                 # Placeholder - future agent management
    │   └── Coming soon
    │
    ├── /channels               # Placeholder - future global channel view
    │   └── Coming soon
    │
    └── /search                 # Placeholder - future search
        └── Coming soon
```

## Navigation

### Top Navigation Bar
- Logo (→ /dashboard)
- Projects dropdown (→ /projects, quick project access)
- Channels popup (→ quick channel access across projects)
- User menu (→ /settings, logout)

### Mobile Navigation
- Hamburger menu with same options
- Bottom-safe area for input on chat view

## User Flows

### New User Flow
```
/ → /register → /dashboard → Create Project → Onboarding Flow → /projects/[id]
```

### Returning User Flow
```
/login → /dashboard → /projects → /projects/[id] → Select Channel → Chat
```

### Agent Setup Flow
```
/projects/[id] → Settings → API Keys → Create Key (select channel) → Copy Key → Configure MCP
```

## Page Status

| Page | Status | Notes |
|------|--------|-------|
| `/` | ✅ Complete | Landing page |
| `/login` | ✅ Complete | Auth working |
| `/register` | ✅ Complete | Auth working |
| `/dashboard` | ✅ Complete | Stats, activity |
| `/projects` | ✅ Complete | List, create |
| `/projects/[id]` | ✅ Complete | Channels, chat, settings |
| `/settings` | ✅ Complete | Profile, password |
| `/admin` | ✅ Complete | User management |
| `/agents` | 🚧 Placeholder | Future: agent profiles |
| `/channels` | 🚧 Placeholder | Future: global channel view |
| `/search` | 🚧 Placeholder | Future: search across projects |

## Future Considerations

1. **Agent Profiles** (`/agents`)
   - Configure agent personalities
   - View agent activity across projects
   - Manage agent permissions

2. **Global Channel View** (`/channels`)
   - See all channels across all projects
   - Quick jump to any channel
   - Unread indicators

3. **Search** (`/search`)
   - Search messages across projects
   - Filter by channel, user, date
   - Full-text search

4. **Notifications** (`/notifications`)
   - Message mentions
   - Agent activity alerts
   - System notifications