akash190104/kolkata-bus-route

★ 17HTMLAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((kolkata-bus-route))
    What it does
      Find bus routes
      Show transfers
      Map stops
    Tech stack
      HTML
      JavaScript
      Python build
    Data sources
      Private buses
      Government buses
    Setup
      Open in browser
      Vercel hosting

mindmap root((kolkata-bus-route)) What it does Find bus routes Show transfers Map stops Tech stack HTML JavaScript Python build Data sources Private buses Government buses Setup Open in browser Vercel hosting

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Look up Kolkata bus routes including connections needing one or two transfers, all in one place.

USE CASE 2

Adapt the project for another city by replacing the plain-text route files and running the Python build script to regenerate the JSON dataset.

USE CASE 3

Contribute GPS coordinates for stops to improve the map view for people who know the city.

Tech stack

HTMLJavaScriptPython

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

This project is a static web app for finding bus routes in Kolkata, India. Kolkata has an extensive bus network but route information is not easy to look up in one place. The author collected route data from both private and government bus sources, normalized it with a Python build script, and turned it into a searchable graph that the web app reads. You open the app, type in your starting stop and your destination, and it shows you matching routes. Autocomplete helps with stop names, since Kolkata has a large number of them. The results cover direct bus routes, journeys that require one transfer, and journeys that require two transfers. Each result shows which buses to take, where to change, and how many stops are involved. The app also plots stops on a map for stops that have GPS coordinates. The technical setup is intentionally minimal: it is a single HTML file that runs entirely in the browser with no backend server. The raw route data lives in two plain text files, one for private routes and one for government routes. Running build.py regenerates the JSON dataset the app loads. If you want to run it locally you can open the HTML file directly in a browser, or start a one-line Python HTTP server. The live version is hosted on Vercel as a static project. Visitor analytics are included via Vercel Web Analytics. Route corrections, stop-name fixes, and geocoding improvements from people who know the city are welcome as contributions to the source data files.

Copy-paste prompts

Prompt 1

I want to add GPS coordinates for a bus stop in the kolkata-bus-route project so it appears on the map. Which file do I edit and what format does the coordinate data need to be in?

Prompt 2

I want to adapt kolkata-bus-route for a different city. How should I format the plain-text route files so build.py converts them into the correct JSON dataset?

Prompt 3

The kolkata-bus-route app finds paths with up to two transfers using a graph search in the browser. Help me understand how to extend it to also show the estimated number of stops for each leg of a journey.

Prompt 4

I want to host my own version of kolkata-bus-route on Vercel as a static site. Walk me through deploying a single-HTML-file project so the app loads route data correctly in production.

Open on GitHub → Explain another repo

← akash190104 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.