# Kluster - Complete Documentation for LLMs

> India's first AI-powered campus social network

## Quick Reference

- **Website**: https://kluster.in
- **Type**: Campus Social Network Platform
- **Target**: Indian Universities, Colleges, Educational Institutions
- **Stack**: Next.js 14+, Supabase, Tailwind CSS, Framer Motion

## All Routes

### Public (No Auth Required)
| Route | Description |
|-------|-------------|
| `/` | Landing page with animated hero |
| `/login` | Email/password authentication |
| `/signup` | New user registration |
| `/forgot-password` | Password reset |
| `/mfa-verify` | Two-factor authentication |
| `/onboarding` | New user onboarding flow |
| `/about` | Company information |
| `/explore-features` | Feature showcase |
| `/help-centre` | Documentation and FAQs |
| `/downloads` | Mobile app downloads |
| `/brand-kit` | Logo and brand assets |
| `/roadmaps` | Product roadmap |
| `/qa` | Questions and answers |
| `/privacy` | Privacy policy |
| `/terms` | Terms of service |
| `/cookies` | Cookie policy |
| `/guidelines` | Community guidelines |
| `/report-bug` | Bug reporting form |
| `/request-organization` | Request new organization |

### Protected (Auth Required)
| Route | Description |
|-------|-------------|
| `/home` | User dashboard |
| `/feed` | Main social feed |
| `/cluster` | Dashboard |
| `/chat` | Real-time messaging |
| `/chat/[id]` | Individual chat thread |
| `/apps` | App launcher with wallpapers |
| `/startups` | Startup discovery |
| `/startups/[id]` | Individual startup page |
| `/events` | Campus events |
| `/events/[id]` | Event details |
| `/calendar` | Personal calendar |
| `/library` | Resource library |
| `/leaderboard` | User rankings |
| `/notifications` | Notification center |
| `/profile` | Current user profile |
| `/profile/[username]` | Public profile |
| `/settings` | Account settings |
| `/marketplace` | Buy/sell items |
| `/marketplace/[id]` | Listing details |
| `/extensions` | Extension store |
| `/extensions/[slug]` | Extension details |
| `/offers` | Student deals |
| `/articles` | Long-form content |
| `/klips` | Short videos |
| `/collaborator-hub` | Find partners |
| `/study-room` | Virtual study rooms |
| `/campus-map` | Interactive maps |
| `/my-campus` | Campus dashboard |
| `/integrations` | Third-party integrations |
| `/search` | Global search |

### API Routes
| Route | Method | Description |
|-------|--------|-------------|
| `/api/auth/callback` | GET | OAuth callback |
| `/api/imagekit/auth` | GET | ImageKit authentication |
| `/api/imagekit/delete` | DELETE | Delete media |
| `/api/push/subscribe` | POST | Push notification subscription |
| `/api/push/send` | POST | Send push notification |

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| `Ctrl+K` / `Cmd+K` | Open Spotlight search |
| `Ctrl+Shift+J` | Toggle dark/light theme |
| `Escape` | Close modals/dialogs |

## Database Tables (Supabase)

- `profiles` - User profiles
- `posts` - Feed posts
- `comments` - Post comments
- `likes` - Post/comment likes
- `messages` - Chat messages
- `conversations` - Chat threads
- `groups` - Group chats
- `events` - Campus events
- `marketplace_listings` - Marketplace items
- `extensions` - Extension store
- `startups` - Startup listings
- `articles` - Published articles
- `notifications` - User notifications
- `organizations` - Verified campuses

## Environment Variables

```
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
NEXT_PUBLIC_IMAGEKIT_PUBLIC_KEY=
NEXT_PUBLIC_IMAGEKIT_URL_ENDPOINT=
IMAGEKIT_PRIVATE_KEY=
NEXT_PUBLIC_VAPID_PUBLIC_KEY=
VAPID_PRIVATE_KEY=
NEXT_PUBLIC_MAPBOX_TOKEN=
```

## Key Components

- `AppSidebar` - Main navigation sidebar
- `Header` - Top navigation bar
- `SpotlightSearch` - Global search modal
- `GlobalHotkeyProvider` - Keyboard shortcuts handler
- `NotificationBell` - Notification indicator
- `ThemeProvider` - Dark/light mode
- `AuthProvider` - Authentication context

## Sitemap

Auto-generated at `/sitemap.xml` including:
- All static pages
- Dynamic posts (`/post/[id]`)
- Marketplace listings (`/marketplace/[id]`)
- Articles (`/article/[id]`)
- Extensions (`/extensions/[slug]`)
- Startups (`/startups/[id]`)
- Events (`/events/[id]`)

## Robots.txt

Located at `/robots.txt` - allows all crawlers, references sitemap.

## Contact

- Help: https://kluster.in/help-centre
- Bugs: https://kluster.in/report-bug
- Email: official@kluster.in

---
Last Updated: February 2026