Auth - Base Authentication Scaffold

Creates the authentication feature foundation with Clean Architecture. This skill generates shared infrastructure that /social-login and /phone-auth build upon.

When to Use This Skill

• After /core skill completes
• Before adding specific auth methods (/social-login, /phone-auth)
• Setting up auth from scratch
• User asks to "add authentication" or "create auth"

Questions to Ask

1. Backend type: Supabase or Custom API?
2. Auth methods: (multi-select) Social Login, Phone OTP, Email/Password
3. User profile fields: Custom fields beyond id/email? (e.g., displayName, avatarUrl)

What This Skill Creates

Base auth infrastructure that specific auth skills extend:

Reference Files

reference/
├── models/           # UserProfile, AuthResult
├── repositories/     # Interface, Supabase impl, mock
├── providers/        # AuthState, AuthNotifier
├── screens/          # LoginScreen scaffold
└── failures/         # Base auth failure types

See: implementation-guide.md for complete file list.

Workflow

Phase 1: Ask Questions

Use AskUserQuestion to gather:

• Backend type (Supabase vs Custom API)
• Which auth methods needed
• Custom user profile fields

Phase 2: Generate Structure

Create standard Clean Architecture feature:

lib/features/auth/
├── data/          # models/, repositories/
├── domain/        # failures/, repositories/
├── presentation/  # providers/, screens/
└── i18n/          # auth.i18n.yaml

See: implementation-guide.md for complete structure.

Phase 3: Copy Reference Files

1. Copy models from reference/models/
2. Copy repository interface from reference/repositories/
3. Copy implementation (Supabase or API base)
4. Copy providers from reference/providers/
5. Copy login screen scaffold from reference/screens/

Phase 4: Register Providers

Add to lib/core/providers.dart:

@riverpod
AuthRepository authRepository(Ref ref) {
  if (DebugConstants.useMockAuth) {
    return MockAuthRepository();
  }
  return AuthRepositoryImpl(Supabase.instance.client);
}

Phase 5: Add Routes

Add to lib/core/router/app_router.dart:

GoRoute(
  path: '/login',
  builder: (context, state) => const LoginScreen(),
),

Phase 6: Run Build

dart run build_runner build --delete-conflicting-outputs

Core API

// Check current auth state
final user = await repository.getCurrentUser();

// Sign out
await repository.signOut();

// Listen to auth changes
repository.authStateChanges.listen((user) => ...);

Auth States

Base Failure Types

Specific auth methods add their own failure types (see /social-login, /phone-auth).

Next Steps

After running /auth, run these skills based on your selection:

Then:

1. /i18n auth - Localize strings
2. /design - Polish UI
3. /testing auth - Write tests

Integration Architecture

┌─────────────────────────────────────────────────────────┐
│                    LoginScreen                          │
│  ┌────────────┐ ┌────────────┐ ┌────────────────────┐  │
│  │ Email Form │ │ Social Btns│ │ Phone Number Input │  │
│  │ (built-in) │ │(/social)   │ │   (/phone-auth)    │  │
│  └─────┬──────┘ └─────┬──────┘ └─────────┬──────────┘  │
└────────┼──────────────┼──────────────────┼─────────────┘
         │              │                  │
    ┌────┴──────────────┴──────────────────┴────┐
    │              AuthNotifier                  │
    │  signInWithEmail | signInWithGoogle | ... │
    └──────────────────┬────────────────────────┘
                       │
    ┌──────────────────┴────────────────────────┐
    │             AuthRepository                 │
    │ implements: SocialAuthRepo, PhoneAuthRepo │
    └───────────────────────────────────────────┘

Guides

Checklist

• AuthRepository interface created with signOut, getCurrentUser, authStateChanges
• AuthNotifier extends AsyncNotifier with disposal safety
• AuthState is sealed (initial, loading, authenticated, unauthenticated, error)
• UserProfile model created with required fields
• Repository implementation matches backend type (Supabase/Custom)
• Provider registered in lib/core/providers.dart
• Login route added to router
• build_runner executed successfully
• Mock repository created for testing

Related Skills

• /social-login - Google + Apple Sign-In (extends auth)
• /phone-auth - Phone OTP (extends auth)
• /core - Run before auth (creates services)
• /design - Login screen UI polish
• /i18n - Localized auth strings