[!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

[!NOTE] Due to a new - rewritten, refocused - version of ElectricSQL, we had to revert to basic API calls everywhere. We are now exploring ways to quickly get local-first back into cella.

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.

Fork & build your app! (EXPERIMENTAL)

Want to use cella to build your next web app? Click the fork button. Then follow these steps in your project:

1git remote add upstream git@github.com:cellajs/cella.git
2git fetch upstream
3git merge upstream/main

Then run your app:

1pnpm install && pnpm quick

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 simply want to try cella or participate in development:

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

A. Quick setup

1pnpm install && pnpm quick

B. Full setup

Or, for a full setup - with Postgres instead of pglite - you need Docker. Install Orbstack or Docker.

1pnpm install
2pnpm docker

Start all servers:

1pnpm dev

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

1pnpm seed

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

💙💛 Big thank you to drizzle, hono, tanstack-router & electric.