cellajs / cella

TypeScript template to build local-first SaaS with hono + pg + drizzle + electric-sql + react + shadcn.
https://cellajs.com
MIT License
272 stars 28 forks source link
drizzle hono openapi postgres react react-query shadcn tanstack-router vite zod zustand

Cella

Single stack TypeScript template to build SaaS 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

Requirements


Create your own app

Want to use cella to build your next web app? We made it simple using a short create CLI:

pnpm create @cellajs/cella@latest

Follow the steps in create CLI and then run your app:

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 want to participate in development:

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

A. Quick setup

pnpm install && pnpm quick

B. Full setup

For a full setup - with Postgres instead of pglite - you need Docker. 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: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.