{"id":27404474,"url":"https://github.com/woodrock/bus-timetable","last_synced_at":"2026-04-25T23:38:03.478Z","repository":{"id":287679414,"uuid":"965476793","full_name":"woodRock/bus-timetable","owner":"woodRock","description":"A deno fresh web application for Wellington bus timetables using the Metlink API","archived":false,"fork":false,"pushed_at":"2025-04-13T08:57:28.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-13T09:41:11.936Z","etag":null,"topics":["deno","fresh","metlink-api","typescript"],"latest_commit_sha":null,"homepage":"https://bus-timetable.deno.dev/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/woodRock.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-13T08:52:18.000Z","updated_at":"2025-04-13T09:11:06.000Z","dependencies_parsed_at":"2025-04-13T09:41:43.834Z","dependency_job_id":"573c1bf6-948e-4b16-bffb-dd15fafb3e38","html_url":"https://github.com/woodRock/bus-timetable","commit_stats":null,"previous_names":["woodrock/bus-timetable"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodRock%2Fbus-timetable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodRock%2Fbus-timetable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodRock%2Fbus-timetable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodRock%2Fbus-timetable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/woodRock","download_url":"https://codeload.github.com/woodRock/bus-timetable/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248826395,"owners_count":21167680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deno","fresh","metlink-api","typescript"],"created_at":"2025-04-14T05:29:55.415Z","updated_at":"2026-04-25T23:38:03.450Z","avatar_url":"https://github.com/woodRock.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wellington Bus Timetable App\n\n[![Made with Fresh](https://fresh.deno.dev/fresh-badge.svg)](https://fresh.deno.dev)\n\nA Deno Fresh application that displays real-time bus timetables and service alerts for Wellington, New Zealand, using the Metlink API.\n\n## Features\n\n- Real-time bus departures by stop and service ID\n- Service alerts for buses, trains, and ferries\n- Filter alerts by transport mode\n- Auto-refreshing departure board\n- Mobile-responsive design with Tailwind CSS\n- Accessibility information for departures\n\n## Prerequisites\n\n- [Deno](https://deno.land/) v1.36.0 or higher\n- A Metlink API key (obtain from [Metlink Developer Portal](https://opendata.metlink.org.nz/))\n\n## Setup\n\n1. Clone this repository:\n   ```\n   git clone \u003crepository-url\u003e\n   cd wellington-bus-timetable\n   ```\n\n2. Create a `.env` file in the project root:\n   ```\n   METLINK_API_KEY=your_metlink_api_key_here\n   ```\n\n3. Start the development server:\n   ```\n   deno task start\n   ```\n\n4. Open your browser and navigate to [http://localhost:8000](http://localhost:8000)\n\n## Project Structure\n\n```\n├── .env                    # Environment variables (create this file)\n├── deno.json               # Deno configuration\n├── components/             # Reusable UI components\n│   ├── DepartureRow.tsx    # Single departure row component\n│   └── Navigation.tsx      # Navigation bar component\n├── islands/                # Interactive components (client-side hydrated)\n│   ├── BusStopMap.tsx      # Map of the bus stops for reference\n│   ├── DepartureBoard.tsx  # Real-time departure board \n│   └── ServiceAlerts.tsx   # Service alerts with filtering\n├── routes/                 # Application routes\n│   ├── index.tsx           # Homepage with search form\n│   ├── service-alerts.tsx  # Service alerts page\n│   ├── api/\n│   │   ├── alerts.ts       # API endpoint for service alerts\n│   │   ├── departures.ts   # API endpoint for departures\n│   │   └── stops.ts        # API endpoint for stops\n│   └── departures/\n│       ├── [stop].tsx      # Departure page for specific stop\n│       └── [stop]/\n│           └── [service].tsx # Departure page for specific stop/service\n└── utils/                  # Utility functions\n    ├── env.ts              # Environment utilities\n    └── metlink.ts          # Metlink API utilities\n```\n\n## Pages\n\n### Home Page\n- Search form for departures by stop ID and service number\n- Links to service alerts\n\n### Departures Page\n- Real-time departure board with auto-refresh functionality\n- Shows service status, destination, departure time, and accessibility information\n\n### Service Alerts Page\n- Displays current service alerts from Metlink\n- Filter alerts by transport mode (bus, train, ferry)\n- Shows detailed information including alert effect, time period, and images\n\n## API Usage\n\nThis application uses the Metlink API to fetch real-time data. You'll need to obtain an API key from the [Metlink Developer Portal](https://opendata.metlink.org.nz/).\n\nThe app utilizes three main API endpoints:\n- `https://api.opendata.metlink.org.nz/v1/stop-predictions` - For real-time departures\n- `https://api.opendata.metlink.org.nz/v1/gtfs-rt/servicealerts` - For service alerts\n- `https://api.opendata.metlink.org.nz/v1/gtfs/stops` - For stop information\n\n## Customization\n\nYou can customize the Tailwind colors in `tailwind.config.ts` to match your preferred design. The current theme uses Metlink's official colors.\n\n## License\n\n[MIT](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoodrock%2Fbus-timetable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwoodrock%2Fbus-timetable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoodrock%2Fbus-timetable/lists"}