Remix Bossa Nova Stack

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 .env file.
• Supabase database — Pre-configured to connect to a Supabase project; includes a bossa_nova_songs table with id, created_at, user_id, and body columns, plus SQL for creating a requesting_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 cypress directory 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 or npm 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.