Cella

Single stack TypeScript template to build web apps with sync & offline capabilities.

Website · Prerelease · MIT license

Caution

This is a prerelease. It does NOT meet production requirements yet and large breaking changes occur regularly. Versioned releases will begin once we have solid tests for authentication, authorization and data access. Want to contribute or discuss cella with us? Let's connect! ✉️ [email protected]

Contents

• Installation
• Architecture
• Roadmap
• Deployment

Requirements

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

Create your own app

Want to try cella to build your new web app? We made it simple with a create CLI. Simply follow the steps to get started:

pnpm create @cellajs/cella@latest

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

 

Installation

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

git clone [email protected]: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 electric-sync.

pnpm install && pnpm quick

B. Full setup

For a full setup with sync capabilities, you need Docker. It will allow you to run Postgres + electric-sync. Install Orbstack or Docker.

pnpm install
pnpm docker

Start all servers:

pnpm dev

Lastly, seed your db (with dev running) to sign in as admin user.

pnpm seed

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 & electric.