# KLUSTER - Campus Communication Platform

> Transform your campus into a connected community

## Overview

KLUSTER is a secure, all-in-one campus communication platform that eliminates app chaos by unifying social networking, academic collaboration, and student engagement tools in one domain-verified platform.

## Core Features

### Social Networking
- Campus-wide social feed (Cluster)
- Real-time posts, comments, and reactions
- Media sharing with carousel support
- User profiles and connections
- Domain-verified access control

### Real-Time Chat
- Direct messaging and group chats
- Unread message indicators
- Real-time notifications
- Secure end-to-end communication

### Campus Startups
- Startup discovery and investment platform
- Advanced filtering (risk level, subscription type, investment amount)
- Collapsible filter sections for better UX
- Startup cards with detailed information
- Featured carousel for highlights

### Events & Calendar
- Campus event management
- Calendar integration
- Event creation and RSVP
- Event discovery and filtering

### Resource Library
- Shared academic resources
- Document management
- Collaborative learning materials

### Leaderboard & Gamification
- Student engagement tracking
- Achievement system
- Competitive rankings

### Additional Features
- Notifications center with push notifications
- Profile customization with verified badges
- Theme switching (light/dark mode with hotkey Ctrl+Shift+J)
- Global search with Spotlight (Ctrl+K)
- Mobile-responsive design
- PWA support for mobile installation
- Extension marketplace for add-ons
- Kluster Apps launcher with custom wallpapers
- Klips short-form video platform
- Articles for long-form content
- Collaborator Hub for finding partners
- Virtual Study Rooms
- Interactive Campus Maps
- Marketplace for buying/selling
- Student Offers and deals

## Technology Stack

- **Framework**: Next.js 14+ (App Router)
- **UI Components**: Shadcn/ui with Radix UI
- **Styling**: Tailwind CSS with custom cyber/neon theme
- **Authentication**: Supabase Auth
- **Database**: Supabase (PostgreSQL)
- **Media Uploads**: ImageKit integration
- **State Management**: React Context API
- **Real-time**: Supabase Realtime subscriptions

## Architecture

### Page Structure
```
# Public Routes
/                    - Landing page
/login               - User authentication
/signup              - User registration
/about               - About Kluster
/explore-features    - Feature showcase
/help-centre         - Help documentation
/downloads           - App downloads
/brand-kit           - Brand assets
/roadmaps            - Product roadmap
/qa                  - Q&A section
/privacy             - Privacy policy
/terms               - Terms of service
/cookies             - Cookie policy
/guidelines          - Community guidelines
/report-bug          - Bug reporting
/request-organization - Organization requests

# Protected Routes (Require Auth)
/feed                - Social feed
/cluster             - Dashboard
/chat                - Messaging
/apps                - App launcher with wallpaper
/startups            - Startup discovery
/events              - Event management
/calendar            - Personal calendar
/library             - Resource library
/leaderboard         - User rankings
/notifications       - Notification center
/profile             - User profiles
/settings            - Account settings
/marketplace         - Buy/sell marketplace
/extensions          - Extension store
/offers              - Student deals
/articles            - Long-form content
/klips               - Short video content
/collaborator-hub    - Find collaborators
/study-room          - Virtual study rooms
/campus-map          - Interactive campus maps
/my-campus           - Campus dashboard
/integrations        - Third-party integrations
/search              - Global search
```

### Component Architecture
- Modular, reusable components
- Separated concerns (FilterSection, StartupCard, etc.)
- Custom hooks for shared logic
- Context providers for global state

## Design System

### Colors
- **Primary**: Neon Cyan (#00D9FF)
- **Secondary**: Neon Purple (#8B5CF6)
- **Accent**: Neon Pink (#FF006E)
- **Background**: Cyber Darker (#0a0a0f)
- **Cards**: Semi-transparent with backdrop blur

### Typography
- **Font**: Inter (Google Fonts)
- **Headings**: Gradient text effects
- **Body**: Muted foreground colors

### UI Patterns
- Collapsible sections
- Glassmorphism effects
- Smooth transitions and animations
- Hover states with neon glows
- Responsive grid layouts

## API Endpoints

### Authentication
- `/api/auth/*` - Supabase auth callbacks

### Media
- `/api/imagekit/auth` - ImageKit authentication
- `/api/imagekit/delete` - Media deletion

## Database Schema

### Key Tables
- `profiles` - User profiles and metadata
- `posts` - Social feed posts
- `comments` - Post comments
- `messages` - Chat messages
- `groups` - Group chats
- `events` - Campus events
- `carousel_slides` - Featured content

## Security Features

- Domain-verified email authentication
- Row-level security policies
- Protected routes with middleware
- Secure file uploads with validation
- CORS and CSP headers

## SEO Optimization

- Comprehensive meta tags
- Open Graph for social sharing
- Twitter Card support
- Structured data (JSON-LD)
- Dynamic sitemap generation
- Optimized robots.txt
- PWA manifest

## Development

### Local Setup
1. Clone repository
2. Install dependencies: `npm install`
3. Configure environment variables
4. Run development server: `npm run dev`

### Environment Variables
- `NEXT_PUBLIC_SUPABASE_URL`
- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
- `NEXT_PUBLIC_IMAGEKIT_*` credentials

## Deployment

- Hosted on Vercel
- Automatic deployments from main branch
- Environment variables configured in Vercel dashboard
- Custom domain: kluster.in

## Target Audience

- University students
- College faculty
- Campus administrators
- Student organizations
- Academic communities

## Competitive Advantages

1. **All-in-One Solution**: Replaces 7+ separate apps
2. **Domain Verification**: Ensures campus-only access
3. **Security First**: Built with privacy in mind
4. **Modern UX**: Sleek, fast, intuitive interface
5. **Feature Rich**: Social + Academic + Events in one place

## Support

- Website: https://kluster.in
- Help Centre: https://kluster.in/help-centre
- Report Bug: https://kluster.in/report-bug
- Email: official@kluster.in

## Legal

- Privacy Policy: https://kluster.in/privacy
- Terms of Service: https://kluster.in/terms
- Cookie Policy: https://kluster.in/cookies
- Community Guidelines: https://kluster.in/guidelines

## License

Proprietary - All rights reserved

---

Last Updated: February 2026
Version: 1.0.0