mirror of https://github.com/colibri-social/colibri.social.git synced 2026-04-02 23:17:25 +02:00

No description

TypeScript 88.9%
Astro 8.5%
CSS 2.4%
Dockerfile 0.2%

Find a file

Louis Escher ec2fb2672a Update Dockerfile		2026-03-30 16:27:34 +02:00
.github	fix: rename to Colibri	2026-03-27 18:57:38 +01:00
.vscode	Initial commit from Astro	2026-02-15 19:36:59 +01:00
public	fix: Greatly improve emoji picker performance by using a font instead of	2026-03-28 17:50:22 +01:00
redis	feat: Store user data in Redis, reorder communities	2026-03-05 22:35:19 +01:00
scripts	feat: Community settings & deletions	2026-03-02 12:58:34 +01:00
src	Merge branch 'main' into feat/sentry	2026-03-29 16:57:43 +02:00
.dockerignore	fix: Docker adjustments, base64-encoded secrets	2026-03-05 22:49:41 +01:00
.env.example	feat: Add Sentry	2026-03-29 15:05:15 +02:00
.gitignore	feat: Add Sentry	2026-03-29 15:05:15 +02:00
astro.config.ts	Update astro.config.ts	2026-03-30 16:26:05 +02:00
bearnie.json	feat: Setup & auth prep	2026-02-16 02:27:46 +01:00
biome.json	feat: Attachments	2026-03-08 08:59:26 +01:00
docker-compose.dev.yml	fix: Docker adjustments, base64-encoded secrets	2026-03-05 22:49:41 +01:00
docker-compose.yml	fix: Make sure sentry ENVs are passed in correctly	2026-03-30 16:16:32 +02:00
Dockerfile	Update Dockerfile	2026-03-30 16:27:34 +02:00
LICENSE	feat: Alpha	2026-03-26 17:33:40 +01:00
package.json	feat: Add Sentry	2026-03-29 15:05:15 +02:00
pnpm-lock.yaml	feat: Add Sentry	2026-03-29 15:05:15 +02:00
pnpm-workspace.yaml	feat: Implement functionality for community, category, channel, and	2026-02-16 15:24:12 +01:00
README.md	Update README.md	2026-03-27 00:31:06 +01:00
tsconfig.json	feat: Attachments	2026-03-08 08:59:26 +01:00

README.md

Warning

Colibri is currently in alpha. The current codebase is not really made to scale all that well. We've planned a refactor, which you can read about here.

Colibri

Colibri is an open source chat platform built on the AT protocol for communities big and small. It gives you the ability to create communities, manage members, and communicate through text, voice, and forum channels, all while maintaining true ownership of your data.

Visit us at colibri.social

What is Colibri?

You can learn more about Colibri on our about page.

Local Development

Prerequisites

Node.js 24.13.0 or higher
pnpm 10.29.3 or higher
Redis server (for session management)
Docker and Docker Compose (optional, for containerized deployment)

Getting Started

Clone the repository:

git clone https://github.com/colibri-social/colibri.social.git
cd colibri.social

Install dependencies:

pnpm install

Set up environment variables by creating a .env file:

# Server-only secrets
PRIVATE_KEY_1=your_private_key_1
PRIVATE_KEY_2=your_private_key_2
INVITE_API_KEY=your_invite_api_key
LIVEKIT_API_KEY=your_livekit_api_key
LIVEKIT_API_SECRET=your_livekit_api_secret
REDIS_PASSWORD=your_redis_password
REDIS_URL=redis://optional_url

# Client-public variables
APPVIEW_DOMAIN=your_appview_domain
LIVEKIT_SERVER_URL=wss://livekit.colibri.social

# Optional
SAME_TLD_DID=optional_did

Note: PRIVATE_KEY_1 and PRIVATE_KEY_2 must be Base-64 encoded private keys compatible with atproto's libraries.

Start the development server:

pnpm dev

The application will be available at http://localhost:4321.

You'll need a local redis instance running alongside the dev server. For this, you can use the docker-compose.dev.yml file.

pnpm docker:dev

Building for Production

pnpm build
pnpm start # You need to provide environment variables here for this to work correctly