📖 Overview

Race Board is a monitoring application designed to visualize and analyze racetrack data. It provides a user-friendly interface to track performance metrics, visualize data trends, and gain insights into racing activities.

✨ Key Features

• ⚡ Real-time Data Visualization: Visualize data in real-time with interactive charts and graphs.
• 📊 Performance Metrics: Track key performance indicators such speed, average speed and lane usage.
• 📈 Data Analysis: Analyze trends and patterns

📋 Prerequisites

• SpeedStream: Race Board uses SpeedStream for data streaming and processing. Ensure you have it set up in your project.

🚀 Getting Started

1. Configure Environment

The application supports three modes:

🎮 SIMULATION Mode (Default)

Perfect for UI development and testing without any API. Generates realistic mock data:

APP_MODE=SIMULATION

Use case: Frontend development, UI testing, demos without backend

🔧 DEV Mode

Connects to your local development API server:

APP_MODE=DEV
API_URL=http://192.168.1.100:3000

Use case: Testing with real API during development

🚀 PROD Mode

Connects to production API server:

APP_MODE=PROD
API_URL=http://your-production-server.com:3000

Use case: Production deployment with live data

2. Install Dependencies

bun install

4. Run the Application

bun run dev

🔗 See Also

• SpeedStream

🧪 Code Quality

Unit Tests available

To run unit tests, use the following command:

bun run test

Linting

To check for linting issues, run:

bun run lint

Format Code

To format the codebase, use:

bun run format

🤝 Contributing

Contributions are welcome! To contribute:

• Fork the Repository
• Create a Feature Branch:

  git checkout -b feature/your-feature-name