🏛️ CodeColosseum

An Institute-Level Coding Platform

Where coding gladiators battle for glory and mastery!

🎯 About CodeColosseum

CodeColosseum is a comprehensive coding platform designed for institutes and universities. It provides a complete ecosystem for students to learn, practice, compete, and master programming skills in an engaging, gamified environment.

⚡ Features

🏛️ Core Platform

• Interactive Code Editor - Write, run, and test code in real-time
• Problem Solving - 50+ coding challenges with solutions
• Live Contests - Competitive programming tournaments
• AI Mentor - Personalized coding guidance with Google Gemini
• Discussion Forum - Community-driven learning and collaboration

🎮 Interactive Elements

• Practice Mode - Unlimited coding practice
• Arena Battles - Live competitive coding
• Leaderboard - Track your ranking among warriors
• Progress Tracking - Monitor your coding journey

🤖 AI-Powered Features

• Smart Code Review - Get feedback on your solutions
• Personalized Learning - AI mentor adapts to your skill level
• Real-time Help - 24/7 assistance for coding problems

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Installation

1. Clone the repository

   git clone https://github.com/yourusername/colosseum.git
   cd colosseum

2. Install dependencies

   npm install

3. Set up environment variables

   # Copy the example environment file
   cp .env.example .env.local
   
   # Add your Gemini API key to .env.local
   VITE_GEMINI_API_KEY=your_gemini_api_key_here

4. Run the development server

   npm run dev

5. Open your browser Navigate to http://localhost:5173

🏛️ Platform Sections

📚 Problems Tab

• Browse coding challenges by difficulty
• Interactive code editor with real-time execution
• Test case validation and feedback
• Starter code and solutions provided

⚔️ Arena Tab

• Live coding contests and tournaments
• Practice mode for skill improvement
• Leaderboard and rankings
• Quick battles and challenges

🤖 Mentor Tab

• AI-powered coding assistance
• Personalized learning recommendations
• Code review and optimization tips
• 24/7 availability for help

💬 Discussion Tab

• Community forum for questions and answers
• Topic-based discussions
• Knowledge sharing and collaboration
• Mentor and peer interactions

🏆 Contests Tab

• Scheduled coding competitions
• Real-time participation
• Prize tournaments
• Performance analytics

🛠️ Technology Stack

• Frontend: React 18 + TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS
• Icons: Lucide React
• AI Integration: Google Gemini API
• Code Execution: JavaScript Runtime

📁 Project Structure

colosseum/
├── components/          # React components
│   ├── Hero.tsx       # Landing page hero
│   ├── CodeEditor.tsx # Interactive code editor
│   ├── Mentor.gemini.tsx # AI mentor interface
│   └── ...
├── services/           # API services
│   └── geminiAPI.ts   # Gemini AI integration
├── types.ts           # TypeScript type definitions
├── constants.tsx      # App constants and data
└── public/           # Static assets

🔧 Configuration

Environment Variables

Create a .env.local file with:

VITE_GEMINI_API_KEY=your_gemini_api_key_here

Getting a Gemini API Key

1. Visit Google AI Studio
2. Create a new API key
3. Add it to your .env.local file

🎮 How to Use

Solving Problems

1. Navigate to the Problems tab
2. Choose a problem by difficulty
3. Read the description and examples
4. Write your solution in the code editor
5. Click Run Code to test your solution
6. View results and test case feedback

Participating in Contests

1. Go to the Arena tab
2. Join a live contest or practice mode
3. Solve problems under time pressure
4. Compete with other warriors
5. Check your rank on the leaderboard

Using the AI Mentor

1. Click the Mentor tab or floating button
2. Ask coding questions or request help
3. Get personalized guidance and explanations
4. Receive code reviews and optimization tips

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🎯 Areas for Contribution

• Adding new coding problems
• Improving UI/UX design
• Enhancing AI mentor capabilities
• Bug fixes and performance improvements
• Documentation improvements

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Google Gemini for AI mentorship capabilities
• Vite for the blazing-fast development experience
• Tailwind CSS for the beautiful UI components
• Lucide React for the amazing icon set

📞 Contact

• GitHub Issues: Report bugs and request features
• Discussions: Join our community

---

🏛️ Made with ❤️ for coding warriors everywhere 🏛️

⭐ Star this repo if you find it helpful! ⭐