Source:
ocean/docs/README.md| ✏️ Edit on GitHub
Ocean Documentation
Welcome to the Ocean project documentation. This directory contains all technical documentation, guides, and architectural decisions for the project.
Documentation Structure
📁 Core Documentation
- DEVELOPER_GUIDE.md - Complete guide for developers working on Ocean
- BUILD_BEST_PRACTICES.md - Best practices for building and deployment
- BUILD_VALIDATION.md - Build validation and quality checks
- CLAUDE.md - AI assistant configuration and guidelines
- HIDDEN_FEATURES.md - Powerful features that aren't immediately obvious
- SYSTEM_ARCHITECTURE.md - Complete system architecture overview
- AUTOMATION_TOOLS.md - Development and operations automation
🔐 Authentication & Setup
- PASSWORDLESS_AUTH.md - Passwordless authentication implementation
- SETUP_OTP.md - One-Time Password setup guide
- UPDATE_OTP_SETTINGS.md - Guide for updating OTP settings
- TEST_AUTH.md - Authentication testing guide
🗄️ Supabase Documentation
- SUPABASE_SETUP.md - Local Supabase setup guide
- SUPABASE_PRODUCTION_SETUP.md - Production Supabase configuration
- SUPABASE_STAGING_SETUP.md - Staging environment configuration
- SUPABASE_CICD_SETUP.md - CI/CD pipeline for Supabase
🧪 Testing Documentation
- LOCAL_TESTING_SETUP.md - Comprehensive local testing environment guide
- LOCAL_TESTING_README.md - Quick reference for local testing
- E2E_TESTING.md - End-to-end testing guide
- TESTING_STRIPE_WEBHOOK.md - Stripe webhook testing
- testing-strategy.md - Overall testing strategy
🎨 Patterns & Best Practices
- patterns/ - Comprehensive patterns for common tasks
- data-fetching.md - GraphQL queries, mutations, and caching
- error-handling.md - Error boundaries and recovery patterns
- authentication.md - Auth flows, JWT monitoring, multi-tab sync
- forms.md - TanStack Form with Valibot validation
- ui-utilities.md - Typography, responsive design, theming
- edge-functions.md - Edge Function wrapper patterns
- React-mutations.md - React mutation patterns
- TYPOGRAPHY_PATTERNS.md - Typography system and usage guide
🏗️ Architecture Decision Records
- adr/ - Architecture Decision Records documenting key technical decisions
- ADR-0001 - Adopt TanStack Ecosystem
- ADR-014 - Cloud-First Testing Strategy
- ADR-028 - Local Testing Environment Setup
- See adr/README.md for the complete list
Quick Links
- 🚀 Getting Started
- 🔒 Authentication Setup
- 📊 Architecture Decisions
- 🏗️ Build & Deploy
- 🎯 Pattern Library
- 💎 Hidden Features
- 🤖 AI Guidelines
Contributing to Documentation
When adding new documentation:
- Place guides and how-tos in this directory
- Create ADRs in the
adr/subdirectory - Update this README with links to new documents
- Follow the existing format and style
- Include practical examples where possible
Documentation Standards
- Use clear, concise language
- Include code examples for technical concepts
- Add diagrams where they aid understanding
- Keep documentation up-to-date with code changes
- Review documentation in pull requests