Repolode
chihebnabil

chihebnabil/lovable-boilerplate

A React + Vite + TypeScript boilerplate with shadcn/ui, Tailwind and Supabase, plus AI assistant instructions for Copilot and Cursor.

Stars
66
Forks
31
Open issues
7
Last commit
3 days ago

What is it?

This is a React starter project inspired by Lovable's AI app builder. It gives developers a conventional codebase with Vite, React 19, TypeScript, Tailwind CSS and a set of shadcn/ui components, so generated or hand-written UI can be read, changed and extended directly.

The template comes with Supabase wired in through a client file and generated database types, along with example queries, real-time subscriptions and email/password authentication calls. It also includes Supabase CLI configuration and a migrations folder for local development. Data fetching is handled with TanStack Query, and forms with React Hook Form and Zod.

The repository includes a global instructions file under .github/instructions meant for GitHub Copilot and Cursor, covering layout, styling and component conventions so AI assistants follow the project's patterns.

Key features

  • 01Vite and React 19 with TypeScript for development and builds.
  • 0240+ shadcn/ui components preconfigured under src/components/ui.
  • 03Supabase client, generated types and migrations folder for backend work.
  • 04TanStack Query for data fetching and React Hook Form with Zod for forms.
  • 05Copilot and Cursor instruction file describing project conventions.

Use cases

  • Starting a React web app with a shadcn/ui design system and Supabase backend.
  • Building a prototype that you plan to customize heavily from a generated UI.
  • Setting up a project where AI coding assistants should follow consistent styling rules.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/chihebnabil/lovable-boilerplate.git
  2. 2

    Enter the project folder

    cd lovable-boilerplate
  3. 3

    Install dependencies

    npm install
  4. 4

    Start the development server (runs at http://localhost:8080)

    npm run dev

Things to know

  • Supabase features need your own Supabase project and credentials in a .env file.
  • Local Supabase commands require Docker.

Topics

FAQ

What is lovable-boilerplate?
A React + Vite + TypeScript boilerplate with shadcn/ui, Tailwind and Supabase, plus AI assistant instructions for Copilot and Cursor. This is a React starter project inspired by Lovable's AI app builder. It gives developers a conventional codebase with Vite, React 19, TypeScript, Tailwind CSS and a set of shadcn/ui components, so generated or hand-written UI can be read, changed and extended directly.
Is lovable-boilerplate free to use? What license does it have?
lovable-boilerplate is open source under the MIT license. Check the license terms before using it in commercial products.
Is lovable-boilerplate still maintained?
Actively maintained. The last commit to lovable-boilerplate was on Nov 4, 2026.
What can I use lovable-boilerplate for?
Starting a React web app with a shadcn/ui design system and Supabase backend. Building a prototype that you plan to customize heavily from a generated UI. Setting up a project where AI coding assistants should follow consistent styling rules.
How do I install lovable-boilerplate?
Clone the repository: git clone https://github.com/chihebnabil/lovable-boilerplate.git Enter the project folder: cd lovable-boilerplate Install dependencies: npm install Start the development server (runs at http://localhost:8080): npm run dev
Where can I get lovable-boilerplate?
The source code and installation instructions are on GitHub: https://github.com/chihebnabil/lovable-boilerplate

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects