React Nextjs Boilerplate

React-Nextjs-Boilerplate is a free, MIT-licensed Next.js 14+ starter template for full-stack React applications, bundling authentication, a shadcn/ui design system, and Prisma database migrations into a production-ready file structure.

What is React-Nextjs-Boilerplate?

React-Nextjs-Boilerplate is a Next.js 14+ full-stack starter kit created by GitHub user antoinemcx. It takes a fresh Next.js project and pre-configures it with TypeScript, Tailwind CSS, shadcn/ui components, NextAuth authentication, and Prisma ORM, so developers can clone it and begin building instead of wiring up the toolchain. The output is a runnable web application with sign-in/sign-up pages, private routing, custom error pages, light/dark mode, and a 95+ Lighthouse score. It runs on Node.js and uses MySQL/MariaDB as the default database for authentication.

Key Features

• Production-ready file structure — The repository is organized with starter folders and config files (ESLint, Prettier, VSCode settings) so the project is ready to develop on immediately.
• shadcn/ui theme with global CSS variables — Includes custom UI components like dropdown menus, buttons, headings, and toast notifications, plus a responsive navbar and loading states for buttons.
• Dark/Light/System mode — Theme switching is handled by next-themes, with three modes available and persisted per user preference.
• Authentication via NextAuth and Prisma — Sign-up and sign-in pages support credentials and Google OAuth, with session data stored in a MySQL (or other) database managed through Prisma migrations.
• Private routing — Route protection is built in, so authenticated-only pages are already scaffolded.
• Custom error pages — 404 and other error states are styled to match the theme.
• SEO tooling — next-sitemap generates sitemap.xml and robots.txt automatically during build.
• Performance — The template reports a 95+ Lighthouse score out of the box.

Who is it for?

• Full-stack React developers who want a pre-configured Next.js starter with authentication and database setup so they can skip the boilerplate configuration.
• Startups building MVP web apps that need sign-in, private routes, and a polished UI quickly.
• Developers learning Next.js 14 and TypeScript who want a reference project with best practices like ESLint, Prettier, and Prisma migrations.
• Open-source contributors who want a base for a new project and appreciate the MIT license.

What can you do with React-Nextjs-Boilerplate?

• Build a SaaS landing page with auth: Use the included sign-up/login pages, private routing, and shadcn/ui components to launch a product with a dashboard behind authentication.
• Create a blog or content site: Customize the responsive navbar and theme, then use the build script to auto-generate a sitemap for SEO.
• Prototype a full-stack feature: The Prisma schema and MySQL connection let you add models and run migrations, while Next.js API routes handle backend logic.

How does it work?

The template is installed by cloning the repository, installing dependencies with npm, yarn, or pnpm, and creating a MySQL/MariaDB database. After copying the .env.example file to .env and filling in values, run npx prisma migrate deploy to apply schema migrations, then npm run dev (or the yarn/pnpm equivalent) to launch the app on localhost:3000. The build script also regenerates the sitemap automatically.

Pricing

React-Nextjs-Boilerplate is free and open source under the MIT License, so it can be used for personal and commercial projects without licensing fees.

FAQ

Is React-Nextjs-Boilerplate free?

Yes, the project is MIT-licensed, so you can use, modify, and distribute it freely, including in commercial applications.

What database does it use?

The default setup uses MySQL or MariaDB via Prisma ORM for authentication data. The configuration allows other databases supported by Prisma, but the instructions and migrations target MySQL.

What authentication methods are included?

NextAuth is configured for credentials (email/password) and Google OAuth sign-in. The sign-up and sign-in pages are already styled.

Can I customize the theme?

Yes, the theme is built with shadcn/ui and global CSS variables, and next-themes provides dark, light, and system modes. You can change colors and components directly.

Does the template include a sitemap?

Yes, next-sitemap is integrated, and running the build script generates sitemap.xml and robots.txt automatically.