Skip to content

F1Companion is a modern Android application designed for Formula 1 enthusiasts. Built with the latest technologies, it provides fans with a streamlined and up-to-date information, ensuring they never miss a moment of the action

Notifications You must be signed in to change notification settings

JenilMacwan/F1Companion

Repository files navigation

App Logo

🏎️ F1Companion — Your Modern Formula 1 Companion App

Live F1 data • Race schedules • Circuit weather • Clean Jetpack Compose UI

Platform Android Kotlin Jetpack Compose Jolpica API Open-Meteo Under Development License MIT Kotlin Version


🚧 Status: Active Development
Some features are incomplete or may not work fully yet.


📸 Screenshots / UI Previews

Home Schedule Standings
Driver Info Weather Screen

🎯 Features

  • 📅 Full race weekend schedule (FP1, FP2, FP3, Qualifying, Sprint, Race)
  • 🏎 Up-to-date News of the Paddock
  • 🏁 Circuit layout & detailed circuit information
  • 🌦 Weather forecast for circuit location using Open-Meteo
  • 🎨 Modern UI built with Jetpack Compose with custom theme of LIGHT / DARK MODE
  • ⚡ Clean architecture with Kotlin, Coroutines, and MVVM

🧰 Tech Stack

Layer Technology
Language Kotlin
UI Jetpack Compose
State ViewModel + StateFlow / Coroutines
APIs Jolpica (F1 data), Open-Meteo (weather)
Concurrency Kotlin Coroutines
Architecture MVVM + Clean modular separation

🚀 Getting Started

📌 Clone Repository

git clone https://github.com/JenilMacwan/F1Companion.git
cd F1Companion

▶ Run the App

  1. Open in Android Studio
  2. Let Gradle resolve dependencies
  3. Connect device/emulator
  4. Press Run ▶

🔧 Current Limitations

  • Settings screen not fully implemented
  • API data availability varies (New data gets updated after 24hrs)
  • UI polishing ongoing
  • Possible crashes during rapid data refresh

🗺 Roadmap

Planned Feature Status
Improved animations & UI polish 🔄
Push notifications
Race history module
Favorite drivers & teams
Android Home Screen widget
Offline caching

🤝 Contributing

git checkout -b feature-branch-name
git commit -m "Description of change"
git push origin feature-branch-name

Then open a Pull Request.


⭐ Support F1Companion

If you like the project:

  • Give the repo a ⭐ on GitHub
  • Submit issues / feature requests
  • Contribute via PRs

👨‍💻 Developer

Name Role
JeniL (JenilMacwan) Developer & Project Owner

📜 License

License will be added soon.
Until then: All Rights Reserved


🏁 F1Companion — Fast • Modern • Informative
Built with Kotlin • Powered by APIs • Designed with Jetpack Compose

About

F1Companion is a modern Android application designed for Formula 1 enthusiasts. Built with the latest technologies, it provides fans with a streamlined and up-to-date information, ensuring they never miss a moment of the action

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages