feat(examples): comprehensive UX overhaul with inline code examples

[grdsdev]

Summary

This PR completely rebuilds the Examples app with modern UX patterns, extensive inline code examples, and comprehensive feature coverage across all Supabase SDK capabilities.

The Examples app now serves as both a functional demonstration and an educational resource, with every screen including:

• 🎯 Interactive examples with real data
• 📝 Inline code snippets showing exact API usage
• 📚 Detailed explanations and use cases
• ✨ Modern iOS design patterns
• 🔄 Live updates and state management

What's New

🔐 Authentication (13 files)

• New: AuthExamplesView - Main navigation hub with organized auth methods
• Enhanced: All auth views with inline CodeExample blocks
• Added: Comprehensive "About" sections explaining each method
• Improved: Loading states, success messages, error handling

Auth Methods:

• Email & Password (with email confirmation flow)
• Magic Link (passwordless)
• Phone OTP (with verification)
• Anonymous Sign-In (with account conversion)
• OAuth providers (Apple, Google, Facebook)
• MFA enrollment and management

📦 Storage (8 new comprehensive views)

Complete file and bucket management system:

1. StorageExamplesView - Main navigation hub
2. BucketOperationsView - Create, update, delete, empty buckets
3. FileUploadView - Photo library, documents, progress tracking
4. FileDownloadView - Download with image/text preview
5. ImageTransformView - Resize, quality, format with comparison
6. SignedURLsView - Temporary download/upload URLs, public URLs
7. FileManagementView - Move, copy, delete operations
8. FileSearchView - Advanced search, sorting, metadata

Each includes inline code examples showing exact API calls.

💾 Database (5 new views)

• DatabaseExamplesView - Main navigation
• FilteringView - Query filters and ordering
• RPCExamplesView - PostgreSQL function calls
• AggregationsView - Count and aggregate operations
• RelationshipsView - Joins and related data

⚡️ Realtime (5 new views)

• RealtimeExamplesView - Main navigation
• PostgresChangesView - Database change listeners
• TodoRealtimeView - Live todo updates
• BroadcastView - Real-time messaging
• PresenceView - Online user tracking

👤 Profile Management (4 enhanced views)

• ProfileView - Complete redesign with MFA integration, pull-to-refresh
• UpdateProfileView - Better UX with inline verification guidance
• ResetPasswordView - Step-by-step password reset flow
• UserIdentityList - Swipe-to-delete, provider icons, rich metadata

UX Improvements

Consistent Patterns Applied Everywhere

✅ Inline Code Examples - CodeExample components on every screen
✅ Educational Content - "About" sections with use cases and tips
✅ Loading States - Descriptive ProgressView messages
✅ Success Feedback - Green messages with next steps
✅ Error Handling - Consistent ErrorText component
✅ Navigation - ExampleRow with icons and descriptions
✅ Empty States - Helpful guidance when no data exists
✅ Pull-to-Refresh - Swipe down to update data
✅ Swipe Actions - Natural gestures for delete/unlink

Modern iOS Design

• Clean section headers and descriptions
• Proper visual hierarchy with fonts and colors
• Loading indicators for all async operations
• Success confirmations in green, warnings in orange
• Educational tooltips and inline help
• Disclosure groups for advanced details

Database Changes

New Migration: 20251009000000_examples_schema.sql

-- Tables with RLS policies
CREATE TABLE todos (...)
CREATE TABLE profiles (...)
CREATE TABLE messages (...)

-- PostgreSQL functions for RPC examples
CREATE FUNCTION increment_todo_count(...)

Features

• Row Level Security (RLS) on all tables
• Foreign key relationships
• Triggers for automatic updates
• Sample RPC functions

Updated Seed Data

Added sample data for testing all features.

Documentation

Completely Rewrote Examples/README.md

• Overview - Positioned as educational resource
• Feature Documentation - Detailed coverage of all capabilities
• Project Structure - Complete file tree
• Usage Guide - Tab-by-tab exploration
• Key Patterns - Code examples, state management, components
• Troubleshooting - Storage, Realtime, Auth, Database sections
• Learning Resources - Tips for developers

Technical Details

New Reusable Components

struct ExampleRow: View // Consistent navigation items
struct CodeExample: View // Syntax-highlighted code snippets

Established Patterns

• ActionState<Success, Failure> for async operations
• Consistent error handling with ErrorText
• Loading states with descriptive messages
• Success confirmations with helpful guidance

Statistics

• 52 files changed
• 6,796 insertions, 516 deletions
• 13 new Auth files
• 8 new Storage files
• 5 new Database files
• 5 new Realtime files
• 1 new migration

Testing

Manual Testing Performed

✅ All authentication methods tested
✅ Storage operations (upload, download, transform, manage)
✅ Database CRUD, filtering, RPC, aggregations
✅ Realtime subscriptions (Postgres changes, broadcast, presence)
✅ Profile management and linked identities
✅ MFA enrollment and verification
✅ Pull-to-refresh and swipe gestures
✅ Error states and edge cases

How to Test

1. Start local Supabase: supabase start
2. Run the Examples app
3. Sign up with any auth method
4. Explore all 5 tabs
5. Try inline code examples
6. Test with multiple devices for Realtime features

Screenshots

The app now provides a comprehensive, polished experience with:

• Clean navigation organized by feature
• Inline code examples on every screen
• Educational content throughout
• Modern iOS design patterns
• Interactive features with real-time feedback

Breaking Changes

None. This is purely additive and enhances the existing Examples app.

Migration Guide

No migration needed. The app works with both local and remote Supabase instances.

Checklist

• All new views include inline code examples
• Educational "About" sections added
• Consistent UX patterns applied
• Loading states and error handling
• Database migration created and tested
• README documentation updated
• Manual testing completed
• No breaking changes

🤖 Generated with Claude Code

[coveralls]

Pull Request Test Coverage Report for Build 18500497587

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 77.416%

---

Totals
Change from base Build 18499194586:	0.0%
Covered Lines:	5920
Relevant Lines:	7647

---

💛 - Coveralls