Next.js TS Tailwind Supabase Starter
A modern, full-featured starter template for building web applications with Next.js 14, TypeScript 5.4+, TailwindCSS 3.3+, and Supabase 2.x.
Features
- Next.js 14 with App Router for efficient page routing and server components
- TypeScript 5.4+ for type safety and enhanced developer experience
- TailwindCSS 3.3+ for utility-first styling
- Supabase 2.x for authentication and database management
- Jest 29.x and React Testing Library 14.x for testing
- ESLint 8.x and Prettier 3.x for code quality and formatting
- Complete authentication system with email/password and anonymous sessions
- Protected routes with role-based access control
- Responsive UI components built with TailwindCSS
Quick Start
Prerequisites
- Node.js 18.0 or later
- Git
Installation
- Clone the repository:
git clone https://github.com/matthannigan/nextjs-ts-tailwind-supabase-starter.git
cd nextjs-ts-tailwind-supabase-starter
- Install dependencies:
npm install
- Set up environment variables:
cp .env.example .env.local
Edit .env.local to add your Supabase URL and anon key.
- Start the development server:
npm run dev
Your application will be available at http://localhost:3000.
Documentation
Developer Guide
- Project Structure - Learn about the project organization
- Database Integration - Database schema and operations
- Authentication - Understand the authentication system
- Testing - How to test the application
- Deployment - Deployment instructions
- Tools - Pre-installed developer aids
- Contributing - Process for contributing bug fixes and feature additions
- Version Reference - List of recommended versions for all tools and libraries
React Components
- Layout - Components for displaying app pages
- Navigation - Components for moving between app pages
- Basic UI - shadcn UI components already included in project
- Forms - shadcn Form and Input components already included in project
- Style - Typography and Light/Dark Theme Switcher
Development Journey
- Blog - in development journal about approach, misteps, and successes building the template
Release History
v0.3 - 2025-04-10
- Installed shadcn@2.3.0 and essential components
- Add UI components showcase page
- Added component documentation
- Added React unit tests for all components
- Added jest-html-reporters for generating test reports
- Refactored documentation to use Docusaurus
v0.2.x - 2025-03-17
- Configured testing infrastructure
- Created pre-commit hooks for linting and formatting
- Added Playwright for end-to-end testing
- Added documentation for testing and linting tools
v0.1 - 2025-03-16
- Initial Release
- Initialized Next.js project
- Configured styling and linting
- Set-up project structure
- Implemented basic layout components