Cella

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

Website · Prerelease · MIT license

Caution

Please be aware this is a prerelease. It does NOT meet production requirements yet and large breaking changes still occur regularly. An alpha version will be released once we have solid tests for at least authentication & authorization. Want to contribute or discuss cella for one of your projects? Let's connect! ✉️ info@cellajs.com

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 using a short 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 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 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.