A Product Hunt-style platform for the University of Illinois community to discover and showcase innovative student projects, research, and startups.
IlliniHunt is a problem-solving discovery platform designed specifically for the Illinois community. Instead of just showcasing technology, we help students, faculty, and staff discover projects that solve real-world problems.
- 🎓 University-Focused: Restricted to @illinois.edu authentication
- 🎯 Problem-Centered: Categories based on what problems projects solve, not just technology used
- 💬 Community Engagement: Threaded comments, voting, and project collections
- 📊 Comprehensive Profiles: User profiles with project portfolios and academic context
- 📱 Mobile-First Design: Responsive UI optimized for all devices
Our innovative categorization system helps users discover projects by the problems they solve:
| Category | Description | Icon |
|---|---|---|
| Learning & Education Tools | Educational platforms, study aids, tutoring systems | 🎓 |
| Social & Communication | Social networks, messaging, collaboration tools | 👥 |
| Productivity & Organization | Task management, calendars, workflow tools | 📅 |
| Health & Wellness | Fitness apps, mental health, medical tools | ❤️ |
| Creative & Entertainment | Art tools, games, multimedia platforms | 🎨 |
| Research & Data Analysis | Data visualization, research tools, analytics | 📊 |
| Business & Entrepreneurship | Startup tools, business apps, marketplace | 📈 |
| Emerging Technology | AI/ML, blockchain, IoT, cutting-edge tech | ⚡ |
Production URLs:
- Primary: https://illinihunt.vercel.app
- Custom Domain: https://illinihunt.org
- Status: ✅ Production Ready
Modern, Production-Ready Stack:
- Frontend: React 18 + TypeScript + Vite + Tailwind CSS
- Backend: Supabase (PostgreSQL + Auth + Real-time)
- UI/UX: shadcn/ui components, UIUC brand colors (
#FF6B35,#13294B) - Deployment: Vercel with auto-deploy from GitHub
✅ Core Features Complete: Project submission, real-time voting, threaded comments, user profiles, collections, admin dashboard
📚 Documentation:
- 📖 Documentation Index - Complete documentation guide
- 🏗️ Architecture Overview - Full system design
- 🔧 Developer Guide - Quick reference and commands
- 🎨 Design System - Neon Glass aesthetic
- 🔐 OAuth Setup - Authentication configuration
# Clone & Install
git clone https://github.com/vishalsachdev/illinihunt.git && cd illinihunt && npm install
# Environment (.env.local)
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_anon_key
# Start Development
npm run dev # http://localhost:5173npm run dev # Development server
npm run build # Production build
npm run type-check # TypeScript validation
npm run lint # Code quality check📖 For detailed setup and development workflow, see: CLAUDE.md
All essential features implemented and production-ready:
- Secure authentication (@illinois.edu only)
- Project submission and discovery
- Real-time voting and comments
- User profiles and collections
- Advanced search and filtering
- Trending algorithm with analytics
- Admin moderation tools
- Testing framework
📅 For detailed implementation plans: docs/IMPROVEMENT_ROADMAP.md
Welcome Illinois Students! 🎓 IlliniHunt is built by students, for students. Contributing offers unique opportunities for portfolio building, academic credit, and real-world experience with modern web development.
- Read our Contributing Guide - Comprehensive guide for Illinois contributors
- Browse Student-Friendly Issues - Perfect starting points
- Try AI-Assisted Development - Use @claude for help and learning
IlliniHunt features a revolutionary automated development pipeline that takes non-technical users from idea to working feature!
Have a great idea but can't code? No problem! Our automated workflow handles everything:
- 💡 Submit Your Idea - Use our GitHub issue templates to describe what you want
- 🤖 AI Clarification - @claude asks questions to understand your needs perfectly
- 📋 Specification Creation - @claude creates detailed technical plans for your review
- ✅ Your Approval - Simple checkbox approval process
- ⚡ Automatic Implementation - @claude writes production-ready code
- 👥 Expert Review - Experienced developers ensure quality
- 🚀 Live Deployment - Your feature goes live automatically!
🚀 Get Started: Submit a Feature Request or Report a Bug
Want to dive deep into modern web development? Perfect! You'll get hands-on experience with:
- 🏆 Real-World Impact: Your code affects real users daily
- 🎓 Portfolio Building: Showcase real-world React/TypeScript/Supabase experience
- 🧠 AI-Assisted Coding: Learn from @claude's guidance and explanations
- 👥 Community Building: Connect with fellow Illinois developers
- 📈 Career Growth: Reference from project maintainers
Development Features:
- 🔄 Hot Reload Development - See changes instantly
- 🧪 Type-Safe Development - TypeScript catches errors early
- 🎨 Component Library - Pre-built UI components
- 📊 Real-time Features - WebSocket subscriptions and optimistic UI
- 🔒 Security-First - Row Level Security (RLS) and domain restrictions
Perfect for:
- CS/ECE students learning modern web development
- Research projects needing real-world deployment
- Senior design projects and capstone work
- Students interested in startup experience
- CS 411 (Database Systems) - Real database optimization and schema design
- CS 421 (Programming Languages) - TypeScript advanced patterns and functional concepts
- CS 465 (User Interface Design) - UI/UX research and A/B testing
- ECE 408 (Applied Parallel Programming) - Performance optimization and caching
- BADM 350 (Intro to Information Systems) - Business analysis and user research
- 🌟 Contributor Credits - Your name featured on the platform
- 📝 LinkedIn Recommendations - From project maintainers
- 🎯 Portfolio Projects - Real-world examples for internship applications
- 🚀 Startup Experience - Learn product development and user feedback cycles
- 🎓 Academic Credit - Work with professors to integrate contributions into coursework
Stuck? Need Help? We've got you covered:
- 🤖 AI Assistant (@claude) - Get coding help and explanations 24/7
- 💬 GitHub Discussions - Community support and feature discussions
- 📋 Detailed Issues - Clear descriptions with acceptance criteria
- 🎥 Video Walkthroughs - Screen recordings for complex features
- 👥 Peer Reviews - Learn from experienced contributor feedback
New to open source? No problem! We have first-contribution issues perfect for beginners.
- 🎯 Target Users: 50,000+ University of Illinois students, faculty, and staff
- 🚀 Current Status: Production-ready with growing user base
- 📈 Growth Strategy: Course integration and faculty partnerships
- 🔒 Security: Enterprise-grade authentication and data protection
- 🐛 Bug Reports: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📧 Direct Contact: [email protected]
MIT License - see LICENSE for details.
Built with ❤️ by Illinois students, for Illinois students 🎓