Track the upcoming and recent games of the Miami Marlins and their minor league affiliates in a clean, responsive interface.
- Affiliate-based filtering
- Game status grouping (Scheduled, In Progress, Final)
- Mobile-first responsive UI
- PWA support
- Multilanguage for English and Spanish
Before you begin, ensure you have the following installed:
| Tool | Version | Download |
|---|---|---|
| Node.js | v24.0.0 |
Download Node.js |
| pnpm | v10.14.0 |
Install pnpm |
-
Open a terminal in your computer
-
Clone the repository
git clone https://github.com/jorgejimenez98/marlins-affiliates-tracker.git
-
Navigate to the project folder
cd marlins-affiliates-tracker -
⚙️ Set up the Environment Variables
Copy the.env.examplefile and rename it to.env. Then fill in any required values:cp .env.example .env
-
Install dependencies
pnpm install
-
Start the development server
pnpm dev
-
Open your browser
Navigate to http://localhost:5173 to view the application.
This application can be installed as a Progressive Web App (PWA) for a native app-like experience:
-
Desktop (Chrome/Edge):
- Click the install icon in the address bar
- Or go to Settings → Install App
-
Mobile (iOS Safari):
- Tap the Share button
- Select "Add to Home Screen"
-
Mobile (Android Chrome):
- Tap the menu (three dots)
- Select "Add to Home Screen"
Once installed, you can access the app directly from your home screen
If you're testing the application and the selected date doesn't have games in all states (Scheduled, In Progress, Final), you can enable mock data:
-
Set the environment variable in your
.envfile:VITE_MOCK_DATA_ENABLED=true
-
Restart the development server:
pnpm dev
This will populate the interface with sample games in different states, allowing you to see all features in action.
| Desktop | Mobile |
|---|---|
| VS MLB Real Time Data (Marlins VS New York Yankees (Sun 08-03-2025) ) |
|---|
| Lighthouse (Can be improved) |
|---|