\n
![\"GTFS-to-HTML\"](\"www/static/img/gtfs-to-html-logo.svg\"){kind=logo}
\n \n
![](\"https://img.shields.io/npm/v/gtfs-to-html.svg?style=flat\")
\n ![](\"https://img.shields.io/npm/dm/gtfs-to-html.svg?style=flat\")
\n ![](\"https://img.shields.io/badge/License-MIT-yellow.svg\"){kind=icon}
\n \n Create human-readable, user-friendly transit timetables in HTML, PDF or CSV format directly from GTFS.\n
\n
![\"NPM\"](\"https://nodei.co/npm/gtfs-to-html.png?downloads=true\")
\n\n ➡️\n Documentation |\n Quick Start |\n Configuration |\n Questions and Support\n ⬅️\n
\n \n
\n \n \n \n
\n Create human-readable, user-friendly transit timetables in HTML, PDF or CSV format directly from GTFS.\n
\n \n
![](\"https://user-images.githubusercontent.com/96217/28296063-aed45568-6b1a-11e7-9794-94b3d915d668.png\")
\n\n## Features\n\n### Configurable and customizable\n\n`gtfs-to-html` has many options that configure how timetables are presented. It also allows using a completely custom template which makes it easy to build chunks of HTML that will fit perfectly into any website using any HTML structure and classes that you'd like. Or, create printable PDF versions or CSV exports of timetables using the `outputFormat` config option.\n\n### Accessibility for all\n\n`gtfs-to-html` properly formats timetables to ensure they are screen-reader accessible and WCAG 2.0 compliant.\n\n### Mobile responsiveness built in\n\nBuilt-in styling makes `gtfs-to-html` timetables ready to size and scroll easily on mobile phones and tablets.\n\n### Schedule changes? A cinch.\n\nBy generating future timetables and including dates in table metadata, your timetables can appear in advance of a schedule change, and you can validate that your new timetables and GTFS are correct.\n\n### Auto-generated maps\n\n`gtfs-to-html` can also generate a map for each route that can be included with the schedule page. The map shows all stops for the route and lists all routes that serve each stop. Maps can also show realtime vehicle locations and predicted arrival times from GTFS-realtime data.\n\nNote: If you only want maps of GTFS data, use the [gtfs-to-geojson](https://github.com/blinktaginc/gtfs-to-geojson) package instead and skip making timetables entirely. If offers many different formats of GeoJSON for routes and stops.\n\n`gtfs-to-html` uses the [`node-gtfs`](https://github.com/blinktaginc/node-gtfs) library to handle importing and querying GTFS data.\n\n## GTFS-to-HTML on the web\n\nYou can now use `gtfs-to-html` without actually downloading any code or doing any configuration. [run.gtfstohtml.com](https://run.gtfstohtml.com) provides a web based interface for finding GTFS feeds for agencies, setting configuration and then generates a previewable and downloadable set of timetables.\n\n## Current Usage\n\nMany transit agencies use `gtfs-to-html` to generate the schedule pages used on their websites, including:\n\n| Agency | Location |\n| -------------------------------------------------------------------- | ----------------------------------- |\n| [Asheville Rides Transit (ART)](https://www.ridetheart.com) | Asheville, North Carolina |\n| [Bayway Transit](https://www.baywaytransit.org) | Panama City, Florida |\n| [Brockton Area Transit Authority](https://ridebat.com) | Brockton, Massachusetts |\n| [Capital Transit](https://juneaucapitaltransit.org) | Juneau, Alaska |\n| [Cascades East Transit](https://cascadeseasttransit.com) | Bend, Oregon |\n| [Central Transit](https://centraltransit.org) | Ellensburg, Washington |\n| [Commute.org](https://commute.org) | San Mateo County, California |\n| [County Connection](https://countyconnection.com) | Contra Costa County, California |\n| [Fairfax Connector](https://www.fairfaxcounty.gov/connector/) | Fairfax County, Virginia |\n| [Jefferson Parish Transit](https://jptransit.org) | Jefferson Parish, Louisiana |\n| [Kings Area Rural Transit (KART)](https://www.kartbus.org) | Kings County, California |\n| [Madera County Connection](https://mcctransit.com) | Madera County, California |\n| [Marin Transit](https://marintransit.gov) | Marin County, California |\n| [Mountain Transit](https://mountaintransit.org) | Big Bear Valley, California |\n| [Mountain View Community Shuttle](https://mvcommunityshuttle.com) | Mountain View, California |\n| [MVgo](https://mvgo.org) | Mountain View, California |\n| [Petaluma Transit](https://transit.cityofpetaluma.net) | Petaluma, California |\n| [Placer County Transit](https://placercountytransit.com) | Placer County, California |\n| [rabbittransit](https://www.rabbittransit.org) | York and Adams County, Pennsylvania |\n| [River Valley Transit](https://rivervalleytransit.com) | Middletown, Connecticut |\n| [Rogue Valley Transportation District](https://rvtd.org) | Medford, Oregon |\n| [Santa Barbara Metropolitan Transit District](https://sbmtd.gov) | Santa Barbara, California |\n| [Santa Cruz METRO](https://scmetro.org) | Santa Cruz, California |\n| [Skamania County Transit](https://gorgetransit.com) | Skamania County, Washington |\n| [Sonoma County Transit](https://sctransit.com) | Sonoma County, California |\n| [South Central Transit](https://southcentraltransit.org) | South Central Illinois |\n| [STAR Transit](https://www.startransit.org) | Balch Springs, Texas |\n| [Sunline Transit Agency](https://www.sunline.org) | Riverside County, California |\n| [Tahoe Transportation District](https://www.tahoetransportation.org) | Lake Tahoe, California |\n| [Transcollines](https://transcollines.ca) | Les Collines-de-l'Outaouais, Quebec |\n\nAre you using `gtfs-to-html`? Let us know via email [gtfs@blinktag.com](mailto:gtfs@blinktag.com) or via opening a github issue or pull request if your agency is using this library.\n\n`gtfs-to-html` is used as an integral part of [`transit-custom-posts`](https://trilliumtransit.github.io/transit-custom-posts/) - a GTFS-optimized Wordpress plugin for transit websites.\n\n\n\n![](\"https://user-images.githubusercontent.com/96217/29205138-dd3ee5c6-7e2f-11e7-9d86-f17cebd5f118.png\")
\n\n## Installation, Configuration and Usage documentation\n\n[See GTFS-to-HTML Documentation](https://gtfstohtml.com)\n\n## Changelog\n\n[See Changelog](https://github.com/blinktaginc/gtfs-to-html/blob/master/CHANGELOG.md)\n\n## Contributing\n\nPull requests are welcome, as well as [feedback and reporting issues](https://github.com/blinktaginc/gtfs-to-html/issues).\n\n### Development Setup\n\n pnpm install\n pnpm run build\n\n`pnpm install` installs dependencies. `pnpm run build` compiles TypeScript and vendors browser-compatible libraries (maplibre-gl, pbf, anchorme, etc.) from devDependencies into `dist/browser` via `scripts/copy-browser-assets.js`. These vendored files are included in the published npm package so consumers don't need to run any postinstall steps.","readmeFilename":"README.md","users":{"slynch1984":true}}