{"id":51083054,"url":"https://github.com/catlabinteractive/fostplus-ical-webserver","last_synced_at":"2026-06-23T20:01:29.300Z","repository":{"id":361829347,"uuid":"1256020810","full_name":"CatLabInteractive/fostplus-ical-webserver","owner":"CatLabInteractive","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-01T12:26:15.000Z","size":37,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-01T13:23:56.667Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/CatLabInteractive.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-01T11:42:20.000Z","updated_at":"2026-06-01T12:26:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/CatLabInteractive/fostplus-ical-webserver","commit_stats":null,"previous_names":["catlabinteractive/fostplus-ical-webserver"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/CatLabInteractive/fostplus-ical-webserver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatLabInteractive%2Ffostplus-ical-webserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatLabInteractive%2Ffostplus-ical-webserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatLabInteractive%2Ffostplus-ical-webserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatLabInteractive%2Ffostplus-ical-webserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CatLabInteractive","download_url":"https://codeload.github.com/CatLabInteractive/fostplus-ical-webserver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatLabInteractive%2Ffostplus-ical-webserver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34704748,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2026-06-23T20:01:23.478Z","updated_at":"2026-06-23T20:01:29.289Z","avatar_url":"https://github.com/CatLabInteractive.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🗑️ fostplus-ical-webserver\n\n[![Node.js](https://img.shields.io/badge/Node.js-18%2B-339933?logo=node.js\u0026logoColor=white)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Express](https://img.shields.io/badge/Express-5-000000?logo=express\u0026logoColor=white)](https://expressjs.com/)\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\n\nA self-hostable Node.js web application that lets Belgian residents look up their home address and generate a **personalised iCal subscription URL** for their [Fostplus](https://www.fostplus.be/) waste-collection schedule.\n\nSubscribe once in Google Calendar, Apple Calendar or Outlook — your collection dates update automatically for the next 12 months. 📅\n\n---\n\n## Screenshots\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eStep 1 — Postal code\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"screenshots/step1-zipcode.png\" width=\"260\" alt=\"Enter postal code\"/\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eStep 2 — Street search\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"screenshots/step2-street.png\" width=\"260\" alt=\"Street search with autocomplete\"/\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eStep 3 — House number\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"screenshots/step3-housenumber.png\" width=\"260\" alt=\"Enter house number\"/\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eStep 4 — Options\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"screenshots/step4-options.png\" width=\"260\" alt=\"Language and display options\"/\u003e\u003c/td\u003e\n    \u003ctd align=\"center\" colspan=\"2\"\u003e\u003cstrong\u003eStep 5 — Your iCal URL\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"screenshots/step5-result.png\" width=\"260\" alt=\"Generated iCal URL ready to copy\"/\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Features\n\n- 🏠 **5-step address wizard** — postal code → street → house number → options → URL\n- 🌍 **Multilingual** — fraction names in Dutch (default), English or French\n- 😀 **Emoji mode** — swap text labels for emojis (🌿 📄 ♻️ 🗑️ …)\n- 📆 **Day grouping** — combine all fractions of the same day into one calendar event\n- 🔗 **Stable, shareable URL** — bookmark or share your personal iCal feed\n- 📅 **12 months of events** — always up to date when your calendar app refreshes\n- 📋 **One-click copy** and direct browser link for easy setup\n- Works with **Google Calendar, Apple Calendar, Outlook** and any iCal-compatible app\n\n---\n\n## Prerequisites\n\n- **Node.js 18+**\n- A **Fostplus API consumer key** (`x-consumer` header value).  \n  This value is publicly used by the Fostplus recycling website. You can find it by inspecting the network requests on [fostplus.be](https://www.fostplus.be/) or from the [`fostplus-api-wrapper`](https://github.com/LeventHAN/fostplus-api-wrapper) project tests.\n\n---\n\n## Quick start\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/CatLabInteractive/fostplus-ical-webserver.git\ncd fostplus-ical-webserver\n\n# 2. Install dependencies\nnpm install\n\n# 3. Create your .env file\ncp .env.example .env\n# Edit .env and set FOSTPLUS_CONSUMER_KEY=\u003cyour key\u003e\n\n# 4. Build and start (production)\nnpm run build\nnpm start\n\n# – or run in development mode (auto-reload)\nnpm run dev\n```\n\nOpen \u003chttp://localhost:3000\u003e in your browser to use the address wizard.\n\n---\n\n## Environment variables\n\n| Variable                | Required | Default | Description                              |\n|-------------------------|----------|---------|------------------------------------------|\n| `FOSTPLUS_CONSUMER_KEY` | ✅ yes   | —       | The `x-consumer` key for the Fostplus API |\n| `PORT`                  | no       | `3000`  | TCP port the server listens on            |\n\n---\n\n## API endpoints\n\n| Method | Path                                      | Description                                         |\n|--------|-------------------------------------------|-----------------------------------------------------|\n| `GET`  | `/`                                       | Address wizard UI                                   |\n| `GET`  | `/api/zipcodes?q=\u003cterm\u003e`                  | Search for postal codes matching `term`             |\n| `GET`  | `/api/streets?q=\u003cterm\u003e\u0026zipcodeId=\u003cid\u003e`    | Search for streets matching `term` in the given zip |\n| `GET`  | `/ical/:zipcodeId/:streetId/:houseNumber` | Download / subscribe to the iCal feed               |\n\n### iCal query parameters\n\n| Parameter | Values           | Default | Description                                           |\n|-----------|------------------|---------|-------------------------------------------------------|\n| `lang`    | `nl`, `en`, `fr` | `nl`    | Language for fraction names (Dutch, English, French)  |\n| `emoji`   | `true`, `false`  | `false` | Replace text labels with emojis (🌿 📄 ♻️ 🗑️ …)     |\n| `group`   | `true`, `false`  | `false` | Group all fractions of the same day into a single event |\n\n### iCal URL examples\n\n```\n# Dutch (default), individual events\nhttp://localhost:3000/ical/zipcode-id-here/street-id-here/42\n\n# English, emoji labels, grouped by day\nhttp://localhost:3000/ical/zipcode-id-here/street-id-here/42?lang=en\u0026emoji=true\u0026group=true\n\n# French, text labels\nhttp://localhost:3000/ical/zipcode-id-here/street-id-here/42?lang=fr\n```\n\n---\n\n## Project structure\n\n```\n.\n├── public/\n│   ├── index.html       # Single-page address wizard\n│   └── robots.txt       # Disallow all search engine indexing\n├── screenshots/         # README screenshots\n├── src/\n│   ├── app.ts           # Express app entry point\n│   └── routes/\n│       ├── api.ts       # /api/zipcodes and /api/streets\n│       └── ical.ts      # /ical/:zipcodeId/:streetId/:houseNumber\n├── .env.example\n├── package.json\n└── tsconfig.json\n```\n\n---\n\n## Contributing\n\nPull requests and issues are welcome! Please open an issue first for significant changes.\n\n---\n\n## License\n\n[ISC](https://opensource.org/licenses/ISC)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatlabinteractive%2Ffostplus-ical-webserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatlabinteractive%2Ffostplus-ical-webserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatlabinteractive%2Ffostplus-ical-webserver/lists"}