Chet Stack

A boilerplate, not a framework.

The goal of this repo is to make it easy to start a new full-stack application, complete with all of the bells an whistles expected in a modern web application. This architecture is very similar to the one I built for Notion and is designed so that everything can run in a single process on a single server, while still being easy to scale up by breaking pieces out into separate services.

Features

• cookie-based authentication 🍪
• realtime updates ⚡️
• offline mode 🖥️
• undo/redo ↩️
• end-to-end browser testing 🔧
• runs in a single process + scales when you need to

Getting Started

git clone git@github.com:ccorcos/chet-stack.git project
cd project
git remote remove origin
npm install
npm run bootstrap
npm start

• npm run reset to clear all data in your database
• npm run typecheck to check TypeScript types.
• npm run test:unit for unit tests with Mocha
• npm run test:e2e for unit tests with end-to-end tests with Playwright.

Read the docs!

Contributing

Like any software project, this repo is never finished. It's meant to be a great place to start for building a bespoke application from the ground up. You're welcome to use it, but beware of dragons!

👋 If you're getting started / using ChetStack, then please reach out sometime! I'm here to help.