Trustroots.org

Hospitality exchange community for hitchhikers and other travellers.

Volunteering

• You don't have the be a programmer to participate. Check volunteers page for more info.

Development

Check development page to get started.

Installing

We have two major ways of running the software: trough Vagrant box (less work but runs slower) or by installing locally (more work but runs faster).

See troubleshooting if you encounter errors.

Vagrant

The easiest and quickest way to get started is with Vagrant. See INSTALL-VAGRANT.md for further details. Running through Vagrant can be a little bit slower, but it's a very quick and easy way to get started. Depending on the specifics of your own development setup, you might prefer to run the code locally if you're going to do a lot of development.

Installing locally

Install the stack on your localhost and run NodeJS. This approach takes a little more time to setup, and bit more manual configuration, but is super fast, and can be easier to work with. All the code runs in your usual development environment, so it might be easier to use the tools you're familiar with in this setup. See INSTALL.md for details.

Mock data

There's a script that can generate mock user data. It's highly recommended you run this script after installation, that way you'll have something to look at.

1. Make sure the collections offers and users are empty, in order to avoid duplicate values. This is the default on a new install.
2. Run node scripts/fillTestData.js 1000 username or if you use vagrant box, run: vagrant ssh -c "node /srv/trustroots/scripts/fillTestData.js 1000 username". That will create 1000 users and hosting offers. Username is optional (a-z0-9) and will create a user with that username as an admin.
3. It can take up to 5 minutes. Mongoose might complain about duplicates - just ignore these errors.
4. To see the result, log in with your chosen username and password password.

License

The MIT License