/couchers

The next-generation couch surfing platform. Free forever. Community‑led. Non‑profit. Modern. Chuck us a star :)

Primary LanguageTypeScriptMIT LicenseMIT

Couchers.org

pipeline status coverage report

Join us as we build the new alternative to Couchsurfing™

Free forever. Community‑led. Non‑profit. Modern.

Read more about us at Couchers.org.

The code in this repository is licensed under the MIT license.

How to contribute

If you found an issue with the app, or have a suggestion/feature you'd like to raise, please add it to the Issues (in the issues tab on GitHub). A developer will come and triage the issue and add it to the backlog.

If you are a frontend developer, we have an up to date Quick Start at app/web/readme.md.

If you are a backend or full stack developer, there is a Quick Start at app/backend/readme.md.

Overview of documentation

  • Getting started with dev: app/readme.md outlines basic steps to get a dev environment set up, start here!
  • Architectural overview: docs/architecture.md outlines the basic workings of the app, the different components, and the way they interact.
  • Developer Contributor Guide: docs/contributing.md explains how we work with this codebase and helps you get up and running with development.
  • CI/CD goodies: docs/cicd.md lists the different CI/CD functionality that we've got set up and how you can use this to simplify life
  • Database & migrations: docs/database.md explains how to use the database and how we version the database with Alembic and update it when new tables or columns are added
  • Docker: docs/docker.md has some tips on how to work with docker and be less miserable

Translations

Help translate Couchers.org.

translation status

Note on intellectual property

The source code for the Couchers.org project is licensed under the MIT license (doesn't include things like long-form Couchers blog posts or essays), allowing anybody to use and redistribute the code with few restrictions. However, Couchers, Inc. owns, holds exclusive copyrights to, or owns trademarks for, other intellectual property, including the logos, colour schemes, designs, and texts that appear on the platform. If you wish to reuse parts of the project, you must make sure to remove this intellectual property (including by rebranding the app) to reduce confusion and uphold the brand of Couchers.org.