If you like this project, consider giving it a ⭐ on GitHub — it helps others discover it too!
OversteerFormula1App is an open-source Android project built with Kotlin and Jetpack Compose, designed to provide Formula 1 fans with race schedules, standings, race results news, and live updates.
This is the first complete version of the project 🚀
- Language: Kotlin
- UI: Jetpack Compose
- Architecture: MVVM + Clean Architecture
- Navigation: Navigation-Compose with animated transitions
- State Management: ViewModel + Coroutines + StateFlow
- Backend: Supabase (data & auth)
- Push Notifications: Firebase Cloud Messaging
- Offline Support: Room + DataStore
- Dependency Injection: Hilt
- Build System: Gradle (KTS)
app→ Home and navigation hostsettings→ App settingsauthentication→ User login and registerstandings→ Constructor & Driver standingsnews→ F1 news and updatesschedule→ Races scheduleresult→ Race resultsnetwork→ Supabase integrationnotifications→ Push notificationsdesign→ Theming (colors, typography, shapes, sizes)datasource→ Local & remote data handlingutilities→ Shared utils and helpers
We use the Jolpica F1 as the primary data source.
- Clone the repository:
git clone https://github.com/yourusername/OversteerFormula1App.git
2.Open in Android Studio (Arctic Fox or newer). 3.Add your google-services.json for Firebase inside the app/ module. 4.Build & run the project 🚀
Our documentation is available in the docs/ folder. It covers:
- Project architecture → Overview of all modules & architecture diagram
- API integration → How API is called, endpoints used
- Database schema & offline support → Room & DataStore schema, offline support
- Dependency injection setup → Hilt setup & dependencies
- Authentication integration → How login/register works
- Notification system → Firebase + Supabase notifications
- Fork the repo & create a feature branch
- Make your changes with clear commit messages
- Open a PR describing your changes
Please also check our CONTRIBUTING.md.
This project is licensed under the MIT License – see the LICENSE file for details.
If you build something cool with OversteerFormula1App, feel free to open a PR to add it to our community list.
If you find this project useful, consider giving it a ⭐ to support development.
Big thanks to the amazing folks behind Jolpica F1 for providing the API that powers the data in this app 🙌