This small application lets members of a shared flat manage their shared flat related informations, contracts, house rules, cleaning rota, events etc. (at least that is the plan ;) )
These instructions will get a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
To start developing you need to have docker and docker-compose installed on your machine
After cloning this repository run:
make setup
To start/stop/restart the app run:
make start
make stop
make restart
The URL is http://localhost:3000
and the initial login credentials are
User: admin@example.org
Password: password
Important (especially in a productive environment): You should CHANGE User and Password to your own user mail and password in the user settings - immediately after first login!!!
To run the whole test suite:
make
For a deploying the application to Heroku please follow this guide this guide.
In order to ensure that your linux server has the required libraries and docker setup follow the following steps.
- Update the
ansible/hosts
with your ssh credentials cd
into ansible folder- Run
make setup
and ansible will take over and install all the requirements in oder to run the application. It will also download the application onto the server from github. - Once this is complete, ssh onto the server and run
make deploy
In order to deploy the application on a linux server, initial steps would require one to setup docker and docker compose. After cloning the project to the server you can and then run make deploy
and the application should start up
This project is a work of and maintained by
- Carsten Behnert
- Cameron Norman (co-maintainer)
- ...
I'm still looking for some other contributors to get in touch with for knowledge excange. If YOU like to, feel free to fork this project and send a pull request. :)
If you like to contribute to the project - which I appreciate, please read the guidelines in CONTRIBUTING.md. Please respect the Code of Conduct.
This project is licensed under the MIT License - see the LICENSE.md file for details