A community-driven hospitality exchange network
- 🛌 Member profiles with focus on finding a place to stay
- 🔎 Search members by map, location, username
- 👬 Comment system to increase trust between each other
- 📝 Forum and groups for discussions
- 🚣🚴 Activities, galleries to show who you are
- 🔧 Volunteer tools (safety, moderation, spam, rights member welcome tools and more)
- 🌈 On page translation for 305 languages
- 🙋💪 BeWelcome is people and volunteers Learn more
You like the idea? Development is only one way to contribute! Find out how to get active, including as designer, tester, translator, moderator, helping others and much more! 😍
- 🎈 Set up you local development enviroment and fork the repository on Github.
- 🔍 Pick a good starter issue
- ✨ Create a pull request and
@mention
the people from the issue to review - 🌞 Fix the remaining things during review
- 🎉 Wait for it being merged!
You probably want to get started by checking out the code in src/
.
build/
is deprecated and the code needs to be rewritten in src/
.
Documentation is in the doc tree and can be compiled using mkdocs:
$ mkdocs build
The result can then be accessed via doc/html/
in your cloned repository.
PHP API documentation can also be generated using
phpDox. phpDox integrates with numerous
continuous integration tools, so we recommend using the following make
task to
get the full output:
make phpdox
The result can then be accessed via doc/phpdox/
in your cloned repository.
If you see an updated composer.json
or composer.lock
make sure to run
composer install --prefer-dist --no-progress --no-suggest --no-interaction --no-scripts
Also run
yarn install --frozen-lock
everytime you see a change in either package.json
or package-lock.json
.
If any .scss
file or a file in assets/
changed a make build
is necessary.
To ensure coding standards are followed run make
everytime before you commit. Fixing coding standard issues can be achieved with
make phpcsfix
twice in a row.