Remix Bossa Nova Stack is a production-oriented Remix starter template that bundles Clerk authentication, a Supabase PostgreSQL database, and Chakra UI styling into a single scaffold. Published by Clerk, it is installed with npx create-remix@latest --template clerkinc/remix-bossa-nova-stack app-name and ships with a working song-list example app that demonstrates protected routes and user-scoped data.
What is Remix Bossa Nova Stack?
Remix Bossa Nova Stack is a Remix Stack template created by Clerk that gives you a full-stack Remix application with user management, a Supabase database, and Chakra UI components. It takes your Clerk and Supabase credentials, connects them through Clerk's JWT templates, and produces a deployable app with a sample bossa_nova_songs table and Row Level Security policies.
Key Features
- Clerk user management — Handles sign-up, sign-in, and user sessions; requires a Clerk Frontend API key and Backend API key stored in a local
.envfile. - Supabase database — Pre-configured to connect to a Supabase project; includes a
bossa_nova_songstable withid,created_at,user_id, andbodycolumns, plus SQL for creating arequesting_user_id()function and RLS policies. - Chakra UI — Styling and accessible component library integrated throughout the app; documented in the Chakra UI docs.
- Vercel deployment — Deploy by importing the Git repository into Vercel or by running the Vercel CLI from the project directory.
- Cypress end-to-end tests — Includes example specs in the
cypressdirectory for testing full user flows. - Jest and Testing Library unit tests — Configured for lower-level tests of utilities and components.
- TypeScript, ESLint, and Prettier — Static typing with
npm run typecheck, linting with ESLint, and auto-formatting with Prettier ornpm run format.
Who is it for?
- Remix developers who want a pre-built auth and database layer without wiring Clerk and Supabase from scratch.
- Clerk customers looking for a reference integration showing how to use Clerk's JWT templates with Supabase RLS.
- SaaS founders who need a tested starter for a user-facing app and want automated deployment to Vercel.
What can you do with it?
- Prototype a user-scoped app — Use the included song-list example to understand how to store and query data that belongs to a signed-in user.
- Integrate authentication and a database — Follow the documented setup to connect Clerk and Supabase, including the RLS policies.
- Deploy to production — Import your repository into Vercel and get automatic deploys on every commit.
How does it work?
After scaffolding with create-remix, you add Clerk and Supabase credentials to a .env file, create the bossa_nova_songs table via the Supabase dashboard, and run the provided SQL to enable Row Level Security. Then npm run dev starts the app at http://localhost:3000.
