GitHub - colivingapp/coliving-app: Coliving App - Experience the Coliving Revolution

🌐 About

Coliving App is an open-source, community-driven platform dedicated to transforming shared living experiences. It empowers users to create, manage, and explore coliving spaces with built-in social and communication features.

LIVE: https://coliving.app

🚀 Project Status

Coliving App is in Community Development phase. The core functionality is stable, while new features are being explored through community contribution. The maintainer reviews PRs on a bi-weekly basis.

Feedback, ideas, and feature proposals are welcome in 👉 GitHub Discussions.

🛠️ Local Setup

Clone the repository and install dependencies:

git clone https://github.com/colivingapp/coliving-app.git
cd coliving-app
composer install
npm install

Create a virtual host (e.g. http://ca.local) pointing to the Laravel project's /public directory.

Copy .env.example to .env, and set at least the following:

APP_URL=http://ca.local
DB_DATABASE=your_database_name

In vite.config.js, update the server.origin to match your local URL:
```
server: {
   origin: 'http://ca.local'
}
```

Run setup commands:

php artisan migrate
php artisan key:generate
php artisan storage:link
npm run watch

Visit http://ca.local in your browser and sign up with your desired email. The first user is auto-verified and becomes the owner of the example coliving space. Configure your email server credentials in .env to enable full functionality.

🤝 Contributing

We welcome contributions that help improve the Coliving App — whether it's fixing bugs, refining features, or developing new tools for the coliving community.

For more info, check our Contributing Guidelines.

📋 Development Roadmap

Our mission is to make it easy for anyone to create, join, and thrive in coliving communities around the world.

Tools for Coliving Mates & Spaces

Helps people set up, promote and coordinate coliving spaces:

Instant Spaces – launch a coliving space, even before renting an apartment.
Templates – configure rent, dates, house rules, deposits easily.
Promotion Tools – tools to help you launch, promote, and fill your space.
Invite System – add people to your space via links or QR codes.
Roles – assign roles like Organizer, Finance Manager, Chore Lead.
Expense Estimator – per-person calculation of rent, utilities, and deposits.
Admin Tools – space management, and host-specific tools.

Daily life organization tools (Hub):

Voting – propose and decide on house rules, events, expenses, or new member applications.
Chat – real-time group messaging, pinned items, updates, and shared files.
Agenda – shared calendar for events, tasks, cleaning schedules, or dinners.
Chore Management – task assigning, reminders, and completion tracking.
Pulse Check – lightweight weekly mood tracker for emotional well-being.
Expense Sharing – track ongoing shared expenses (e.g. rent, groceries).

Global Coliving Community

Gamified social engagement and community-building:

Achievements – unlock badges for contributions, hosting, and community participation.
Leaderboards – highlight top mates and spaces based on engagement, reviews, and profile completeness.
CoMatch Score – compatibility score for finding like-minded housemates and communities.
Social Sparks – lightweight prompts and activities designed to spark new conversations and deeper friendships.
Social Discovery – connect with people through shared bookmarks, interests, locations, and travel plans.
Global Coliving Ratings – rate cities, neighborhoods, and countries for coliving quality.
Coliving Profile – build a trusted profile showcasing stays across spaces and positive community reputation.
Discussion Forum - open discussions around coliving tips, travel advice, lifestyle topics, and community ideas.

Global exploration and discovery tools:

Coliving Explorer – browse community members and spaces worldwide through an interactive map.
Coliving Travel Planner – organize group trips, local meetups, and coliving journeys.
Coliving Circles – form small trusted groups with mates and travelers for easier reconnection across cities.
Local Events – discover open dinners, workshops, and social gatherings hosted by nearby coliving spaces.
Feedback & Reviews – transparent reviews for spaces, hosts, and housemates.
Safety Tools – emergency alerts, safety ratings, and community-driven reporting systems.
Space Discovery Feed – dynamic feed of newly launched spaces, trending communities, and open spots for travelers.

📚 Documentation

🏘️ Join the Movement

Coliving App is more than just software — it’s a growing experiment in how we live, share, build, and connect. Whether you’re a developer, a digital nomad, or just someone passionate about coliving, your energy and ideas are welcome.