Skip to content

adityapaul26/CPBuddy

Repository files navigation

CPBuddy Logo

CPBuddy

The ultimate companion for competitive programmers.
Track contests, analyze profiles, and stay ahead of the curve with a stunning Glassmorphic interface.

FeaturesShowcaseTech StackDownloadSupport

Latest Version MVVM Architecture Kotlin Language Jetpack Compose Toolkit Material Design 3


CPBuddy isn’t just another contest tracker. It’s a precision tool designed for developers who live and breathe competitive programming. Built from the ground up with a focus on performance and aesthetics, it brings all your contest data into one beautiful, immersive experience.


📸 Showcase

Contests Screen Profile Search

✨ Features

🏆 Contest Tracking

  • Real-time updates from Codeforces, CodeChef, and LeetCode.
  • Featured "Next Contest" card with live countdown.
  • Direct registration links to keep you fast.

📊 Analytics

  • Deep-dive into Codeforces user stats.
  • Color-coded rank indicators and rating history.
  • Contribution tracking and user details at a glance.

💎 Glassmorphism UI

  • Signature blurred backgrounds and sleek transitions.
  • Modern Material 3 components.
  • Immersive experience that feels "alive".

🚀 Performance

  • Built with Kotlin Coroutines for buttery smooth UI.
  • Efficient image loading with Coil.
  • Lightweight and optimized for modern Android.

🛠 Tech Stack

Category Tools & Libraries
UI Framework Jetpack Compose
Architecture MVVM with Clean Architecture principles
Networking Retrofit 2 + GSON
Concurrency Kotlin Coroutines & Flow
Image Loading Coil
Navigation Jetpack Navigation Compose
Theming Material 3 (M3) with Custom Glass Components

🚀 Getting Started

Prerequisites

  • Android Studio (Ladybug or newer)
  • JDK 17+
  • Android SDK (API 36)

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/CPBuddy.git
  2. Open & Sync: Open the project in Android Studio and let Gradle sync.
  3. Run: Connect your device and hit Run!

📈 Roadmap

  • Push Notifications: Never miss a contest registration deadline.
  • Calendar Sync: Add contests directly to your Google Calendar.
  • Expanded Support: Add LeetCode and CodeChef profile analytics.
  • Offline Mode: Cache data with Room for viewing on the go.

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  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

🙏 Acknowledgments

We stand on the shoulders of giants:

  • CompeteAPI for the amazing contest data provider.
  • ravibabuvadde for his work on competitive programming APIs.
  • The Material Design team for the M3 spec.

If CPBuddy helped you win your next contest, please consider giving us a ⭐


CPBuddy Footer

About

A real-time competitive programming hub for tracking global contests and deep-diving into Codeforces analytics.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages