BranchesTags

Repository files navigation

FastestLap 🏎️

FastestLap Logo

Your Ultimate Formula 1 Companion App

VersionAPILicense

Features • Screenshots • Installation • Architecture • Contributing

📖 About

FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).

Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.

👥 Team: The Coffee Coders

  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo

✨ Features

🏁 Race Information

  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen

🏆 Standings & Statistics

  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits

📰 News & Updates

  • Multi-Source News Feed - Aggregated F1 news from:
    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates

🎯 Junior Categories

  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories

👤 User Features

  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience

🌍 Localization

  • Multi-Language Support - Available in:
    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale

🎨 User Experience

  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions

📱 Screenshots

Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots

🚀 Installation

Prerequisites

  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features

Setup Instructions

  1. Clone the Repository

    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap

  2. Configure Firebase

    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately

  3. Configure Local Properties (if needed)

    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH

  4. Build the Project

    ./gradlew build

    Or on Windows:

    gradlew.bat build

  5. Run the App

    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)

🏗️ Architecture

FastestLap follows Clean Architecture principles with a clear separation of concerns.

Project Structure

app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns

  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation

Tech Stack

Core

  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36

Libraries & Frameworks

UI & Navigation

  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0

Networking

  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2

Database

  • Room 2.8.4

Firebase

  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0

Image Loading

  • Glide 5.0.5

Utilities

  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1

Testing

  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0

🔌 APIs & Data Sources

F1 Data API

Firebase Services

  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates

News Sources

  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news

🛠️ Development

Build Variants

buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}

Running Tests

# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport

Code Style

This project follows standard Android coding conventions:

  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation

Lombok Usage

The project uses Lombok for reducing boilerplate code:

  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods

📋 TODO & Roadmap

Check out our TODO.md for a comprehensive list of planned improvements and features.

🏎️ Next Up: Live Data Suite

  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)

High Priority

  • Add comprehensive unit tests
  • Enable ProGuard for release builds
  • Implement Firebase Crashlytics
  • Migrate to Kotlin (incremental)
  • Add dependency injection (Hilt)

Future Features

  • Push notifications for race updates
  • Home screen widgets
  • Offline mode enhancement
  • Social features (predictions, discussions)
  • Wear OS support

🤝 Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request

Contribution Guidelines

  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact & Support

Team Members

Project Links

🙏 Acknowledgments

  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible

📊 Project Stats

  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)

Made with ☕ by The Coffee Coders

⭐ Star this repo if you find it useful!

Report Bug • Request Feature

About

Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.

Resources

Readme
MIT license
Activity

Stars

1 star

Watchers

2 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
FastestLap 🏎️
FastestLap Logo
Your Ultimate Formula 1 Companion App
VersionAPILicense
Features • Screenshots • Installation • Architecture • Contributing
📖 About
FastestLap is a comprehensive Android application designed for Formula 1 enthusiasts. Stay up-to-date with real-time race results, driver and constructor standings, upcoming events, breaking F1 news, and insights into junior categories (Formula 2 & Formula 3).
Built with modern Android development practices, FastestLap provides an intuitive and engaging user experience for following your favorite drivers, teams, and races throughout the season.
👥 Team: The Coffee Coders
  • Broglio Matteo
  • Caputo Lorenzo
  • Gargioli Federico
  • Groppo Gabriele
  • Lanticina Riccardo
✨ Features
🏁 Race Information
  • Live Race Results - Get up-to-the-minute results from qualifying, sprint, and race sessions
  • Event Schedule - View complete weekend schedules with session times
  • Countdown Timers - Never miss a race with live countdown to upcoming events
  • Past Events - Browse historical race results and standings
  • Calendar Export - Add full weekend session schedules directly to your device calendar
  • Home Screen Widgets - Quick access to race info and countdowns from your home screen
🏆 Standings & Statistics
  • Driver Standings - Real-time driver championship rankings
  • Constructor Standings - Team championship leaderboard
  • Historical Data - Access to complete season statistics
  • Detailed Bio Pages - In-depth profiles for drivers, constructors, and circuits
📰 News & Updates
  • Multi-Source News Feed - Aggregated F1 news from:

    • Autosport
    • Crash.net
    • Motorsport
  • English & Italian Sources - Multilingual news coverage
  • RSS Integration - Real-time news updates
