A web application that displays a map with user-contributed hazards for cyclists. Built with the Buffalo framework.
"Schutzstreifen" is German for "protective strip". In legal terminology, it describes the kind of cheap bicycle path that gets painted on the road, often leading to conflicts between drivers and cyclists due to cars parking on or too close next to the strip, close passes on the road, among others. Many of these contraptions are inherently unsafe for cyclists, which has earned them the nickname of "Gefährdungsstreifen" (literally "hazard strip").
This application is not feature ready yet (as in: pre-alpha status):
- Several routes are only implemented in the most basic way possible
- Validation and error handling require work to improve security and user experience
- The frontend is pretty bare-bones right now and needs a lot of love and polish to be presentable
- Every single user has access to all POST endpoints, which is not desirable - there should be an admin user e.g. for managing available hazard types, removing users etc.
When the first alpha is ready, the app will be made available online. You can always download the code and run it on your local machine, of course.
If you are setting up the application for the first time, use the following make target:
make setup
For development, having Go and Go dev tools installed on your machine is extremely helpful.
Instead of also installing Buffalo and PostgresSQL, you can simply run the app with Docker. Otherwise, please refer to the Buffalo documentation on how to run the framework natively.
Use the following make commands to start/stop the containers:
make start
make stop
When all containers are up, the application is available at http://localhost:22080/
To see debug output (logs) during development, use the following start command instead:
make start-dev
With the default start target, containers are started in detached mode. If you prefer running them in the foreground, use the make start-dev target instead.
make test
Use this shortcut to open a shell inside the dev container. You can then use the full Buffalo CLI, including Pop for setting up the database and running migrations:
make cli
This will skip the Docker build cache.
make build-containers
Create CSS files from Sass sources:
make css
Execute all migrations (only works if the database already exists).
make migrate