Codelyze

Code Less, Analyze More.

Codelyze is a powerful, unified platform intended to track and visualize your competitive programming journey. By aggregating data from major coding platforms, it provides a comprehensive dashboard to monitor progress, identify strengths, and stay motivated.

---

🌟 Features

• Unified Dashboard: View statistics from LeetCode, Codeforces, and GeeksforGeeks in one place.
• Real-time Analytics: Dynamic charts and graphs to visualize your problem-solving trends.
• AI Insights: (Experimental) Get personalized feedback on your coding patterns.
• Platform Support:
  • ✅ LeetCode: Full submission stats and difficulty breakdown.
  • ✅ Codeforces: Rating history, rank, and problem distribution.
  • ⚠️ GeeksforGeeks: API Deprecated (Feb 2026).
• Modern UI/UX: Built with Next.js 14 and TailwindCSS for a sleek, responsive experience.

---

🛠️ Tech Stack

Frontend

• Framework: Next.js 14 (React)
• Styling: TailwindCSS
• Icons: Lucide React
• Charts: Custom SVG & Recharts

Backend

• Runtime: Python 3.9+
• Framework: FastAPI
• Scraping: BeautifulSoup4, Requests
• Database: MongoDB

DevOps

• Deployment: Systemd Service (Linux)
• Reverse Proxy: Traefik
• Containerization: Docker (Optional/Dev)

---

🚀 Getting Started

Follow these instructions to set up the project on your local machine.

Prerequisites

• Node.js: v18 or higher
• Python: v3.9 or higher
• MongoDB: Local or Atlas instance

Installation

1. Clone the repository

   git clone https://github.com/furkankoykiran/Codelyze.git
   cd Codelyze

2. Backend Setup

   cd backend
   
   # Install dependencies with Poetry
   poetry install
   
   # Create .env file
   cp .env.example .env
   # Edit .env with your configuration
   
   # Run Server
   poetry run python app.py

3. Frontend Setup

   cd frontend
   npm install
   
   # Run Development Server
   npm run dev

4. Access the App Open http://localhost:3000 in your browser.

---

📂 Project Structure

codelyze/
├── backend/                 # FastAPI Backend
│   ├── app.py              # Entry point
│   ├── services.py         # Scraping logic
│   ├── pyproject.toml      # Poetry dependencies
│   └── poetry.lock         # Dependency lock file
├── frontend/               # Next.js Frontend
│   ├── app/                # App Router
│   ├── components/         # UI Components
│   └── public/             # Static assets
├── LICENSE                 # MIT License
└── README.md               # Documentation

---

⚠️ Important Notes

• GeeksforGeeks API: As of February 2026, the GFG Public API has been deprecated. This integration currently returns a deprecation notice.
• Deployment: This project is optimized for deployment via Systemd services on Linux servers behind a Traefik proxy.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Developed with ❤️ by Furkan Koykiran