🎯 Junior Categories
  • Formula 2 Support - Results and standings for F2
  • Formula 3 Support - Results and standings for F3
  • Driver Progression - Track drivers as they move through categories
👤 User Features
  • Personal Preferences - Set favorite drivers and teams
  • Auto-Login - Seamless authentication with Firebase
  • Google Sign-In - Quick OAuth integration
  • Profile Management - Customize your experience
🌍 Localization
  • Multi-Language Support - Available in:

    • English (en-GB)
    • Italian (it)
  • Regional Formatting - Date, time, and number formats based on locale
🎨 User Experience
  • Dark Mode - Full dark theme support
  • Material Design - Modern, intuitive interface
  • Responsive Layouts - Optimized for various screen sizes
  • Smooth Animations - Polished transitions and interactions
📱 Screenshots
Home ScreenStandingsDriver Bio
HomeStandingsDriver Bio
Event DetailsProfileCalendar
EventProfileCalendar
View More Screenshots
🚀 Installation
Prerequisites
  • Android Studio Arctic Fox (2020.3.1) or later
  • JDK 11 or higher
  • Android SDK API 26+ (Android 8.0 Oreo)
  • Firebase Account for authentication and database features
Setup Instructions
  1. Clone the Repository
    git clone https://github.com/yourusername/fastestlap.git
cd fastestlap
  2. Configure Firebase
    • Create a new Firebase project at Firebase Console
    • Download google-services.json and place it in app/ directory
    • Enable Firebase Authentication (Email/Password and Google Sign-In)
    • Set up Firebase Realtime Database
    • Configure database rules appropriately
  3. Configure Local Properties (if needed)
    # local.propertiessdk.dir=YOUR_ANDROID_SDK_PATH
  4. Build the Project
    ./gradlew build
    Or on Windows:
    gradlew.bat build
  5. Run the App
    • Open the project in Android Studio
    • Sync Gradle files
    • Run on an emulator or physical device (API 24+)
🏗️ Architecture
FastestLap follows Clean Architecture principles with a clear separation of concerns.
Project Structure
app/
├── src/
│ ├── main/
│ │ ├── java/com/the_coffe_coders/fastestlap/
│ │ │ ├── adapter/ # RecyclerView Adapters
│ │ │ ├── api/ # API Response Models
│ │ │ ├── database/ # Room Database
│ │ │ ├── domain/ # Business Models
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── grand_prix/
│ │ │ │ ├── news/
│ │ │ │ └── user/
│ │ │ ├── dto/ # Data Transfer Objects
│ │ │ ├── mapper/ # Data Mappers
│ │ │ ├── repository/ # Repository Layer
│ │ │ ├── service/ # API Services
│ │ │ ├── source/ # Data Sources
│ │ │ │ ├── driver/
│ │ │ │ ├── constructor/
│ │ │ │ ├── news/
│ │ │ │ ├── result/
│ │ │ │ ├── standing/
│ │ │ │ ├── track/
│ │ │ │ ├── user/
│ │ │ │ └── weeklyrace/
│ │ │ ├── ui/ # UI Layer (MVVM)
│ │ │ │ ├── bio/ # Biography Activities
│ │ │ │ ├── event/ # Event Activities
│ │ │ │ ├── home/ # Home & Fragments
│ │ │ │ ├── junior/ # Junior Categories
│ │ │ │ ├── profile/ # User Profile
│ │ │ │ ├── standing/ # Standings
│ │ │ │ └── welcome/ # Authentication
│ │ │ └── util/ # Utilities
│ │ ├── res/ # Resources
│ │ └── AndroidManifest.xml
│ ├── test/ # Unit Tests
│ └── androidTest/ # Instrumentation Tests
├── functions/ # Firebase Cloud Functions
│ ├── f1_logic.js
│ ├── junior_categories_logic.js
│ └── index.js
└── build.gradle.kts

Design Patterns
  • MVVM (Model-View-ViewModel) - UI layer architecture
  • Repository Pattern - Data access abstraction
  • Singleton Pattern - Service locator and database instances
  • Observer Pattern - LiveData for reactive UI updates
  • Factory Pattern - ViewModel creation
