supabase-reference-architecture
Implement Supabase reference architecture with best-practice project layout.Use when designing new Supabase integrations, reviewing project structure,or establishing architecture standards for Supabase applications.Trigger with phrases like "supabase architecture", "supabase best practices","supabase project structure", "how to organize supabase", "supabase layout".
When & Why to Use This Skill
This Claude skill automates the implementation of Supabase reference architectures using industry-standard best practices. It streamlines the creation of robust project layouts, including singleton client wrappers with caching, comprehensive error handling, and health check configurations, ensuring scalable and maintainable Supabase integrations for TypeScript applications.
Use Cases
- 1. New Project Initialization: Quickly scaffold a Supabase-backed application with a professional directory structure and standardized layout.
- 2. Architecture Review: Audit existing Supabase implementations against reference standards to identify structural weaknesses or deviations from best practices.
- 3. Team Standardization: Establish a unified coding and structural standard across multiple development teams or microservices using Supabase.
- 4. Resilient Integration: Implement advanced patterns such as singleton clients with caching, custom error boundaries, and health checks to improve application reliability and performance.
| name | supabase-reference-architecture |
|---|---|
| description | | |
| allowed-tools | Read, Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
Supabase Reference Architecture
Prerequisites
- Understanding of layered architecture
- Supabase SDK knowledge
- TypeScript project setup
- Testing framework configured
Instructions
Step 1: Create Directory Structure
Set up the project layout following the reference structure above.
Step 2: Implement Client Wrapper
Create the singleton client with caching and monitoring.
Step 3: Add Error Handling
Implement custom error classes for Supabase operations.
Step 4: Configure Health Checks
Add health check endpoint for Supabase connectivity.
Output
- Structured project layout
- Client wrapper with caching
- Error boundary implemented
- Health checks configured
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.