https://github.com/SparksTheFolf/trak.tools
SaaS application that makes MBTA transit data accessible and easy to explore without the complexity of working directly with GTFS APIs.
https://github.com/SparksTheFolf/trak.tools
gtfs gtfs-feed gtfs-realtime open-source
Last synced: 5 days ago
JSON representation
SaaS application that makes MBTA transit data accessible and easy to explore without the complexity of working directly with GTFS APIs.
- Host: GitHub
- URL: https://github.com/SparksTheFolf/trak.tools
- Owner: SparksTheFolf
- Created: 2025-06-16T18:15:23.000Z (about 1 year ago)
- Default Branch: Master
- Last Pushed: 2025-08-13T15:05:31.000Z (11 months ago)
- Last Synced: 2026-02-03T14:51:48.984Z (5 months ago)
- Topics: gtfs, gtfs-feed, gtfs-realtime, open-source
- Language: Vue
- Homepage: https://www.Trak.Tools
- Size: 89.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-transit - Trak.Tools - Alows viewing raw GTFS data on a select scale to further enhance visual data editing and easier viewing. (Producing Data / GTFS)
README
# Trak.tools - GTFS Transit Data Explorer
A Vue 3 + Vite application that makes MBTA transit data accessible and easy to explore without the complexity of working directly with GTFS APIs.
## Features
- **Route Explorer**: Browse all MBTA routes with interactive cards
- **Route Details**: View stops, vehicles, and real-time data for each route
- **JSON Viewer**: Developer-friendly raw data access with syntax highlighting
- **Responsive Design**: Mobile-first Bootstrap 5 interface
- **Real-time Data**: Live vehicle positions and service updates
## Getting Started
### Prerequisites
- Node.js 16+
- npm or yarn
### Installation
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables:
```bash
cp .env.example .env
```
4. Configure your MBTA API key in `.env`:
```
VITE_MBTA_API_KEY=your_api_key_here
```
Get your free API key at: https://api-v3.mbta.com/
### Development
```bash
npm run dev
```
### Build for Production
```bash
npm run build
```
## Environment Variables
- `VITE_APP_ENV`: Set to `DEV` for development, `PROD` for production
- `VITE_MBTA_API_KEY`: Your MBTA API key (optional but recommended for higher rate limits)
- `VITE_MBTA_API_BASE_URL`: MBTA API base URL (defaults to https://api-v3.mbta.com)
## API Usage
The app uses the MBTA V3 API. While an API key is optional, it's recommended to avoid rate limiting:
- Without API key: 20 requests per minute
- With API key: 1000 requests per minute
## Tech Stack
- **Frontend**: Vue 3 with Composition API
- **Build Tool**: Vite
- **UI Framework**: Bootstrap 5
- **HTTP Client**: Axios
- **Routing**: Vue Router
- **Language**: TypeScript
## Project Structure
```
src/
├── components/ # Reusable Vue components
├── pages/ # Page components
├── services/ # API services
├── style.css # Global styles
└── main.ts # App entry point
```
## Contributing
This is an open-source project. Contributions are welcome!
## License
MIT License