A Kotlin Multiplatform app to track and monitor Codeforces users, contests, and rating changes - available on Android and iOS.
Codeforces Seeker helps competitive programmers track their friends, teammates, or favorite competitive programmers on Codeforces. Get real-time updates on rating changes, contest standings, problems, and user statistics with a beautiful Material 3 UI.
- 📊 Track multiple Codeforces users with real-time sync
- 📈 Interactive rating history chart in user details
- 🔍 Search and sort users by handle, rating, max rating, last sync, or last rating update
- 🔄 Auto-refresh with visual sync status indicators
- 🔴 Red border highlights for outdated users (with count indicator)
- 🔗 Click to open contests from rating history
- 🎨 Adaptive color themes based on user ratings
- 📋 Detail toggle showing last contest name and max rating
- 🔗 Profile link button to open Codeforces profile in browser
- ✉️ Clickable email hyperlink in user details
- 🏆 Browse and search past Codeforces contests
- 📊 View full contest standings with participant details
- 🔮 Rating delta column in contest standings
- 🔍 Search participants within contest standings
- 📈 Ratings tab showing all rating changes from a contest
- 📝 Problems tab with "Hide spoilers" filter
- 📋 Long-press to copy participant handles
- 🔗 Open problems directly in browser
- 📅 Daily problem recommendations with rating ranges
- 🏅 Daily leaderboard tracking solved problems
- 🔐 Codeforces account verification and sign-in
- ⏰ Timing info for daily problem refresh
- 👤 Codeforces account verification
- 🔗 Link your Codeforces account to track progress
- 🎨 Modern Material 3 UI
- 📱 Optimized image loading with smooth scrolling
- 🔥 Firebase integration (Analytics, Crashlytics, Remote Config)
- ⚡ Optimized database queries with indexes and views
- Kotlin 2.2 - 100% Kotlin, shared across Android and iOS
- Compose Multiplatform - Shared declarative UI
- Material 3 - Latest Material Design components
- Coroutines & Flow - Asynchronous programming
- Koin - Multiplatform dependency injection
- Room KMP - Shared local database with KSP
- Ktor - Multiplatform HTTP client
- kotlinx-serialization - Multiplatform JSON parsing
- Coil 3 - Multiplatform image loading
- Navigation Compose - Type-safe multiplatform navigation
- DataStore - Modern data persistence
- kotlinx-datetime - Multiplatform date/time
- MVVM - Model-View-ViewModel pattern
- Repository Pattern - Data layer abstraction
- Clean Architecture - Separation of concerns
- Single Activity - Compose navigation (Android)
- Android: Firebase (Analytics, Crashlytics, Remote Config), WorkManager
- iOS: Swift wrapper with Firebase bridges, NSUserDefaults
composeApp/src/
├── commonMain/kotlin/com/dush1729/cfseeker/
│ ├── analytics/ # Analytics service abstraction
│ ├── crashlytics/ # Crashlytics service abstraction
│ ├── data/
│ │ ├── local/ # Room database, DAOs, entities, views
│ │ ├── remote/ # Ktor API client, models
│ │ └── repository/ # Repository implementations
│ ├── di/ # Koin modules
│ ├── navigation/ # Type-safe navigation routes
│ ├── platform/ # expect declarations for platform code
│ ├── utils/ # Utility functions
│ └── ui/
│ ├── base/ # Base UI classes
│ ├── components/ # Reusable Compose components
│ ├── screens/ # App screens (Users, Contests, Details)
│ └── theme/ # Material 3 theme
├── androidMain/kotlin/com/dush1729/cfseeker/
│ ├── analytics/ # Firebase Analytics implementation
│ ├── crashlytics/ # Firebase Crashlytics implementation
│ ├── data/ # Android-specific data (Firebase Remote Config)
│ ├── di/ # Android Koin modules
│ ├── platform/ # actual implementations
│ ├── widget/ # Android widgets
│ └── worker/ # WorkManager workers
└── iosMain/kotlin/com/dush1729/cfseeker/
├── bridge/ # Swift-to-Kotlin bridge interfaces
├── data/ # iOS-specific data layer
├── di/ # iOS Koin modules
└── platform/ # actual implementations (iOS)
This project has undergone significant modernization and feature additions:
Commit: d38ca97 - migration: dagger to hilt
Migrated from Dagger 2 to Dagger Hilt for simplified dependency injection with less boilerplate and better Android integration.
Migration Commits:
ed5d446- setup compose dependencies in gradle(#1)d11477b- setup compose ui: Color, Theme and Type(#1)8b7d771- compose: create components and screen(#1)
Fully migrated from XML-based UI to Jetpack Compose for a modern, declarative UI approach with better maintainability.
- In-app WebView for opening problem links (no more switching to browser)
- All Time cumulative leaderboard in Daily tab
- Show actual rating deltas instead of predicted deltas in contest standings
- Fixed OOM crash caused by getRatedList API call
- Daily tab with curated daily problems (rating ranges) and leaderboard
- Profile tab with Codeforces account verification
- Rating delta column in contest standings
- Profile link button in User Details screen
- Detail toggle on user list showing last contest name and max rating
- More sorting options for users (max rating, etc.)
- Outdated users count displayed below last sync text
- Clickable email hyperlink in User Details
- Firebase Cloud Functions backend for daily leaderboard
- Migrated entire codebase to Kotlin Multiplatform (KMP)
- Added iOS support with shared UI via Compose Multiplatform
- Replaced Retrofit + Gson with Ktor + kotlinx-serialization
- Replaced Dagger Hilt with Koin for multiplatform DI
- Migrated Room from kapt to KSP for KMP compatibility
- Upgraded to Coil 3, Navigation Compose KMP, kotlinx-datetime
- Fix Room migration crash for users upgrading from older versions
- Send DB version to Firebase Crashlytics for better debugging
- Native debug symbols for better crash analysis
- "Show local only" filter in standings and rating changes
- "Hide spoilers" filter chip for problems
- Long-press to copy participant handles
- Click-to-open contest links from rating history
- Database views for optimized user list with latest rating changes
- Debouncer to reduce database load
- Clear contest data in preferences when clearing cache
- App name update in Share title and content
- Show "Sync All" only when outdated users present
- Play Store link in README
- Red border highlights for outdated users
- Sync All dialog with confirmation
- Clear contest data functionality
- Case-insensitive user sorting fix
- Auto-refresh with visual sync status indicators
- Interactive user rating chart in details screen
- Ratings tab in contest details
- App renamed from CF Seeker to Codeforces Seeker
- AsyncImage optimizations for smooth scrolling
- Reduced API calls from 2n to n+1
- ProGuard rules for optimized release builds
- Sync indicators in contest screens
- Fixed blank screen on quick back presses
- Fixed tie handling in contest standings
- Browse and search past Codeforces contests
- Full contest standings with participant search
- Full-screen user details (replaced bottom sheet)
- Tabbed interface (Info, Ratings) in user details
- Search within user's rating history
- Open problems directly in browser
- Auto-refresh for contests
- Scrollable bottom sheet
- Hide empty results during search
- Empty users view for better onboarding
- Auto-popup keyboard on bottom sheet
- Database query optimizations with indexes
- IO thread improvements for DataStore & Firebase
- Firebase Analytics with event tracking
- Crashlytics for crash reporting
- Remote Config for feature flags
- Sync all cooldown to prevent API abuse
- About screen
- Snackbar notifications for actions
- Animated list items
- Search feature for users
- Sort by handle option
- Sync all users functionality
- Rank-based color themes
- Track Codeforces users
- View rating changes
- Add/delete users
- User detail bottom sheet
- Dagger to Hilt migration
- XML to Jetpack Compose migration
- Android Studio Ladybug (2024.2) or newer
- Xcode 15+ (for iOS development)
- JDK 11 or higher
- Android SDK with minimum API 24 (Android 7.0)
This app uses Firebase services. To set it up:
-
Create a Firebase project:
- Go to Firebase Console
- Create a new project or use an existing one
- Add an Android app with package name:
com.dush1729.cfseeker
-
Download google-services.json:
- In Firebase Console, go to Project Settings
- Download the
google-services.jsonfile - Place it in the
composeApp/directory
-
Enable Firebase services:
- Enable Firebase Analytics in the Firebase Console
- Enable Crashlytics for crash reporting
- Enable Remote Config for feature flags
Create a keystore.properties file in the project root:
storeFile=keystore.jks
storePassword=your_store_password
keyAlias=your_key_alias
keyPassword=your_key_password# Android debug build
./gradlew :composeApp:assembleDebug
# Android release build
./gradlew :composeApp:assembleRelease
# Install on connected Android device
./gradlew :composeApp:installDebugFor iOS, open iosApp/iosApp.xcodeproj in Xcode and run.
Contributions are welcome! Whether it's bug fixes, new features, or improvements to documentation.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow Kotlin coding conventions
- Write meaningful commit messages
- Add tests for new features
- Ensure all builds pass before submitting PR
- Update documentation for significant changes
This project is available for educational and personal use.
Dushyant Singh (@dush1729)
- Codeforces API for providing the data
- Kotlin Multiplatform for cross-platform development
- Compose Multiplatform for shared UI
- Firebase team for excellent backend services
Star ⭐ this repo if you find it useful!