Important
This project is still a work in progress. It's improving continuously and will be ready soon. Documentation for using this project is currently limited but will be expanded shortly.
- Must feel elementary/vanilla to use and be easy to learn
- Must be financially accessible to all, meaning it should at least be able to be hosted for free at base tier without having to add a credit card
- Must be entirely self-hostable (if needed)
- Must use well-maintained, actively developed packages to ensure long-term sustainability
- Must be able to work well with AI code editor assistants
- Astro
- Alpine.js + Alpine AJAX
- TailwindCSS v4 + Basecoat UI
- Bknd
- Netlify, or host anywhere
"All of the shadcn/ui magic, none of the React. A components library built with Tailwind CSS that works with any web stack. basecoatui.com"
In the Cursor chat window you can type @basecoat-ui.mdc
and get AI assistance for your Basecoat UI CSS.
"Experience the power of a lightweight, feature-rich backend that seamlessly integrates into your framework of choice."
Imagine having your own Supabase-like backend with auth, user management, media management, database management, etc., but you could host it anywhere you'd like? That's Bknd.
Since Bknd integrates into your framework of choice, it ships with Freedom Stack out of the box!
Here's the best explanation for the heart of Bknd and why it's perfect for Freedom Stack.
Develop on a local libSQL database, included by default without needing to configure anything.
When ready for production, I recommend using a database from Turso.
Run the following command to install this stack on your machine, without the commit history of this repo.
npx degit https://github.com/cameronapak/freedom-stack-v2 my-project
This may look funny, but running bknd this way makes it where bknd will use our bknd.config.ts
file.
npx tsx node_modules/.bin/bknd user create
Using Node Version Manager?
nvm use
Install the packages.
npm install
Now, let's run the app!
npm run dev
- We've replaced Astro DB with Bknd
- Better Auth has been replaced with Bknd's built-in auth
- Instead of using daisyUI, we now use Basecoat (think
shadcn-ui
but without React) - Instead of HTMX, we use Alpine Ajax (if you don't know what either one of these are... it's okay)
Freedom Stack v2 not for you? Consider these amazing alternatives.
- basis - "A foundation for modern web development built on fundamental tools and clear architectural boundaries. Powered by Astro, Alpine.js, and Supabase with 65+ pre-built components."
- better-t-stack - "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations"