Transit TV

A real-time transit display application that shows arrival times for nearby public transit.

Important

This is a rewrite of the original Transit TV application in a more up-to-date stack. If you're looking for my fork of the original project, have a look at the legacy branch of this repo. If you're looking for the original project, have a look over at Transit App's account

Warning

Transit TV was built by the Transit team as a fun project to demo the API, usage of this project comes with no guarantee of any kind. Just as the original Transit TV was built by the Transit team as a fun project, this version of this project comes with no guarantee of any kind. I am not affiliated with Transit, just big fans of their app.

Prerequisites

• An API key from Transit - keys can be requested here

Optional, for local deployment or development only

• Docker (recommended)
• Node.js (version specified in .node-version, for development/local deployment purposes only)
• pnpm (preferred package manager, for development/local deployment purposes only)

Getting started

Go to the Transit API page and request access to the API. When you have the API key, you can place it in your environment .env file or however variables/secrets are managed for your deployment method.

Once you have your API key, see docs/getting-started for more info on how to get started.

Project structure

.
├── docs/                 # Documentation
├── docker-legacy/        # Legacy Docker files for backwards compatibility
├── e2e/                  # end-to-end testing related files
├── server/
│   ├── api/              # API endpoints
│   ├── config/           # Server configuration
│   ├── components/       # Custom server components
│   └── routes.js         # Express routing
├── svelte-app/           # SvelteKit application
│   ├── src/
│   │   ├── routes/       # SvelteKit routes and API endpoints
│   │   ├── lib/          # Components, stores, utilities
│   │   └── app.css       # Global styles
│   ├── static/           # Static assets like images and fonts
│   └── package.json      # SvelteKit dependencies
├── .env.example          # Example environment variables
├── Dockerfile            # Docker build file
├── compose.yaml          # Docker Compose file (production)
└── compose.dev.yaml      # Docker Compose (development)

License

See the LICENSE file for details.

Additional Disclaimers

Note

Generative AI: The code for this project was developed with the help of generative AI tools, including Claude and Claude Code. While all outputs have been lovingly reviewed and tested, users should validate results independently before use in production environments.