Cella

TypeScript template to build collaborative web apps with sync & offline capabilities. Europe-first.

Website · Prerelease · MIT license

Caution

This is a prerelease. Versioned releases will start once we have enough tests for authentication, authorization and data access. Want to contribute or discuss cella with us? Let's connect! ✉️ info@cellajs.com

Contents

• Agent Guidelines
• Architecture
• Roadmap

Requirements

• Make sure you have node installed with node -v. Install Node 24.x. (ie. Volta).
• Ideally you work with git over ssh.

Create app

Do not fork this repo directly. Use the create CLI to get started:

pnpm create @cellajs/cella

You now have an implementation-ready web app 🤯. But ... without any unique functionality 🤓. Read the Quickstart so you can build something unique quickly.

 

Contribute

For those that (also) want to participate in development:

git clone git@github.com:cellajs/cella.git && cd cella

A. Quick setup

Run your db using a local pglite. Its fast to build and to clean up. Simply remove backend/.db. However, you need to use the full setup to run with the sync engine.

pnpm install && pnpm quick

B. Full setup

For a full setup with sync engine, you need to run postgres + CDC worker. Install Orbstack or Docker.

pnpm install
pnpm docker
pnpm seed

Start all servers:

pnpm dev

Check it out at localhost:3000! Generated API docs can be found at localhost:4000/docs. Manage your local db with local.drizzle.studio.

 

💙💛 Big thank you to drizzle, hono, tanstack-router, react-query