Skip to main content

Introduction to Supabase TDD Boilerplate

Welcome to the Supabase TDD Boilerplate, a comprehensive monorepo setup that demonstrates Test-Driven Development (TDD) practices with Next.js, Hono, and Supabase. This documentation will guide you through setting up, testing, and developing your application using TDD principles.

Key Features​

  • Test-Driven Development: Comprehensive testing setup with three layers of tests:
    • Unit tests for components and functions
    • Integration tests for RLS + Supabase
    • E2E tests with Playwright
  • Modern Tech Stack:
    • Next.js for the frontend
    • Hono for the API layer
    • Turborepo for monorepo management
    • Supabase for authentication, database, and real-time features
  • Organization & Team Management:
    • Role-based access control
    • Team management
    • Invitation system
    • Row Level Security (RLS) policies
  • Type Safety: Full TypeScript support throughout the stack
  • Developer Experience: Streamlined development workflow with Turborepo

Who is this for?​

This boilerplate is designed for developers who want to:

  • Learn and practice Test-Driven Development with Supabase
  • Build scalable applications with a modern tech stack
  • Implement organization and team management features
  • Work with a well-structured monorepo setup
  • Ensure code quality through comprehensive testing

Whether you're a developer learning TDD, a team implementing best practices, or a company building a scalable application, this boilerplate provides the foundation and examples you need.

What's Next?​

To get started with the Supabase TDD Boilerplate, check out the Prerequisites section to ensure you have everything you need.