{"id":24395156,"url":"https://github.com/randomsearch18/marvellous-mapping-machine","last_synced_at":"2026-04-29T07:31:49.605Z","repository":{"id":263672046,"uuid":"891078374","full_name":"RandomSearch18/marvellous-mapping-machine","owner":"RandomSearch18","description":"A work-in-progress routing engine and web-based navigation app","archived":false,"fork":false,"pushed_at":"2025-03-11T09:51:09.000Z","size":459,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-11T10:41:53.788Z","etag":null,"topics":["openstreetmap","routing-engine"],"latest_commit_sha":null,"homepage":"https://marvellous-mapping-machine.pages.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/RandomSearch18.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}},"created_at":"2024-11-19T17:28:59.000Z","updated_at":"2025-03-04T09:08:41.000Z","dependencies_parsed_at":"2024-11-19T20:33:19.941Z","dependency_job_id":"4b96b6fc-b4df-4408-bfea-ea4be6462013","html_url":"https://github.com/RandomSearch18/marvellous-mapping-machine","commit_stats":null,"previous_names":["randomsearch18/marvellous-mapping-machine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomSearch18%2Fmarvellous-mapping-machine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomSearch18%2Fmarvellous-mapping-machine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomSearch18%2Fmarvellous-mapping-machine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomSearch18%2Fmarvellous-mapping-machine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RandomSearch18","download_url":"https://codeload.github.com/RandomSearch18/marvellous-mapping-machine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243330324,"owners_count":20274039,"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":["openstreetmap","routing-engine"],"created_at":"2025-01-19T20:26:16.840Z","updated_at":"2025-12-28T08:44:23.637Z","avatar_url":"https://github.com/RandomSearch18.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marvellous Mapping Machine\n\n## Try it out\n\n**🧑‍💻 Visit \u003chttps://marvellous-mapping-machine.pages.dev/\u003e to use the app :D**\n\nAlternative domains:\n\n- \u003chttps://mmmm.20240821.xyz/\u003e\n\n## Screenshots\n\n![The Map screen open at Canary Wharf](screenshots/canary-warf.png)\n![Checking an address on the Route screen](screenshots/check-address.png)\n![Part of a route from London Waterloo through London](screenshots/from-waterloo-station.png)\n\n## Development instructions for backend\n\n### Preparation\n\nEnsure you have Python v3.10+ installed.\n\nClone the repository and change directory to the `backend` folder in this repository:\n\n```bash\ncd backend\n```\n\n### Virtual environment\n\nCreate a virtual environment. For example, on a personal computer running Linux, you can create a venv in the project directory:\n\n```bash\npython3 -m venv .venv\n```\n\nIf you're on a school computer, you can't create a venv in your `H:` drive, so create it somewhere on the `C:` drive. E.g. in Git Bash:\n\n```bash\npy -m venv \"$USERPROFILE/venvs/marvellous-mapping-machine\"\n```\n\nOr in Powershell:\n\n```powershell\npy -m venv \"$env:USERPROFILE\\venvs\\marvellous-mapping-machine\"\n```\n\n### Activate the virtual environment\n\nIn VSCode, run the **Python: Select Interpreter** command. If the venv is in the project directory, you can directly select it from the list. If it's elsewhere, manually enter the path to the venv.\n\nAlternatively, activate the venv in the terminal, e.g. in Linux:\n\n```bash\nsource .venv/bin/activate\n```\n\n### Install dependencies\n\n```bash\npython -m pip install -r backend/requirements.txt\n```\n\n### Run the program\n\n```bash\npython backend/main.py\n```\n\n## Development instructions for frontend\n\n### Preparation\n\nEnsure you have Node.JS and Yarn v1 installed.\n\nClone the repository and change directory to the `frontend` folder in this repository:\n\n```bash\ncd frontend\n```\n\n### Install dependencies\n\nRun:\n\n```bash\nyarn\n```\n\n### Start development server\n\nRun\n\n```bash\nyarn dev\n```\n\nAnd access the frontend using the URL displayed in your terminal.\n\n### Quirks\n\nNote that Python code is only updated when the build tool starts (i.e. no live reload), so if you want to edit Python code while previewing the frontend, you should restart the Vite dev server after editing to see your changes.\n\n## AI usage statement\n\n### AI usage for the prototype\n\nDevelopment of this project up to and including the [v0.1.0](https://github.com/RandomSearch18/marvellous-mapping-machine/tree/v0.1.0) tag (i.e. up to and including March 2025) was not assisted by AI in any way.\n\n### AI usage after the prototype\n\nDevelopment of the project after the v0.1.0 tag (i.e. June 2025 onwards) has been assisted by AI in the following ways:\n\n- I use GitHub Copilot's inline completions and edit suggestions for small sections of code (up to a few lines)\n\n## License\n\nCopyright \u0026copy; 2025 RandomSearch (Mish)\n\nMarvellous Mapping Machine is free software: you can redistribute it and/or modify\nit under the terms of the GNU Affero General Public License as published\nby the Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU Affero General Public License for more details.\n\nYou should have received a copy of the GNU Affero General Public License\nalong with this program. If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n![AGPLv3 Free Software logo](https://www.gnu.org/graphics/agplv3-with-text-162x68.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandomsearch18%2Fmarvellous-mapping-machine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frandomsearch18%2Fmarvellous-mapping-machine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandomsearch18%2Fmarvellous-mapping-machine/lists"}