Open Source · GPL-3.0

Share more. Own less.
Help each other.

NeighbourGood connects neighbours to share tools, skills, and resources. When a crisis hits, the same network becomes a lifeline.

$ git clone https://github.com/neighbourgood/neighbourgood.git $ cd neighbourgood $ cp .env.example .env $ echo "NG_SECRET_KEY=$(openssl rand -hex 32)" >> .env $ docker compose up --build
Frontend
localhost:3800
API
localhost:8300
Docs
localhost:8300/docs

Built for communities, ready for anything

From everyday resource sharing to emergency coordination — one platform that adapts when it matters most.

Everyday — Blue Sky Mode

Share Resources

Lend and borrow tools, vehicles, equipment, and more within your neighbourhood. Calendar-based booking with request and approval keeps everything organised.

Exchange Skills

Offer your expertise and learn from neighbours — from cooking to carpentry. Ten skill categories with a reputation system you can trust.

Community Timeline

Stay in the loop with activity feeds, events, and neighbourhood updates. Invite-based access with code system keeps your community intentional.

Crisis — Red Sky Mode

Crisis Ready

When disaster strikes, switch to emergency mode for rapid community coordination. Low-bandwidth UI adapts automatically for degraded networks.

Offline Mesh Networking

Bluetooth Low Energy mesh relays critical messages up to 7 hops (~700m) with no internet required. Crisis tickets broadcast device-to-device.

Self-Hosted

Run it on your own server. Raspberry Pi to cloud. Your community's data stays in your community. Federate with other instances.

Multi-language (7 langs, RTL) Telegram Bot Webhooks (HMAC-SHA256) Full PWA Neighbourhood Leaders Emergency Ticketing Reputation System Instance Federation

Communities around the world

NeighbourGood adapts to the needs of real communities in real situations.

Hatay, Türkiye

Post-Earthquake Coordination

After the earthquake, mobile networks are unreliable. A neighbourhood switches to Red Sky Mode. Emergency pings ripple through the Bluetooth mesh: a family needs insulin. Three hops away, a pharmacist marks an offer ticket. The neighbourhood leader coordinates a walking route to deliver it. No internet required.

Red Sky
Berlin Kreuzberg, Germany

Everyday Neighbourhood Sharing

In a Kreuzberg Kiez, 140 neighbours share a NeighbourGood instance. Someone books the communal cargo bike for Saturday via the calendar. A retired carpenter offers woodworking lessons every Tuesday. A Syrian family browses the instance in Arabic (RTL). The carpenter is Trust Level 4 — vouched for by dozens of neighbours over two years.

Blue Sky
Kerala, India

Monsoon Flood Response

August floods cut power and mobile data across several panchayats. Federated NeighbourGood instances share emergency tickets across neighbourhood boundaries. Offer tickets for boats and dry food flow between instances. The low-bandwidth UI works on 2G connections. A Telegram bot relays critical pings to phones with SMS connectivity.

Red Sky
Rocinha, Rio de Janeiro, Brazil

Community Resilience

In Rocinha, a community runs NeighbourGood on a Raspberry Pi at a community centre. Fifty families share childcare, tools, and bulk food purchases. The invite code system keeps the instance within the community. When heavy rains trigger landslide risk, the instance switches to Red Sky. The mesh network bridges the steep hillside terrain where cell coverage is spotty.

Blue Sky Red Sky
SvelteKit FastAPI PostgreSQL / SQLite Docker Compose BLE Mesh

Self-host on any machine with Docker. Raspberry Pi to cloud server. Your data stays with your community.

Up and running in 60 seconds

All you need is Docker and Docker Compose.

# Clone the repository $ git clone https://github.com/neighbourgood/neighbourgood.git $ cd neighbourgood # Configure environment $ cp .env.example .env $ echo "NG_SECRET_KEY=$(openssl rand -hex 32)" >> .env # Launch $ docker compose up --build

Requires Docker and Docker Compose. See the full documentation for production deployment, HTTPS setup, and federation configuration.

What you get

Frontend :3800
Backend API :8300
API Docs :8300/docs