Tech Stack
Core
  • Language: Java 11
  • Min SDK: 26 (Android 8.0)
  • Target SDK: 34 (Android 14)
  • Compile SDK: 36
Libraries & Frameworks
UI & Navigation
  • AndroidX AppCompat 1.7.1
  • Material Design Components 1.13.0
  • Navigation Component 2.9.6
  • ConstraintLayout 2.2.1
  • SwipeRefreshLayout 1.1.0
Networking
  • Retrofit 3.0.0
  • OkHttp Logging Interceptor 5.3.2
  • Gson 2.13.2
Database
  • Room 2.8.4
Firebase
  • Firebase BOM 34.6.0
  • Firebase Authentication 24.0.1
  • Firebase Realtime Database 22.0.1
  • Firebase Firestore 26.0.2
  • Firebase Analytics
  • Google Play Services Auth 21.4.0
Image Loading
  • Glide 5.0.5
Utilities
  • Lombok 1.18.42 (Annotation Processing)
  • ThreeTenBP 1.7.2 (Date/Time)
  • Rome 2.1.0 (RSS Feed Parsing)
  • Commons Validator 1.10.1
Testing
  • JUnit 4.13.2
  • AndroidX Test 1.3.0
  • Espresso 3.7.0
🔌 APIs & Data Sources
F1 Data API
Firebase Services
  • Authentication - User sign-in/sign-up
  • Realtime Database - User preferences and app data
  • Cloud Functions - Scheduled data updates
News Sources
  • Autosport - English F1 news
  • Crash.net - English F1 coverage
  • Motorsport - Italian F1 news
🛠️ Development
Build Variants
buildTypes {
release {
isMinifyEnabled =false
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
}
Running Tests
# Unit Tests
./gradlew test# Instrumentation Tests
./gradlew connectedAndroidTest
# Generate Coverage Report
./gradlew jacocoTestReport
Code Style
This project follows standard Android coding conventions:
  • Package naming: lowercase
  • Class naming: PascalCase
  • Method/variable naming: camelCase
  • Constants: UPPER_SNAKE_CASE
  • 4-space indentation
Lombok Usage
The project uses Lombok for reducing boilerplate code:
  • @Getter / @Setter - Automatic getters/setters
  • @NoArgsConstructor / @AllArgsConstructor - Constructor generation
  • @ToString - toString() method generation
  • @EqualsAndHashCode - equals() and hashCode() methods
📋 TODO & Roadmap
Check out our TODO.md for a comprehensive list of planned improvements and features.
🏎️ Next Up: Live Data Suite
  • Team Radios (Live driver & pit wall audio feed & transcriptions)
  • Live Car Position (Real-time track positioning and driver maps)
  • Live Intervals (Dynamic gaps to leader, gaps ahead, and sector deltas)
  • Live Race Direction Messages (Steward decisions, flags, safety car, penalties)
High Priority
  •  Add comprehensive unit tests
  •  Enable ProGuard for release builds
  •  Implement Firebase Crashlytics
  •  Migrate to Kotlin (incremental)
  •  Add dependency injection (Hilt)
Future Features
  •  Push notifications for race updates
  •  Home screen widgets
  •  Offline mode enhancement
  •  Social features (predictions, discussions)
  •  Wear OS support
🤝 Contributing
We welcome contributions! Here's how you can help:
  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request
Contribution Guidelines
  • Follow existing code style and conventions
  • Add unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR
  • Write clear commit messages
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact & Support
Team Members
Project Links
🙏 Acknowledgments
  • Jolpi.ca for providing the F1 Ergast API
  • Firebase for backend services
  • Material Design for UI components
  • Glide for efficient image loading
  • All open-source libraries that made this project possible
📊 Project Stats
  • Language: Java
  • Lines of Code: ~10,000+
  • Activities: 15+
  • Fragments: 10+
  • API Integrations: 3+
  • Supported Languages: 2 (EN, IT)
Made with ☕ by The Coffee Coders
⭐ Star this repo if you find it useful!
Report Bug • Request Feature
About
Fastest Lap aims to show real-time information about Formula 1 sessions. At the moment, those information are only available on the official app upon payment of a monthly fee. Our goal is to make those information free of charge.
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages