Merge branch 'dev' into feature/session-persistence-new

.agent/settings.local.json

@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(grep:*)",
+      "mcp__paper__get_basic_info",
+      "mcp__paper__get_screenshot",
+      "mcp__paper__get_tree_summary",
+      "mcp__paper__update_styles",
+      "mcp__paper__set_text_content",
+      "mcp__paper__get_computed_styles",
+      "mcp__paper__finish_working_on_nodes",
+      "mcp__paper__get_font_family_info",
+      "mcp__paper__rename_nodes",
+      "mcp__paper__write_html",
+      "mcp__paper__get_children",
+      "mcp__paper__create_artboard",
+      "mcp__paper__delete_nodes",
+      "mcp__paper__get_jsx",
+      "mcp__paper__get_node_info",
+      "mcp__paper__duplicate_nodes"
+    ]
+  }
+}

.agent/skills/krow-mobile-architecture/SKILL.md

@@ -0,0 +1,900 @@
+---
+name: krow-mobile-architecture
+description: KROW mobile app Clean Architecture implementation including package structure, dependency rules, feature isolation, BLoC lifecycle management, session handling, and Data Connect connectors pattern. Use this when architecting new mobile features, debugging state management issues, preventing prop drilling, managing BLoC disposal, implementing session stores, or setting up connector repositories. Essential for maintaining architectural integrity across staff and client apps.
+---
+
+# KROW Mobile Architecture
+
+This skill defines the authoritative mobile architecture for the KROW platform. All code must strictly adhere to these principles to prevent architectural degradation.
+
+## When to Use This Skill
+
+- Architecting new mobile features
+- Debugging state management or BLoC lifecycle issues
+- Preventing prop drilling in UI code
+- Managing session state and authentication
+- Implementing Data Connect connector repositories
+- Setting up feature modules and dependency injection
+- Understanding package boundaries and dependencies
+- Refactoring legacy code to Clean Architecture
+
+## 1. High-Level Architecture
+
+KROW follows **Clean Architecture** in a **Melos Monorepo**. Dependencies flow **inward** toward the Domain.
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    Apps (Entry Points)                  │
+│  • apps/mobile/apps/client                              │
+│  • apps/mobile/apps/staff                               │
+│  Role: DI roots, navigation assembly, env config        │
+└─────────────────┬───────────────────────────────────────┘
+                  │ depends on
+┌─────────────────▼───────────────────────────────────────┐
+│                   Features (Vertical Slices)            │
+│  • apps/mobile/packages/features/client/*               │
+│  • apps/mobile/packages/features/staff/*                │
+│  Role: Pages, BLoCs, Use Cases, Feature Repositories    │
+└─────┬───────────────────────────────────────┬───────────┘
+      │ depends on                            │ depends on
+┌─────▼────────────────┐              ┌───────▼───────────┐
+│   Design System      │              │  Core Localization│
+│  • UI components     │              │  • LocaleBloc     │
+│  • Theme/colors      │              │  • Translations   │
+│  • Typography        │              │  • ErrorTranslator│
+└──────────────────────┘              └───────────────────┘
+                  │ both depend on
+┌─────────────────▼───────────────────────────────────────┐
+│               Services (Interface Adapters)             │
+│  • data_connect: Backend integration, session mgmt      │
+│  • core: Extensions, base classes, utilities            │
+└─────────────────┬───────────────────────────────────────┘
+                  │ both depend on
+┌─────────────────▼───────────────────────────────────────┐
+│                Domain (Stable Core)                     │
+│  • Entities (immutable data models)                     │
+│  • Failures (domain-specific errors)                    │
+│  • Pure Dart only, zero Flutter dependencies            │
+└─────────────────────────────────────────────────────────┘
+```
+
+**Critical Rule:** Dependencies point INWARD only. Domain knows nothing about the outer layers.
+
+## 2. Package Structure & Responsibilities
+
+### 2.1 Apps (`apps/mobile/apps/`)
+
+**Role:** Application entry points and DI roots
+
+**Responsibilities:**
+- Initialize Flutter Modular
+- Assemble features into navigation tree
+- Inject concrete implementations (from `data_connect`) into features
+- Configure environment-specific settings (dev/stage/prod)
+- Initialize session management
+
+**Structure:**
+```
+apps/mobile/apps/staff/
+├── lib/
+│   ├── main.dart              # Entry point, session initialization
+│   ├── app_module.dart        # Root module, imports features
+│   ├── app_widget.dart        # MaterialApp setup
+│   └── src/
+│       ├── navigation/        # Typed navigators
+│       └── widgets/           # SessionListener wrapper
+└── pubspec.yaml
+```
+
+**RESTRICTION:** NO business logic. NO UI widgets (except App and Main).
+
+### 2.2 Features (`apps/mobile/packages/features/<APP>/<FEATURE>`)
+
+**Role:** Vertical slices of user-facing functionality
+
+**Internal Structure:**
+```
+features/staff/profile/
+├── lib/
+│   ├── src/
+│   │   ├── domain/
+│   │   │   ├── repositories/        # Repository interfaces
+│   │   │   │   └── profile_repository_interface.dart
+│   │   │   └── usecases/           # Application logic
+│   │   │       └── get_profile_usecase.dart
+│   │   ├── data/
+│   │   │   └── repositories_impl/   # Repository concrete classes
+│   │   │       └── profile_repository_impl.dart
+│   │   └── presentation/
+│   │       ├── blocs/              # State management
+│   │       │   └── profile_cubit.dart
+│   │       ├── pages/              # Screens (StatelessWidget preferred)
+│   │       │   └── profile_page.dart
+│   │       └── widgets/            # Reusable UI components
+│   │           └── profile_header.dart
+│   └── profile_feature.dart        # Barrel file (public API only)
+└── pubspec.yaml
+```
+
+**Key Principles:**
+- **Presentation:** UI Pages and Widgets, BLoCs/Cubits for state
+- **Application:** Use Cases (business logic orchestration)
+- **Data:** Repository implementations (backend integration)
+- **Pages as StatelessWidget:** Move state to BLoCs for better performance and testability
+
+**RESTRICTION:** Features MUST NOT import other features. Communication happens via:
+- Shared domain entities
+- Session stores (`StaffSessionStore`, `ClientSessionStore`)
+- Navigation via Modular
+- Data Connect connector repositories
+
+### 2.3 Domain (`apps/mobile/packages/domain`)
+
+**Role:** The stable, pure heart of the system
+
+**Responsibilities:**
+- Define **Entities** (immutable data models using Data Classes or Freezed)
+- Define **Failures** (domain-specific error types)
+
+**Structure:**
+```
+domain/
+├── lib/
+│   └── src/
+│       ├── entities/
+│       │   ├── user.dart
+│       │   ├── staff.dart
+│       │   └── shift.dart
+│       └── failures/
+│           ├── failure.dart        # Base class
+│           ├── auth_failure.dart
+│           └── network_failure.dart
+└── pubspec.yaml
+```
+
+**Example Entity:**
+```dart
+import 'package:equatable/equatable.dart';
+
+class Staff extends Equatable {
+  final String id;
+  final String name;
+  final String email;
+  final StaffStatus status;
+  
+  const Staff({
+    required this.id,
+    required this.name,
+    required this.email,
+    required this.status,
+  });
+  
+  @override
+  List<Object?> get props => [id, name, email, status];
+}
+```
+
+**RESTRICTION:** 
+- NO Flutter dependencies (no `import 'package:flutter/material.dart'`)
+- NO `json_annotation` or serialization code
+- Only `equatable` for value equality
+- Pure Dart only
+
+### 2.4 Data Connect (`apps/mobile/packages/data_connect`)
+
+**Role:** Interface Adapter for Backend Access
+
+**Responsibilities:**
+- Centralized connector repositories (see Data Connect Connectors Pattern section)
+- Implement Firebase Data Connect service layer
+- Map Domain Entities ↔ Data Connect generated code
+- Handle Firebase exceptions → domain failures
+- Provide `DataConnectService` with session management
+
+**Structure:**
+```
+data_connect/
+├── lib/
+│   ├── src/
+│   │   ├── services/
+│   │   │   ├── data_connect_service.dart     # Core service
+│   │   │   └── mixins/
+│   │   │       └── session_handler_mixin.dart
+│   │   ├── connectors/                        # Connector pattern (see below)
+│   │   │   ├── staff/
+│   │   │   │   ├── domain/
+│   │   │   │   │   ├── repositories/
+│   │   │   │   │   │   └── staff_connector_repository.dart
+│   │   │   │   │   └── usecases/
+│   │   │   │   │       └── get_profile_completion_usecase.dart
+│   │   │   │   └── data/
+│   │   │   │       └── repositories/
+│   │   │   │           └── staff_connector_repository_impl.dart
+│   │   │   ├── order/
+│   │   │   └── shifts/
+│   │   └── session/
+│   │       ├── staff_session_store.dart
+│   │       └── client_session_store.dart
+│   └── krow_data_connect.dart               # Exports
+└── pubspec.yaml
+```
+
+**RESTRICTION:**
+- NO feature-specific logic
+- Connectors are domain-neutral and reusable
+- All queries follow Clean Architecture (domain interfaces → data implementations)
+
+### 2.5 Design System (`apps/mobile/packages/design_system`)
+
+**Role:** Visual language and component library
+
+**Responsibilities:**
+- Theme definitions (`UiColors`, `UiTypography`)
+- UI constants (`spacingL`, `radiusM`, etc.)
+- Shared widgets (if reused across multiple features)
+- Assets (icons, images, fonts)
+
+**Structure:**
+```
+design_system/
+├── lib/
+│   └── src/
+│       ├── ui_colors.dart
+│       ├── ui_typography.dart
+│       ├── ui_icons.dart
+│       ├── ui_constants.dart
+│       ├── ui_theme.dart          # ThemeData factory
+│       └── widgets/               # Shared UI components
+│           └── custom_button.dart
+└── assets/
+    ├── icons/
+    └── images/
+```
+
+**RESTRICTION:**
+- Dumb widgets ONLY (no state management)
+- NO business logic
+- Colors and typography are IMMUTABLE (no feature can override)
+
+### 2.6 Core Localization (`apps/mobile/packages/core_localization`)
+
+**Role:** Centralized i18n management
+
+**Responsibilities:**
+- Define all user-facing strings in `l10n/`
+- Provide `LocaleBloc` for locale state management
+- Export `TranslationProvider` for `context.strings` access
+- Map domain failures to localized error messages via `ErrorTranslator`
+
+**Feature Integration:**
+```dart
+// Features access strings
+Text(context.strings.loginButton)
+
+// BLoCs emit domain failures (not strings)
+emit(AuthError(InvalidCredentialsFailure()));
+
+// UI translates failures to localized messages
+final message = ErrorTranslator.translate(failure, context.strings);
+```
+
+**App Setup:**
+```dart
+// App imports LocalizationModule
+class AppModule extends Module {
+  @override
+  List<Module> get imports => [LocalizationModule()];
+}
+
+// Wrap app with providers
+BlocProvider<LocaleBloc>(
+  create: (_) => Modular.get<LocaleBloc>(),
+  child: TranslationProvider(
+    child: MaterialApp.router(...),
+  ),
+)
+```
+
+### 2.7 Core (`apps/mobile/packages/core`)
+
+**Role:** Cross-cutting concerns
+
+**Responsibilities:**
+- Extension methods (NavigationExtensions, ListExtensions, etc.)
+- Base classes (UseCase, Failure, BlocErrorHandler)
+- Logger configuration
+- Result types for functional error handling
+
+## 3. Dependency Direction Rules
+
+1. **Domain Independence:** `domain` knows NOTHING about outer layers
+   - Defines *what* needs to be done, not *how*
+   - Pure Dart, zero Flutter dependencies
+   - Stable contracts that rarely change
+
+2. **UI Agnosticism:** Features depend on `design_system` for UI and `domain` for logic
+   - Features do NOT know about Firebase or backend details
+   - Backend changes don't affect feature implementation
+
+3. **Data Isolation:** `data_connect` depends on `domain` to know interfaces
+   - Implements domain repository interfaces
+   - Maps backend models to domain entities
+   - Does NOT know about UI
+
+**Dependency Flow:**
+```
+Apps → Features → Design System
+                → Core Localization
+                → Data Connect → Domain
+                              → Core
+```
+
+## 4. Data Connect Service & Session Management
+
+### 4.1 Session Handler Mixin
+
+**Location:** `apps/mobile/packages/data_connect/lib/src/services/mixins/session_handler_mixin.dart`
+
+**Responsibilities:**
+- Automatic token refresh (triggered when <5 minutes to expiry)
+- Firebase auth state listening
+- Role-based access validation
+- Session state stream emissions
+- 3-attempt retry with exponential backoff (1s → 2s → 4s)
+
+**Key Method:**
+```dart
+// Call once on app startup
+DataConnectService.instance.initializeAuthListener(
+  allowedRoles: ['STAFF', 'BOTH'],  // or ['CLIENT', 'BUSINESS', 'BOTH']
+);
+```
+
+### 4.2 Session Listener Widget
+
+**Location:** `apps/mobile/apps/<app>/lib/src/widgets/session_listener.dart`
+
+**Responsibilities:**
+- Wraps entire app to listen to session state changes
+- Shows user-friendly dialogs for session expiration/errors
+- Handles navigation on auth state changes
+
+**Usage:**
+```dart
+// main.dart
+runApp(
+  SessionListener(  // ← Critical wrapper
+    child: ModularApp(module: AppModule(), child: AppWidget()),
+  ),
+);
+```
+
+### 4.3 Repository Pattern with Data Connect
+
+**Step 1:** Define interface in feature domain:
+```dart
+// features/staff/profile/lib/src/domain/repositories/
+abstract interface class ProfileRepositoryInterface {
+  Future<Staff> getProfile(String id);
+}
+```
+
+**Step 2:** Implement using `DataConnectService.run()`:
+```dart
+// features/staff/profile/lib/src/data/repositories_impl/
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**Benefits of `_service.run()`:**
+- ✅ Auto validates user is authenticated
+- ✅ Refreshes token if <5 min to expiry
+- ✅ Executes the query
+- ✅ 3-attempt retry with exponential backoff
+- ✅ Maps exceptions to domain failures
+
+### 4.4 Session Store Pattern
+
+After successful auth, populate session stores:
+
+**Staff App:**
+```dart
+StaffSessionStore.instance.setSession(
+  StaffSession(
+    user: user,
+    staff: staff,
+    ownerId: ownerId,
+  ),
+);
+```
+
+**Client App:**
+```dart
+ClientSessionStore.instance.setSession(
+  ClientSession(
+    user: user,
+    business: business,
+  ),
+);
+```
+
+**Lazy Loading:** If session is null, fetch from backend and update:
+```dart
+final session = StaffSessionStore.instance.session;
+if (session?.staff == null) {
+  final staff = await getStaffById(session!.user.uid);
+  StaffSessionStore.instance.setSession(
+    session.copyWith(staff: staff),
+  );
+}
+```
+
+## 5. Feature Isolation & Communication
+
+### Zero Direct Imports
+
+```dart
+// ❌ FORBIDDEN
+import 'package:staff_profile/staff_profile.dart';  // in another feature
+
+// ✅ ALLOWED
+import 'package:krow_domain/krow_domain.dart';      // shared domain
+import 'package:krow_core/krow_core.dart';          // shared utilities
+import 'package:design_system/design_system.dart';  // shared UI
+```
+
+### Navigation: Typed Navigators with Safe Extensions
+
+**Safe Navigation Extensions** (from `core` package):
+```dart
+extension NavigationExtensions on IModularNavigator {
+  /// Safely navigate with fallback to home
+  Future<void> safeNavigate(String route) async {
+    try {
+      await navigate(route);
+    } catch (e) {
+      await navigate('/home');  // Fallback
+    }
+  }
+  
+  /// Safely push with fallback to home
+  Future<T?> safePush<T>(String route) async {
+    try {
+      return await pushNamed<T>(route);
+    } catch (e) {
+      await navigate('/home');
+      return null;
+    }
+  }
+  
+  /// Safely pop with guard against empty stack
+  void popSafe() {
+    if (canPop()) {
+      pop();
+    } else {
+      navigate('/home');
+    }
+  }
+}
+```
+
+**Typed Navigators:**
+```dart
+// apps/mobile/apps/staff/lib/src/navigation/staff_navigator.dart
+extension StaffNavigator on IModularNavigator {
+  Future<void> toStaffHome() => safeNavigate(StaffPaths.home);
+  
+  Future<void> toShiftDetails(String shiftId) => 
+      safePush('${StaffPaths.shifts}/$shiftId');
+  
+  Future<void> toProfileEdit() => safePush(StaffPaths.profileEdit);
+}
+```
+
+**Usage in Features:**
+```dart
+// ✅ CORRECT
+Modular.to.toStaffHome();
+Modular.to.toShiftDetails(shiftId: '123');
+Modular.to.popSafe();
+
+// ❌ AVOID
+Modular.to.navigate('/home');  // No safety
+Navigator.push(...);            // No Modular integration
+```
+
+### Data Sharing Patterns
+
+Features don't share state directly. Use:
+
+1. **Domain Repositories:** Centralized data sources
+2. **Session Stores:** `StaffSessionStore`, `ClientSessionStore` for app-wide context
+3. **Event Streams:** If needed, via `DataConnectService` streams
+4. **Navigation Arguments:** Pass IDs, not full objects
+
+## 6. App-Specific Session Management
+
+### Staff App
+
+```dart
+// main.dart
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['STAFF', 'BOTH'],
+  );
+  
+  runApp(
+    SessionListener(
+      child: ModularApp(module: StaffAppModule(), child: StaffApp()),
+    ),
+  );
+}
+```
+
+**Session Store:** `StaffSessionStore`
+- Fields: `user`, `staff`, `ownerId`
+- Lazy load: `getStaffById()` if staff is null
+
+**Navigation:**
+- Authenticated → `Modular.to.toStaffHome()`
+- Unauthenticated → `Modular.to.toInitialPage()`
+
+### Client App
+
+```dart
+// main.dart
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['CLIENT', 'BUSINESS', 'BOTH'],
+  );
+  
+  runApp(
+    SessionListener(
+      child: ModularApp(module: ClientAppModule(), child: ClientApp()),
+    ),
+  );
+}
+```
+
+**Session Store:** `ClientSessionStore`
+- Fields: `user`, `business`
+- Lazy load: `getBusinessById()` if business is null
+
+**Navigation:**
+- Authenticated → `Modular.to.toClientHome()`
+- Unauthenticated → `Modular.to.toInitialPage()`
+
+## 7. Data Connect Connectors Pattern
+
+**Problem:** Without connectors, each feature duplicates backend queries.
+
+**Solution:** Centralize all backend queries in `data_connect/connectors/`.
+
+### Structure
+
+Mirror backend connector structure:
+
+```
+data_connect/lib/src/connectors/
+├── staff/
+│   ├── domain/
+│   │   ├── repositories/
+│   │   │   └── staff_connector_repository.dart      # Interface
+│   │   └── usecases/
+│   │       └── get_profile_completion_usecase.dart
+│   └── data/
+│       └── repositories/
+│           └── staff_connector_repository_impl.dart # Implementation
+├── order/
+├── shifts/
+└── user/
+```
+
+**Maps to backend:**
+```
+backend/dataconnect/connector/
+├── staff/
+├── order/
+├── shifts/
+└── user/
+```
+
+### Clean Architecture in Connectors
+
+**Domain Interface:**
+```dart
+// staff_connector_repository.dart
+abstract interface class StaffConnectorRepository {
+  Future<bool> getProfileCompletion();
+  Future<Staff> getStaffById(String id);
+}
+```
+
+**Use Case:**
+```dart
+// get_profile_completion_usecase.dart
+class GetProfileCompletionUseCase {
+  final StaffConnectorRepository _repository;
+  
+  GetProfileCompletionUseCase({required StaffConnectorRepository repository})
+      : _repository = repository;
+  
+  Future<bool> call() => _repository.getProfileCompletion();
+}
+```
+
+**Data Implementation:**
+```dart
+// staff_connector_repository_impl.dart
+class StaffConnectorRepositoryImpl implements StaffConnectorRepository {
+  final DataConnectService _service;
+  
+  @override
+  Future<bool> getProfileCompletion() async {
+    return _service.run(() async {
+      final staffId = await _service.getStaffId();
+      final response = await _service.connector
+          .getStaffProfileCompletion(id: staffId)
+          .execute();
+      
+      return _isProfileComplete(response);
+    });
+  }
+}
+```
+
+### Feature Integration
+
+**Step 1:** Feature registers connector repository:
+```dart
+// staff_main_module.dart
+class StaffMainModule extends Module {
+  @override
+  void binds(Injector i) {
+    i.addLazySingleton<StaffConnectorRepository>(
+      StaffConnectorRepositoryImpl.new,
+    );
+    
+    i.addLazySingleton(
+      () => GetProfileCompletionUseCase(
+        repository: i.get<StaffConnectorRepository>(),
+      ),
+    );
+    
+    i.addLazySingleton(
+      () => StaffMainCubit(
+        getProfileCompletionUsecase: i.get(),
+      ),
+    );
+  }
+}
+```
+
+**Step 2:** BLoC uses it:
+```dart
+class StaffMainCubit extends Cubit<StaffMainState> {
+  final GetProfileCompletionUseCase _getProfileCompletionUsecase;
+  
+  Future<void> loadProfileCompletion() async {
+    final isComplete = await _getProfileCompletionUsecase();
+    emit(state.copyWith(isProfileComplete: isComplete));
+  }
+}
+```
+
+### Benefits
+
+✅ **No Duplication** - Query implemented once, used by many features  
+✅ **Single Source of Truth** - Backend change → update one place  
+✅ **Reusability** - Any feature can use any connector  
+✅ **Testability** - Mock connector repo to test features  
+✅ **Scalability** - Easy to add connectors as backend grows  
+
+## 8. Avoiding Prop Drilling: Direct BLoC Access
+
+### The Problem
+
+Passing data through intermediate widgets creates maintenance burden:
+
+```dart
+// ❌ BAD: Prop drilling
+ProfilePage(status: status)
+  → ProfileHeader(status: status)
+    → ProfileLevelBadge(status: status)  // Only widget that needs it
+```
+
+### The Solution: BlocBuilder in Leaf Widgets
+
+```dart
+// ✅ GOOD: Direct BLoC access
+class ProfileLevelBadge extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<ProfileCubit, ProfileState>(
+      builder: (context, state) {
+        if (state.profile == null) return const SizedBox.shrink();
+        
+        final level = _mapStatusToLevel(state.profile!.status);
+        return LevelBadgeUI(level: level);
+      },
+    );
+  }
+}
+```
+
+### Guidelines
+
+1. **Leaf Widgets Access BLoC:** Widgets needing specific data should use `BlocBuilder`
+2. **Container Widgets Stay Simple:** Parent widgets only manage layout
+3. **No Unnecessary Props:** Don't pass data to intermediate widgets
+4. **Single Responsibility:** Each widget has one reason to exist
+
+**Decision Tree:**
+```
+Does this widget need data?
+├─ YES, leaf widget → Use BlocBuilder
+├─ YES, container → Use BlocBuilder in child
+└─ NO → Don't add prop
+```
+
+## 9. BLoC Lifecycle & State Emission Safety
+
+### The Problem: StateError After Dispose
+
+When async operations complete after BLoC is closed:
+```
+StateError: Cannot emit new states after calling close
+```
+
+**Root Causes:**
+1. Transient BLoCs created with `BlocProvider(create:)` → disposed prematurely
+2. Multiple BlocProviders disposing same singleton
+3. User navigates away during async operation
+
+### The Solution: Singleton BLoCs + Safe Emit
+
+#### Step 1: Register as Singleton
+
+```dart
+// ✅ GOOD: Singleton registration
+i.addLazySingleton<ProfileCubit>(
+  () => ProfileCubit(useCase1, useCase2),
+);
+
+// ❌ BAD: Creates new instance each time
+i.add(ProfileCubit.new);
+```
+
+#### Step 2: Use BlocProvider.value()
+
+```dart
+// ✅ GOOD: Reuse singleton
+final cubit = Modular.get<ProfileCubit>();
+BlocProvider<ProfileCubit>.value(
+  value: cubit,
+  child: MyWidget(),
+)
+
+// ❌ BAD: Creates duplicate
+BlocProvider<ProfileCubit>(
+  create: (_) => Modular.get<ProfileCubit>(),
+  child: MyWidget(),
+)
+```
+
+#### Step 3: Safe Emit with BlocErrorHandler
+
+**Location:** `apps/mobile/packages/core/lib/src/presentation/mixins/bloc_error_handler.dart`
+
+```dart
+mixin BlocErrorHandler<S> on Cubit<S> {
+  void _safeEmit(void Function(S) emit, S state) {
+    try {
+      emit(state);
+    } on StateError catch (e) {
+      developer.log(
+        'Could not emit state: ${e.message}. Bloc may have been disposed.',
+        name: runtimeType.toString(),
+      );
+    }
+  }
+}
+```
+
+**Usage:**
+```dart
+class ProfileCubit extends Cubit<ProfileState> with BlocErrorHandler<ProfileState> {
+  Future<void> loadProfile() async {
+    emit(state.copyWith(status: ProfileStatus.loading));
+    
+    await handleError(
+      emit: emit,
+      action: () async {
+        final profile = await getProfile();
+        emit(state.copyWith(status: ProfileStatus.loaded, profile: profile));
+        // ✅ Safe even if BLoC disposed
+      },
+      onError: (errorKey) => state.copyWith(status: ProfileStatus.error),
+    );
+  }
+}
+```
+
+### Pattern Summary
+
+| Pattern | When to Use | Risk |
+|---------|------------|------|
+| Singleton + BlocProvider.value() | Long-lived features | Low |
+| Transient + BlocProvider(create:) | Temporary widgets | Medium |
+| Direct BlocBuilder | Leaf widgets | Low |
+
+## 10. Anti-Patterns to Avoid
+
+❌ **Feature imports feature**
+```dart
+import 'package:staff_profile/staff_profile.dart';  // in another feature
+```
+
+❌ **Business logic in BLoC**
+```dart
+on<LoginRequested>((event, emit) {
+  if (event.email.isEmpty) {  // ← Use case responsibility
+    emit(AuthError('Email required'));
+  }
+});
+```
+
+❌ **Direct Data Connect in features**
+```dart
+final response = await FirebaseDataConnect.instance.query();  // ← Use repository
+```
+
+❌ **Global state variables**
+```dart
+User? currentUser;  // ← Use SessionStore
+```
+
+❌ **Direct Navigator.push**
+```dart
+Navigator.push(context, MaterialPageRoute(...));  // ← Use Modular
+```
+
+❌ **Hardcoded navigation**
+```dart
+Modular.to.navigate('/profile');  // ← Use safe extensions
+```
+
+## Summary
+
+The architecture enforces:
+- **Clean Architecture** with strict layer boundaries
+- **Feature Isolation** via zero cross-feature imports
+- **Session Management** via DataConnectService and SessionListener
+- **Connector Pattern** for reusable backend queries
+- **BLoC Lifecycle** safety with singletons and safe emit
+- **Navigation Safety** with typed navigators and fallbacks
+
+When implementing features:
+1. Follow package structure strictly
+2. Use connector repositories for backend access
+3. Register BLoCs as singletons with `.value()`
+4. Use safe navigation extensions
+5. Avoid prop drilling with direct BLoC access
+6. Keep domain pure and stable
+
+Architecture is not negotiable. When in doubt, refer to existing well-structured features or ask for clarification.

.agent/skills/krow-mobile-design-system/SKILL.md

@@ -0,0 +1,717 @@
+---
+name: krow-mobile-design-system
+description: KROW mobile design system usage rules covering colors, typography, icons, spacing, and UI component patterns. Use this when implementing UI in KROW mobile features, matching POC designs to production, creating themed widgets, enforcing visual consistency, or reviewing UI code compliance. Prevents hardcoded values and ensures brand consistency across staff and client apps. Critical for maintaining immutable design tokens.
+---
+
+# KROW Mobile Design System Usage
+
+This skill defines mandatory standards for UI implementation using the shared `apps/mobile/packages/design_system`. All UI must consume design system tokens exclusively.
+
+## When to Use This Skill
+
+- Implementing any UI in mobile features
+- Migrating POC/prototype designs to production
+- Creating new themed widgets or components
+- Reviewing UI code for design system compliance
+- Matching colors and typography from designs
+- Adding icons, spacing, or layout elements
+- Setting up theme configuration in apps
+- Refactoring UI code with hardcoded values
+
+## Core Principle
+
+**Design tokens (colors, typography, spacing) are IMMUTABLE and defined centrally.**
+
+Features consume tokens but NEVER modify them. The design system maintains visual coherence across all apps.
+
+## 1. Design System Ownership
+
+### Centralized Authority
+
+- `apps/mobile/packages/design_system` owns:
+  - All brand assets
+  - Colors and semantic color mappings
+  - Typography and font configurations
+  - Core UI components
+  - Icons and images
+  - Spacing, radius, elevation constants
+
+### No Local Overrides
+
+**✅ CORRECT:**
+```dart
+// Feature uses design system
+import 'package:design_system/design_system.dart';
+
+Container(
+  color: UiColors.background,
+  padding: EdgeInsets.all(UiConstants.spacingL),
+  child: Text(
+    'Hello',
+    style: UiTypography.display1m,
+  ),
+)
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Custom colors in feature
+const myBlue = Color(0xFF1A2234);
+
+// ❌ Custom text styles in feature
+const myStyle = TextStyle(fontSize: 24, fontWeight: FontWeight.bold);
+
+// ❌ Theme overrides in feature
+Theme(
+  data: ThemeData(primaryColor: Colors.blue),
+  child: MyWidget(),
+)
+```
+
+### Extension Policy
+
+If a required style is missing:
+1. **FIRST:** Add it to `design_system` following existing patterns
+2. **THEN:** Use it in your feature
+
+**DO NOT** create temporary workarounds with hardcoded values.
+
+## 2. Package Structure
+
+```
+apps/mobile/packages/design_system/
+├── lib/
+│   ├── src/
+│   │   ├── ui_colors.dart          # Color tokens
+│   │   ├── ui_typography.dart      # Text styles
+│   │   ├── ui_icons.dart           # Icon exports
+│   │   ├── ui_constants.dart       # Spacing, radius, elevation
+│   │   ├── ui_theme.dart           # ThemeData factory
+│   │   └── widgets/                # Shared UI components
+│   │       ├── custom_button.dart
+│   │       └── custom_app_bar.dart
+│   └── design_system.dart          # Public exports
+├── assets/
+│   ├── icons/
+│   ├── images/
+│   └── fonts/
+└── pubspec.yaml
+```
+
+## 3. Colors Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiColors for all color needs
+Container(color: UiColors.background)
+Text('Hello', style: TextStyle(color: UiColors.foreground))
+Icon(Icons.home, color: UiColors.primary)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Hardcoded hex colors
+Container(color: Color(0xFF1A2234))
+
+// ❌ Material color constants
+Container(color: Colors.blue)
+
+// ❌ Opacity on hardcoded colors
+Container(color: Color(0xFF1A2234).withOpacity(0.5))
+```
+
+### Available Color Categories
+
+**Brand Colors:**
+- `UiColors.primary` - Main brand color
+- `UiColors.secondary` - Secondary brand color
+- `UiColors.accent` - Accent highlights
+
+**Semantic Colors:**
+- `UiColors.background` - Page background
+- `UiColors.foreground` - Primary text color
+- `UiColors.card` - Card/container background
+- `UiColors.border` - Border colors
+- `UiColors.mutedForeground` - Secondary text
+
+**Status Colors:**
+- `UiColors.success` - Success states
+- `UiColors.warning` - Warning states
+- `UiColors.error` - Error states
+- `UiColors.info` - Information states
+
+### Color Matching from POCs
+
+When migrating POC designs:
+
+1. **Find closest match** in `UiColors`
+2. **Use existing color** even if slightly different
+3. **DO NOT add new colors** without design team approval
+
+**Example Process:**
+```dart
+// POC has: Color(0xFF2C3E50)
+// Find closest: UiColors.background or UiColors.card
+// Use: UiColors.card
+
+// POC has: Color(0xFF27AE60)
+// Find closest: UiColors.success
+// Use: UiColors.success
+```
+
+### Theme Access
+
+Colors can also be accessed via theme:
+```dart
+// Both are valid:
+Container(color: UiColors.primary)
+Container(color: Theme.of(context).colorScheme.primary)
+```
+
+## 4. Typography Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiTypography for all text
+Text('Title', style: UiTypography.display1m)
+Text('Body', style: UiTypography.body1r)
+Text('Label', style: UiTypography.caption1m)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Custom TextStyle
+Text('Title', style: TextStyle(
+  fontSize: 24,
+  fontWeight: FontWeight.bold,
+))
+
+// ❌ Manual font configuration
+Text('Body', style: TextStyle(
+  fontFamily: 'Inter',
+  fontSize: 16,
+))
+
+// ❌ Modifying existing styles inline
+Text('Title', style: UiTypography.display1m.copyWith(
+  fontSize: 28,  // ← Don't override size
+))
+```
+
+### Available Typography Styles
+
+**Display Styles (Large Headers):**
+- `UiTypography.display1m` - Display Medium
+- `UiTypography.display1sb` - Display Semi-Bold
+- `UiTypography.display1b` - Display Bold
+
+**Heading Styles:**
+- `UiTypography.heading1m` - H1 Medium
+- `UiTypography.heading1sb` - H1 Semi-Bold
+- `UiTypography.heading1b` - H1 Bold
+- `UiTypography.heading2m` - H2 Medium
+- `UiTypography.heading2sb` - H2 Semi-Bold
+
+**Body Styles:**
+- `UiTypography.body1r` - Body Regular
+- `UiTypography.body1m` - Body Medium
+- `UiTypography.body1sb` - Body Semi-Bold
+- `UiTypography.body2r` - Body 2 Regular
+
+**Caption/Label Styles:**
+- `UiTypography.caption1m` - Caption Medium
+- `UiTypography.caption1sb` - Caption Semi-Bold
+- `UiTypography.label1m` - Label Medium
+
+### Allowed Customizations
+
+**✅ ALLOWED (Color Only):**
+```dart
+// You MAY change color
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(
+    color: UiColors.error,  // ← OK
+  ),
+)
+```
+
+**❌ FORBIDDEN (Size, Weight, Family):**
+```dart
+// ❌ Don't change size
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontSize: 28),
+)
+
+// ❌ Don't change weight
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontWeight: FontWeight.w900),
+)
+
+// ❌ Don't change family
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontFamily: 'Roboto'),
+)
+```
+
+### Typography Matching from POCs
+
+When migrating:
+1. Identify text role (heading, body, caption)
+2. Find closest matching style in `UiTypography`
+3. Use existing style even if size/weight differs slightly
+
+## 5. Icons Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiIcons
+Icon(UiIcons.home)
+Icon(UiIcons.profile)
+Icon(UiIcons.chevronLeft)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Direct icon library imports
+import 'package:lucide_icons/lucide_icons.dart';
+Icon(LucideIcons.home)
+
+// ❌ Font Awesome direct
+import 'package:font_awesome_flutter/font_awesome_flutter.dart';
+FaIcon(FontAwesomeIcons.house)
+```
+
+### Why Centralize Icons?
+
+1. **Consistency:** Same icon for same action everywhere
+2. **Branding:** Unified icon set with consistent stroke weight
+3. **Swappability:** Change icon library in one place
+
+### Icon Libraries
+
+Design system uses:
+- `typedef _IconLib = LucideIcons;` (primary)
+- `typedef _IconLib2 = FontAwesomeIcons;` (secondary)
+
+**Features MUST NOT import these directly.**
+
+### Adding New Icons
+
+If icon missing:
+1. Add to `ui_icons.dart`:
+```dart
+class UiIcons {
+  static const home = _IconLib.home;
+  static const newIcon = _IconLib.newIcon;  // Add here
+}
+```
+2. Use in feature:
+```dart
+Icon(UiIcons.newIcon)
+```
+
+## 6. Spacing & Layout Constants
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiConstants for spacing
+Padding(padding: EdgeInsets.all(UiConstants.spacingL))
+SizedBox(height: UiConstants.spacingM)
+Container(
+  padding: EdgeInsets.symmetric(
+    horizontal: UiConstants.spacingL,
+    vertical: UiConstants.spacingM,
+  ),
+)
+
+// Use UiConstants for radius
+Container(
+  decoration: BoxDecoration(
+    borderRadius: BorderRadius.circular(UiConstants.radiusM),
+  ),
+)
+
+// Use UiConstants for elevation
+elevation: UiConstants.elevationLow
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Magic numbers
+Padding(padding: EdgeInsets.all(16.0))
+SizedBox(height: 24.0)
+BorderRadius.circular(8.0)
+elevation: 2.0
+```
+
+### Available Constants
+
+**Spacing:**
+```dart
+UiConstants.spacingXs   // Extra small
+UiConstants.spacingS    // Small
+UiConstants.spacingM    // Medium
+UiConstants.spacingL    // Large
+UiConstants.spacingXl   // Extra large
+UiConstants.spacing2xl  // 2x Extra large
+```
+
+**Border Radius:**
+```dart
+UiConstants.radiusS     // Small
+UiConstants.radiusM     // Medium
+UiConstants.radiusL     // Large
+UiConstants.radiusXl    // Extra large
+UiConstants.radiusFull  // Fully rounded
+```
+
+**Elevation:**
+```dart
+UiConstants.elevationNone
+UiConstants.elevationLow
+UiConstants.elevationMedium
+UiConstants.elevationHigh
+```
+
+## 7. Smart Widgets Usage
+
+### When to Use
+
+- **Prefer standard Flutter Material widgets** styled via theme
+- **Use design system widgets** for non-standard patterns
+- **Create new widgets** in design system if reused >3 features
+
+### Navigation in Widgets
+
+Widgets with navigation MUST use safe methods:
+
+**✅ CORRECT:**
+```dart
+// In UiAppBar back button:
+import 'package:flutter_modular/flutter_modular.dart';
+import 'package:krow_core/krow_core.dart';
+
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Modular.to.popSafe(),  // ← Safe pop
+)
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Direct Navigator
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Navigator.pop(context),
+)
+
+// ❌ Unsafe Modular
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Modular.to.pop(),  // Can crash
+)
+```
+
+### Composition Over Inheritance
+
+**✅ CORRECT:**
+```dart
+// Compose standard widgets
+Container(
+  padding: EdgeInsets.all(UiConstants.spacingL),
+  decoration: BoxDecoration(
+    color: UiColors.card,
+    borderRadius: BorderRadius.circular(UiConstants.radiusM),
+  ),
+  child: Column(
+    children: [
+      Text('Title', style: UiTypography.heading1sb),
+      SizedBox(height: UiConstants.spacingM),
+      Text('Body', style: UiTypography.body1r),
+    ],
+  ),
+)
+```
+
+**❌ AVOID:**
+```dart
+// ❌ Deep custom widget hierarchies
+class CustomCard extends StatelessWidget {
+  // Complex custom implementation
+}
+```
+
+## 8. Theme Configuration
+
+### App Setup
+
+Apps initialize theme ONCE in root MaterialApp:
+
+**✅ CORRECT:**
+```dart
+// apps/mobile/apps/staff/lib/app_widget.dart
+import 'package:design_system/design_system.dart';
+
+class StaffApp extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp.router(
+      theme: StaffTheme.light,  // ← Design system theme
+      darkTheme: StaffTheme.dark,  // ← Optional dark mode
+      themeMode: ThemeMode.system,
+      // ...
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Custom theme in app
+MaterialApp.router(
+  theme: ThemeData(
+    primaryColor: Colors.blue,  // ← NO!
+  ),
+)
+
+// ❌ Theme override in feature
+Theme(
+  data: ThemeData(...),
+  child: MyFeatureWidget(),
+)
+```
+
+### Accessing Theme
+
+**Both methods valid:**
+```dart
+// Method 1: Direct design system import
+import 'package:design_system/design_system.dart';
+Text('Hello', style: UiTypography.body1r)
+
+// Method 2: Via theme context
+Text('Hello', style: Theme.of(context).textTheme.bodyMedium)
+```
+
+**Prefer Method 1** for explicit type safety.
+
+## 9. POC → Production Workflow
+
+### Step 1: Implement Structure (POC Matching)
+
+Implement UI layout exactly matching POC:
+```dart
+// Temporary: Match POC visually
+Container(
+  color: Color(0xFF1A2234),  // ← POC color
+  padding: EdgeInsets.all(16.0),  // ← POC spacing
+  child: Text(
+    'Title',
+    style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),  // ← POC style
+  ),
+)
+```
+
+**Purpose:** Ensure visual parity with POC before refactoring.
+
+### Step 2: Architecture Refactor
+
+Move to Clean Architecture:
+- Extract business logic to use cases
+- Move state management to BLoCs
+- Implement repository pattern
+- Use dependency injection
+
+### Step 3: Design System Integration
+
+Replace hardcoded values:
+```dart
+// Production: Design system tokens
+Container(
+  color: UiColors.background,  // ← Found closest match
+  padding: EdgeInsets.all(UiConstants.spacingL),  // ← Used constant
+  child: Text(
+    'Title',
+    style: UiTypography.heading1sb,  // ← Matched typography
+  ),
+)
+```
+
+**Color Matching:**
+- POC `#1A2234` → `UiColors.background`
+- POC `#3498DB` → `UiColors.primary`
+- POC `#27AE60` → `UiColors.success`
+
+**Typography Matching:**
+- POC `24px bold` → `UiTypography.heading1sb`
+- POC `16px regular` → `UiTypography.body1r`
+- POC `14px medium` → `UiTypography.caption1m`
+
+**Spacing Matching:**
+- POC `16px` → `UiConstants.spacingL`
+- POC `8px` → `UiConstants.spacingM`
+- POC `4px` → `UiConstants.spacingS`
+
+## 10. Anti-Patterns & Common Mistakes
+
+### ❌ Magic Numbers
+```dart
+// BAD
+EdgeInsets.all(12.0)
+SizedBox(height: 24.0)
+BorderRadius.circular(8.0)
+
+// GOOD
+EdgeInsets.all(UiConstants.spacingM)
+SizedBox(height: UiConstants.spacingL)
+BorderRadius.circular(UiConstants.radiusM)
+```
+
+### ❌ Local Themes
+```dart
+// BAD
+Theme(
+  data: ThemeData(primaryColor: Colors.blue),
+  child: MyWidget(),
+)
+
+// GOOD
+// Use global theme defined in app
+```
+
+### ❌ Hex Hunting
+```dart
+// BAD: Copy-paste from Figma
+Container(color: Color(0xFF3498DB))
+
+// GOOD: Find matching design system color
+Container(color: UiColors.primary)
+```
+
+### ❌ Direct Icon Library
+```dart
+// BAD
+import 'package:lucide_icons/lucide_icons.dart';
+Icon(LucideIcons.home)
+
+// GOOD
+Icon(UiIcons.home)
+```
+
+### ❌ Custom Text Styles
+```dart
+// BAD
+Text('Title', style: TextStyle(
+  fontSize: 24,
+  fontWeight: FontWeight.bold,
+  fontFamily: 'Inter',
+))
+
+// GOOD
+Text('Title', style: UiTypography.heading1sb)
+```
+
+## 11. Design System Review Checklist
+
+Before merging UI code:
+
+### ✅ Design System Compliance
+- [ ] No hardcoded `Color(...)` or `0xFF...` hex values
+- [ ] No custom `TextStyle(...)` definitions
+- [ ] All spacing uses `UiConstants.spacing*`
+- [ ] All radius uses `UiConstants.radius*`
+- [ ] All elevation uses `UiConstants.elevation*`
+- [ ] All icons from `UiIcons`, not direct library imports
+- [ ] Theme consumed from design system, no local overrides
+- [ ] Layout matches POC intent using design system primitives
+
+### ✅ Architecture Compliance
+- [ ] No business logic in widgets
+- [ ] State managed by BLoCs
+- [ ] Navigation uses Modular safe extensions
+- [ ] Localization used for all text (no hardcoded strings)
+- [ ] No direct Data Connect queries in widgets
+
+### ✅ Code Quality
+- [ ] Widget build methods concise (<50 lines)
+- [ ] Complex widgets extracted to separate files
+- [ ] Meaningful widget names
+- [ ] Doc comments on reusable widgets
+
+## 12. When to Extend Design System
+
+### Add New Color
+**When:** New brand color approved by design team
+
+**Process:**
+1. Add to `ui_colors.dart`:
+```dart
+class UiColors {
+  static const myNewColor = Color(0xFF123456);
+}
+```
+2. Update theme if needed
+3. Use in features
+
+### Add New Typography Style
+**When:** New text style pattern emerges across multiple features
+
+**Process:**
+1. Add to `ui_typography.dart`:
+```dart
+class UiTypography {
+  static const myNewStyle = TextStyle(
+    fontSize: 20,
+    fontWeight: FontWeight.w600,
+    fontFamily: _fontFamily,
+  );
+}
+```
+2. Use in features
+
+### Add Shared Widget
+**When:** Widget reused in 3+ features
+
+**Process:**
+1. Create in `lib/src/widgets/`:
+```dart
+// my_widget.dart
+class MyWidget extends StatelessWidget {
+  // Implementation using design system tokens
+}
+```
+2. Export from `design_system.dart`
+3. Use across features
+
+## Summary
+
+**Core Rules:**
+1. **All colors from `UiColors`** - Zero hex codes in features
+2. **All typography from `UiTypography`** - Zero custom TextStyle
+3. **All spacing/radius/elevation from `UiConstants`** - Zero magic numbers
+4. **All icons from `UiIcons`** - Zero direct library imports
+5. **Theme defined once** in app entry point
+6. **POC → Production** requires design system integration step
+
+**The Golden Rule:** Design system is immutable. Features adapt to the system, not the other way around.
+
+When implementing UI:
+1. Import `package:design_system/design_system.dart`
+2. Use design system tokens exclusively
+3. Match POC intent with available tokens
+4. Request new tokens only when truly necessary
+5. Never create temporary hardcoded workarounds
+
+Visual consistency is non-negotiable. Every pixel must come from the design system.

.agent/skills/krow-mobile-development-rules/SKILL.md

@@ -0,0 +1,646 @@
+---
+name: krow-mobile-development-rules
+description: Enforce KROW mobile app development standards including file structure, naming conventions, logic placement boundaries, localization, Data Connect integration, and prototype migration rules. Use this skill whenever working on KROW Flutter mobile features, creating new packages, implementing BLoCs, integrating with backend, or migrating from prototypes. Critical for maintaining clean architecture and preventing architectural degradation.
+---
+
+# KROW Mobile Development Rules
+
+These rules are **NON-NEGOTIABLE** enforcement guidelines for the KROW mobile application. They prevent architectural degradation and ensure consistency across the codebase.
+
+## When to Use This Skill
+
+- Creating new mobile features or packages
+- Implementing BLoCs, Use Cases, or Repositories
+- Integrating with Firebase Data Connect backend
+- Migrating code from prototypes
+- Reviewing mobile code for compliance
+- Setting up new feature modules
+- Handling user sessions and authentication
+- Implementing navigation flows
+
+## 1. File Creation & Package Structure
+
+### Feature-First Packaging
+
+**✅ DO:**
+- Create new features as independent packages:
+  ```
+  apps/mobile/packages/features/<app_name>/<feature_name>/
+  ├── lib/
+  │   ├── src/
+  │   │   ├── domain/
+  │   │   │   ├── repositories/
+  │   │   │   └── usecases/
+  │   │   ├── data/
+  │   │   │   └── repositories_impl/
+  │   │   └── presentation/
+  │   │       ├── blocs/
+  │   │       ├── pages/
+  │   │       └── widgets/
+  │   └── <feature_name>.dart  # Barrel file
+  └── pubspec.yaml
+  ```
+
+**❌ DON'T:**
+- Add features to `apps/mobile/packages/core` directly
+- Create files in app directories (`apps/mobile/apps/client/` or `apps/mobile/apps/staff/`)
+- Create cross-feature or cross-app dependencies (features must not import other features)
+
+### Path Conventions (Strict)
+
+Follow these exact paths:
+
+| Layer | Path Pattern | Example |
+|-------|-------------|---------|
+| **Entities** | `apps/mobile/packages/domain/lib/src/entities/<entity>.dart` | `user.dart`, `shift.dart` |
+| **Repository Interface** | `.../features/<app>/<feature>/lib/src/domain/repositories/<name>_repository_interface.dart` | `auth_repository_interface.dart` |
+| **Repository Impl** | `.../features/<app>/<feature>/lib/src/data/repositories_impl/<name>_repository_impl.dart` | `auth_repository_impl.dart` |
+| **Use Cases** | `.../features/<app>/<feature>/lib/src/application/<name>_usecase.dart` | `login_usecase.dart` |
+| **BLoCs** | `.../features/<app>/<feature>/lib/src/presentation/blocs/<name>_bloc.dart` | `auth_bloc.dart` |
+| **Pages** | `.../features/<app>/<feature>/lib/src/presentation/pages/<name>_page.dart` | `login_page.dart` |
+| **Widgets** | `.../features/<app>/<feature>/lib/src/presentation/widgets/<name>_widget.dart` | `password_field.dart` |
+
+### Barrel Files
+
+**✅ DO:**
+```dart
+// lib/auth_feature.dart
+export 'src/presentation/pages/login_page.dart';
+export 'src/domain/repositories/auth_repository_interface.dart';
+// Only export PUBLIC API
+```
+
+**❌ DON'T:**
+```dart
+// Don't export internal implementation details
+export 'src/data/repositories_impl/auth_repository_impl.dart';
+export 'src/presentation/blocs/auth_bloc.dart';
+```
+
+## 2. Naming Conventions (Dart Standard)
+
+| Type | Convention | Example | File Name |
+|------|-----------|---------|-----------|
+| **Files** | `snake_case` | `user_profile_page.dart` | - |
+| **Classes** | `PascalCase` | `UserProfilePage` | - |
+| **Variables** | `camelCase` | `userProfile` | - |
+| **Interfaces** | End with `Interface` | `AuthRepositoryInterface` | `auth_repository_interface.dart` |
+| **Implementations** | End with `Impl` | `AuthRepositoryImpl` | `auth_repository_impl.dart` |
+| **BLoCs** | End with `Bloc` or `Cubit` | `AuthBloc`, `ProfileCubit` | `auth_bloc.dart` |
+| **Use Cases** | End with `UseCase` | `LoginUseCase` | `login_usecase.dart` |
+
+## 3. Logic Placement (Zero Tolerance Boundaries)
+
+### Business Rules → Use Cases ONLY
+
+**✅ CORRECT:**
+```dart
+// login_usecase.dart
+class LoginUseCase extends UseCase<User, LoginParams> {
+  @override
+  Future<Either<Failure, User>> call(LoginParams params) async {
+    // Business logic here: validation, transformation, orchestration
+    if (params.email.isEmpty) {
+      return Left(ValidationFailure('Email required'));
+    }
+    return await repository.login(params);
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Business logic in BLoC
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) {
+    if (event.email.isEmpty) {  // ← NO! This is business logic
+      emit(AuthError('Email required'));
+    }
+  });
+}
+
+// ❌ Business logic in Widget
+class LoginPage extends StatelessWidget {
+  void _login() {
+    if (_emailController.text.isEmpty) {  // ← NO! This is business logic
+      showSnackbar('Email required');
+    }
+  }
+}
+```
+
+### State Logic → BLoCs ONLY
+
+**✅ CORRECT:**
+```dart
+// auth_bloc.dart
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) async {
+    emit(AuthLoading());
+    final result = await loginUseCase(LoginParams(email: event.email));
+    result.fold(
+      (failure) => emit(AuthError(failure)),
+      (user) => emit(AuthAuthenticated(user)),
+    );
+  });
+}
+
+// login_page.dart (StatelessWidget)
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<AuthBloc, AuthState>(
+      builder: (context, state) {
+        if (state is AuthLoading) return LoadingIndicator();
+        if (state is AuthError) return ErrorWidget(state.message);
+        return LoginForm();
+      },
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ setState in Pages for complex state
+class LoginPage extends StatefulWidget {
+  @override
+  State<LoginPage> createState() => _LoginPageState();
+}
+
+class _LoginPageState extends State<LoginPage> {
+  bool _isLoading = false;  // ← NO! Use BLoC
+  String? _error;          // ← NO! Use BLoC
+  
+  void _login() {
+    setState(() => _isLoading = true);  // ← NO! Use BLoC
+  }
+}
+```
+
+**RECOMMENDATION:** Pages should be `StatelessWidget` with state delegated to BLoCs.
+
+### Data Transformation → Repositories
+
+**✅ CORRECT:**
+```dart
+// profile_repository_impl.dart
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  @override
+  Future<Staff> getProfile(String id) async {
+    final response = await dataConnect.getStaffById(id: id).execute();
+    // Data transformation happens here
+    return Staff(
+      id: response.data.staff.id,
+      name: response.data.staff.name,
+      // Map Data Connect model to Domain entity
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ JSON parsing in UI
+class ProfilePage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    final json = jsonDecode(response.body);  // ← NO!
+    final name = json['name'];
+  }
+}
+
+// ❌ JSON parsing in Domain Use Case
+class GetProfileUseCase extends UseCase<Staff, String> {
+  @override
+  Future<Either<Failure, Staff>> call(String id) async {
+    final response = await http.get('/staff/$id');
+    final json = jsonDecode(response.body);  // ← NO!
+  }
+}
+```
+
+### Navigation → Flutter Modular + Safe Extensions
+
+**✅ CORRECT:**
+```dart
+// Use Safe Navigation Extensions
+import 'package:krow_core/krow_core.dart';
+
+// In widget/BLoC:
+Modular.to.safePush('/profile');
+Modular.to.safeNavigate('/home');
+Modular.to.popSafe();
+
+// Even better: Use Typed Navigators
+Modular.to.toStaffHome();  // Defined in StaffNavigator
+Modular.to.toShiftDetails(shiftId: '123');
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Direct Navigator.push
+Navigator.push(
+  context,
+  MaterialPageRoute(builder: (_) => ProfilePage()),
+);
+
+// ❌ Direct Modular navigation without safety
+Modular.to.navigate('/profile');  // ← Can cause blank screens
+Modular.to.pop();  // ← Can crash if stack is empty
+```
+
+**PATTERN:** All navigation MUST have fallback to Home page. Safe extensions automatically handle this.
+
+### Session Management → DataConnectService + SessionHandlerMixin
+
+**✅ CORRECT:**
+```dart
+// In main.dart:
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  // Initialize session listener (pick allowed roles for app)
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['STAFF', 'BOTH'],  // for staff app
+  );
+  
+  runApp(
+    SessionListener(  // Wraps entire app
+      child: ModularApp(module: AppModule(), child: AppWidget()),
+    ),
+  );
+}
+
+// In repository:
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    // _service.run() handles:
+    // - Auth validation
+    // - Token refresh (if <5 min to expiry)
+    // - Error handling with 3 retries
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**PATTERN:**
+- **SessionListener** widget wraps app and shows dialogs for session errors
+- **SessionHandlerMixin** in `DataConnectService` provides automatic token refresh
+- **3-attempt retry logic** with exponential backoff (1s → 2s → 4s)
+- **Role validation** configurable per app
+
+## 4. Localization Integration (core_localization)
+
+All user-facing text MUST be localized.
+
+### String Management
+
+**✅ CORRECT:**
+```dart
+// In presentation layer:
+import 'package:core_localization/core_localization.dart';
+
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Text(context.strings.loginButton);  // ← From localization
+    return ElevatedButton(
+      onPressed: _login,
+      child: Text(context.strings.submit),
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Hardcoded English strings
+Text('Login')
+Text('Submit')
+ElevatedButton(child: Text('Click here'))
+```
+
+### BLoC Integration
+
+**✅ CORRECT:**
+```dart
+// BLoCs emit domain failures (not localized strings)
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) async {
+    final result = await loginUseCase(params);
+    result.fold(
+      (failure) => emit(AuthError(failure)),  // ← Domain failure
+      (user) => emit(AuthAuthenticated(user)),
+    );
+  });
+}
+
+// UI translates failures to user-friendly messages
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<AuthBloc, AuthState>(
+      builder: (context, state) {
+        if (state is AuthError) {
+          final message = ErrorTranslator.translate(
+            state.failure,
+            context.strings,
+          );
+          return ErrorWidget(message);  // ← Localized
+        }
+      },
+    );
+  }
+}
+```
+
+### App Setup
+
+Apps must import `LocalizationModule()`:
+```dart
+// app_module.dart
+class AppModule extends Module {
+  @override
+  List<Module> get imports => [
+    LocalizationModule(),  // ← Required
+    DataConnectModule(),
+  ];
+}
+
+// main.dart
+runApp(
+  BlocProvider<LocaleBloc>(  // ← Expose locale state
+    create: (_) => Modular.get<LocaleBloc>(),
+    child: TranslationProvider(  // ← Enable context.strings
+      child: MaterialApp.router(...),
+    ),
+  ),
+);
+```
+
+## 5. Data Connect Integration
+
+All backend access goes through `DataConnectService`.
+
+### Repository Pattern
+
+**Step 1:** Define interface in feature domain:
+```dart
+// domain/repositories/profile_repository_interface.dart
+abstract interface class ProfileRepositoryInterface {
+  Future<Staff> getProfile(String id);
+  Future<bool> updateProfile(Staff profile);
+}
+```
+
+**Step 2:** Implement using `DataConnectService.run()`:
+```dart
+// data/repositories_impl/profile_repository_impl.dart
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**Benefits of `_service.run()`:**
+- ✅ Automatic auth validation
+- ✅ Token refresh if needed
+- ✅ 3-attempt retry with exponential backoff
+- ✅ Consistent error handling
+
+### Session Store Pattern
+
+After successful auth, populate session stores:
+```dart
+// For Staff App:
+StaffSessionStore.instance.setSession(
+  StaffSession(
+    user: user,
+    staff: staff,
+    ownerId: ownerId,
+  ),
+);
+
+// For Client App:
+ClientSessionStore.instance.setSession(
+  ClientSession(
+    user: user,
+    business: business,
+  ),
+);
+```
+
+**Lazy Loading:** If session is null, fetch via `getStaffById()` or `getBusinessById()` and update store.
+
+## 6. Prototype Migration Rules
+
+When migrating from `prototypes/`:
+
+### ✅ MAY Copy
+- Icons, images, assets (but match to design system)
+- `build` methods for UI layout structure
+- Screen flow and navigation patterns
+
+### ❌ MUST REJECT & REFACTOR
+- `GetX`, `Provider`, or `MVC` patterns
+- Any state management not using BLoC
+- Direct HTTP calls (must use Data Connect)
+- Hardcoded colors/typography (must use design system)
+- Global state variables
+- Navigation without Modular
+
+### Colors & Typography Migration
+**When matching POC to production:**
+1. Find closest color in `UiColors` (don't add new colors without approval)
+2. Find closest text style in `UiTypography`
+3. Use design system constants, NOT POC hardcoded values
+
+**DO NOT change the design system itself.** Colors and typography are FINAL. Match your feature to the system, not the other way around.
+
+## 7. Handling Ambiguity
+
+If requirements are unclear:
+
+1. **STOP** - Don't guess domain fields or workflows
+2. **ANALYZE** - Refer to:
+   - Architecture: `apps/mobile/docs/01-architecture-principles.md`
+   - Design System: `apps/mobile/docs/02-design-system-usage.md`
+   - Existing features for patterns
+3. **DOCUMENT** - Add `// ASSUMPTION: <explanation>` if you must proceed
+4. **ASK** - Prefer asking user for clarification on business rules
+
+## 8. Dependencies
+
+### DO NOT
+- Add 3rd party packages without checking `apps/mobile/packages/core` first
+- Add `firebase_auth` or `firebase_data_connect` to Feature packages (they belong in `data_connect` only)
+- Use `addSingleton` for BLoCs (always use `add` method in Modular)
+
+### DO
+- Use `DataConnectService.instance` for backend operations
+- Use Flutter Modular for dependency injection
+- Register BLoCs with `i.addSingleton<CubitType>(() => CubitType(...))`
+- Register Use Cases as factories or singletons as needed
+
+## 9. Error Handling Pattern
+
+### Domain Failures
+```dart
+// domain/failures/auth_failure.dart
+abstract class AuthFailure extends Failure {
+  const AuthFailure(String message) : super(message);
+}
+
+class InvalidCredentialsFailure extends AuthFailure {
+  const InvalidCredentialsFailure() : super('Invalid credentials');
+}
+```
+
+### Repository Error Mapping
+```dart
+// Map Data Connect exceptions to Domain failures
+try {
+  final response = await dataConnect.query();
+  return Right(response);
+} on DataConnectException catch (e) {
+  if (e.message.contains('unauthorized')) {
+    return Left(InvalidCredentialsFailure());
+  }
+  return Left(ServerFailure(e.message));
+}
+```
+
+### UI Feedback
+```dart
+// BLoC emits error state
+emit(AuthError(failure));
+
+// UI shows user-friendly message
+if (state is AuthError) {
+  final message = ErrorTranslator.translate(state.failure, context.strings);
+  ScaffoldMessenger.of(context).showSnackBar(
+    SnackBar(content: Text(message)),
+  );
+}
+```
+
+### Session Errors
+`SessionListener` automatically shows dialogs for:
+- Session expiration
+- Token refresh failures
+- Network errors during auth
+
+## 10. Testing Requirements
+
+### Unit Tests
+```dart
+// Test use cases with real repository implementations
+test('login with valid credentials returns user', () async {
+  final useCase = LoginUseCase(repository: mockRepository);
+  final result = await useCase(LoginParams(email: 'test@test.com'));
+  expect(result.isRight(), true);
+});
+```
+
+### Widget Tests
+```dart
+// Test UI widgets and BLoC interactions
+testWidgets('shows loading indicator when logging in', (tester) async {
+  await tester.pumpWidget(
+    BlocProvider<AuthBloc>(
+      create: (_) => authBloc,
+      child: LoginPage(),
+    ),
+  );
+  
+  authBloc.add(LoginRequested(email: 'test@test.com'));
+  await tester.pump();
+  
+  expect(find.byType(LoadingIndicator), findsOneWidget);
+});
+```
+
+### Integration Tests
+- Test full feature flows end-to-end with Data Connect
+- Use dependency injection to swap implementations if needed
+
+## 11. Clean Code Principles
+
+### Documentation
+- ✅ Add human readable doc comments for `dartdoc`  for all classes and methods.
+```dart
+/// Authenticates user with email and password.
+/// 
+/// Returns [User] on success or [AuthFailure] on failure.
+/// Throws [NetworkException] if connection fails.
+class LoginUseCase extends UseCase<User, LoginParams> {
+  // ...
+}
+```
+
+### Single Responsibility
+- Keep methods focused on one task
+- Extract complex logic to separate methods
+- Keep widget build methods concise
+- Extract complex widgets to separate files
+
+### Meaningful Names
+```dart
+// ✅ GOOD
+final isProfileComplete = await checkProfileCompletion();
+final userShifts = await fetchUserShifts();
+
+// ❌ BAD
+final flag = await check();
+final data = await fetch();
+```
+
+## Enforcement Checklist
+
+Before merging any mobile feature code:
+
+### Architecture Compliance
+- [ ] Feature follows package structure (domain/data/presentation)
+- [ ] No business logic in BLoCs or Widgets
+- [ ] All state management via BLoCs
+- [ ] All backend access via repositories
+- [ ] Session accessed via SessionStore, not global state
+- [ ] Navigation uses Flutter Modular safe extensions
+- [ ] No feature-to-feature imports
+
+### Code Quality
+- [ ] No hardcoded strings (use localization)
+- [ ] No hardcoded colors/typography (use design system)
+- [ ] All spacing uses UiConstants
+- [ ] Doc comments on public APIs
+- [ ] Meaningful variable names
+- [ ] Zero analyzer warnings
+
+### Integration
+- [ ] Data Connect queries via `_service.run()`
+- [ ] Error handling with domain failures
+- [ ] Proper dependency injection in modules
+
+## Summary
+
+The key principle: **Clean Architecture with zero tolerance for violations.** Business logic in Use Cases, state in BLoCs, data access in Repositories, UI in Widgets. Features are isolated, backend is centralized, localization is mandatory, and design system is immutable.
+
+When in doubt, refer to existing features following these patterns or ask for clarification. It's better to ask than to introduce architectural debt.

.agent/skills/krow-mobile-release/SKILL.md

@@ -0,0 +1,778 @@
+---
+name: krow-mobile-release
+description: KROW mobile app release process including versioning strategy, CHANGELOG management, GitHub Actions workflows, APK signing, Git tagging, and hotfix procedures. Use this when preparing mobile releases, updating CHANGELOGs, triggering release workflows, creating hotfix branches, troubleshooting release issues, or documenting release features. Covers both staff (worker) and client mobile products across dev/stage/prod environments.
+---
+
+# KROW Mobile Release Process
+
+This skill defines the comprehensive release process for KROW mobile applications (staff and client). It covers versioning, changelog management, GitHub Actions automation, and hotfix procedures.
+
+## When to Use This Skill
+
+- Preparing for a mobile app release
+- Updating CHANGELOG files with new features
+- Triggering GitHub Actions release workflows
+- Creating hotfix branches for production issues
+- Understanding version numbering strategy
+- Setting up APK signing secrets
+- Troubleshooting release workflow failures
+- Documenting release notes
+- Managing release cadence (dev → stage → prod)
+
+## Quick Reference
+
+### Release Workflows
+- **Product Release:** [GitHub Actions - Product Release](https://github.com/Oloodi/krow-workforce/actions/workflows/product-release.yml)
+- **Hotfix Creation:** [GitHub Actions - Product Hotfix](https://github.com/Oloodi/krow-workforce/actions/workflows/hotfix-branch-creation.yml)
+
+### Key Files
+- **Staff CHANGELOG:** `apps/mobile/apps/staff/CHANGELOG.md`
+- **Client CHANGELOG:** `apps/mobile/apps/client/CHANGELOG.md`
+- **Staff Version:** `apps/mobile/apps/staff/pubspec.yaml`
+- **Client Version:** `apps/mobile/apps/client/pubspec.yaml`
+
+### Comprehensive Documentation
+For complete details, see: [`docs/RELEASE/mobile-releases.md`](docs/RELEASE/mobile-releases.md) (900+ lines)
+
+## 1. Versioning Strategy
+
+### Format
+
+```
+v{major}.{minor}.{patch}-{milestone}
+```
+
+**Examples:**
+- `v0.0.1-m4` - Milestone 4 release
+- `v0.1.0-m5` - Minor version bump for Milestone 5
+- `v1.0.0` - First production release (no milestone suffix)
+
+### Semantic Versioning Rules
+
+**Major (X.0.0):**
+- Breaking changes
+- Complete architecture overhaul
+- Incompatible API changes
+
+**Minor (0.X.0):**
+- New features
+- Backwards-compatible additions
+- Milestone completions
+
+**Patch (0.0.X):**
+- Bug fixes
+- Security patches
+- Performance improvements
+
+**Milestone Suffix:**
+- `-m1`, `-m2`, `-m3`, `-m4`, etc.
+- Indicates pre-production milestone phase
+- Removed for production releases
+
+### Version Location
+
+Versions are defined in `pubspec.yaml`:
+
+**Staff App:**
+```yaml
+# apps/mobile/apps/staff/pubspec.yaml
+name: krow_staff_app
+version: 0.0.1-m4+1  # version+build_number
+```
+
+**Client App:**
+```yaml
+# apps/mobile/apps/client/pubspec.yaml
+name: krow_client_app
+version: 0.0.1-m4+1
+```
+
+**Format:** `version+build`
+- `version`: Semantic version with milestone (e.g., `0.0.1-m4`)
+- `build`: Build number (increments with each build, e.g., `+1`, `+2`)
+
+## 2. CHANGELOG Management
+
+### Format
+
+Each app maintains a separate CHANGELOG following [Keep a Changelog](https://keepachangelog.com/) format.
+
+**Structure:**
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+### Added
+- New feature descriptions
+
+### Changed
+- Modified feature descriptions
+
+### Fixed
+- Bug fix descriptions
+
+### Removed
+- Removed feature descriptions
+
+## [0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added
+- Profile management with 13 subsections
+- Documents & certificates management
+- Benefits overview section
+- Camera/gallery support for attire verification
+
+### Changed
+- Enhanced session management with auto token refresh
+
+### Fixed
+- Navigation fallback to home on invalid routes
+```
+
+### Section Guidelines
+
+**[Unreleased]**
+- Work in progress
+- Features merged to dev but not released
+- Updated continuously during development
+
+**[Version] - Milestone X - Date**
+- Released version
+- Format: `[X.Y.Z-mN] - Milestone N - YYYY-MM-DD`
+- Organized by change type (Added/Changed/Fixed/Removed)
+
+### Change Type Definitions
+
+**Added:**
+- New features
+- New UI screens
+- New API integrations
+- New user-facing capabilities
+
+**Changed:**
+- Modifications to existing features
+- UI/UX improvements
+- Performance enhancements
+- Refactored code (if user-facing impact)
+
+**Fixed:**
+- Bug fixes
+- Error handling improvements
+- Crash fixes
+- UI/UX issues resolved
+
+**Removed:**
+- Deprecated features
+- Removed screens or capabilities
+- Discontinued integrations
+
+### Writing Guidelines
+
+**✅ GOOD:**
+```markdown
+### Added
+- Profile management with 13 subsections organized into onboarding, compliance, finances, and support categories
+- Documents & certificates management with upload, status tracking, and expiry dates
+- Camera and gallery support for attire verification with photo capture
+- Benefits overview section displaying perks and company information
+```
+
+**❌ BAD:**
+```markdown
+### Added
+- New stuff
+- Fixed things
+- Updated code
+```
+
+**Key Principles:**
+- Be specific and descriptive
+- Focus on user-facing changes
+- Mention UI screens, features, or capabilities
+- Avoid technical jargon users won't understand
+- Group related changes together
+
+### Updating CHANGELOG Workflow
+
+**Step 1:** During development, add to `[Unreleased]`:
+```markdown
+## [Unreleased]
+
+### Added
+- New shift calendar view with month/week toggle
+- Shift acceptance confirmation dialog
+
+### Fixed
+- Navigation crash when popping empty stack
+```
+
+**Step 2:** Before release, move to version section:
+```markdown
+## [0.1.0-m5] - Milestone 5 - 2026-03-15
+
+### Added
+- New shift calendar view with month/week toggle
+- Shift acceptance confirmation dialog
+
+### Fixed
+- Navigation crash when popping empty stack
+
+## [Unreleased]
+<!-- Empty for next development cycle -->
+```
+
+**Step 3:** Update version in `pubspec.yaml`:
+```yaml
+version: 0.1.0-m5+1
+```
+
+## 3. Git Tagging Strategy
+
+### Tag Format
+
+```
+krow-withus-<app>-mobile/<env>-vX.Y.Z
+```
+
+**Components:**
+- `<app>`: `worker` (staff) or `client`
+- `<env>`: `dev`, `stage`, or `prod`
+- `vX.Y.Z`: Semantic version (from pubspec.yaml)
+
+**Examples:**
+```
+krow-withus-worker-mobile/dev-v0.0.1-m4
+krow-withus-worker-mobile/stage-v0.0.1-m4
+krow-withus-worker-mobile/prod-v0.0.1-m4
+krow-withus-client-mobile/dev-v0.0.1-m4
+```
+
+### Tag Creation
+
+Tags are created automatically by GitHub Actions workflows. Manual tagging:
+
+```bash
+# Staff app - dev environment
+git tag krow-withus-worker-mobile/dev-v0.0.1-m4
+git push origin krow-withus-worker-mobile/dev-v0.0.1-m4
+
+# Client app - prod environment
+git tag krow-withus-client-mobile/prod-v1.0.0
+git push origin krow-withus-client-mobile/prod-v1.0.0
+```
+
+### Tag Listing
+
+```bash
+# List all mobile tags
+git tag -l "krow-withus-*-mobile/*"
+
+# List staff app tags
+git tag -l "krow-withus-worker-mobile/*"
+
+# List production tags
+git tag -l "krow-withus-*-mobile/prod-*"
+```
+
+## 4. GitHub Actions Workflows
+
+### 4.1 Product Release Workflow
+
+**File:** `.github/workflows/product-release.yml`
+
+**Purpose:** Automated production releases with APK signing
+
+**Trigger:** Manual dispatch via GitHub UI
+
+**Inputs:**
+- `app`: Select `worker` (staff) or `client`
+- `environment`: Select `dev`, `stage`, or `prod`
+
+**Process:**
+1. ✅ Extracts version from `pubspec.yaml` automatically
+2. ✅ Builds signed APKs for selected app
+3. ✅ Creates GitHub release with CHANGELOG notes
+4. ✅ Tags release (e.g., `krow-withus-worker-mobile/dev-v0.0.1-m4`)
+5. ✅ Uploads APKs as release assets
+6. ✅ Generates step summary with emojis
+
+**Key Features:**
+- **No manual version input** - reads from pubspec.yaml
+- **APK signing** - uses GitHub Secrets for keystore
+- **CHANGELOG extraction** - pulls release notes automatically
+- **Visual feedback** - emojis in all steps
+
+**Usage:**
+```
+1. Go to: GitHub Actions → "📦 Product Release"
+2. Click "Run workflow"
+3. Select app (worker/client)
+4. Select environment (dev/stage/prod)
+5. Click "Run workflow"
+6. Wait for completion (~5-10 minutes)
+```
+
+**Release Naming:**
+```
+Krow With Us - Worker Product - DEV - v0.0.1-m4
+Krow With Us - Client Product - PROD - v1.0.0
+```
+
+### 4.2 Product Hotfix Workflow
+
+**File:** `.github/workflows/hotfix-branch-creation.yml`
+
+**Purpose:** Emergency production fix automation
+
+**Trigger:** Manual dispatch with version input
+
+**Inputs:**
+- `current_version`: Current production version (e.g., `0.0.1-m4`)
+- `issue_description`: Brief description of the hotfix
+
+**Process:**
+1. ✅ Creates `hotfix/<version>` branch from latest production tag
+2. ✅ Auto-increments PATCH version (e.g., `0.0.1-m4` → `0.0.2-m4`)
+3. ✅ Updates `pubspec.yaml` with new version
+4. ✅ Updates `CHANGELOG.md` with hotfix section
+5. ✅ Creates PR back to main branch
+6. ✅ Includes hotfix instructions in PR description
+
+**Usage:**
+```
+1. Go to: GitHub Actions → "🚨 Product Hotfix - Create Branch"
+2. Click "Run workflow"
+3. Enter current production version (e.g., 0.0.1-m4)
+4. Enter issue description (e.g., "critical crash on login")
+5. Click "Run workflow"
+6. Workflow creates branch and PR
+7. Fix bug on hotfix branch
+8. Merge PR to main
+9. Use Product Release workflow to deploy
+```
+
+**Hotfix Branch Naming:**
+```
+hotfix/0.0.2-m4-critical-crash-on-login
+```
+
+### 4.3 Helper Scripts
+
+**Location:** `.github/scripts/`
+
+**Available Scripts:**
+1. **extract-version.sh** - Extract version from pubspec.yaml
+2. **generate-tag-name.sh** - Generate standardized tag names
+3. **extract-release-notes.sh** - Extract CHANGELOG sections
+4. **create-release-summary.sh** - Generate GitHub Step Summary with emojis
+
+**Script Permissions:**
+```bash
+chmod +x .github/scripts/*.sh
+```
+
+**Usage Example:**
+```bash
+# Extract version from staff app
+.github/scripts/extract-version.sh apps/mobile/apps/staff/pubspec.yaml
+
+# Generate tag name
+.github/scripts/generate-tag-name.sh worker dev 0.0.1-m4
+
+# Extract release notes for version
+.github/scripts/extract-release-notes.sh apps/mobile/apps/staff/CHANGELOG.md 0.0.1-m4
+```
+
+## 5. APK Signing Setup
+
+### Required GitHub Secrets (24 Total)
+
+**Per App (12 secrets each):**
+
+**Staff (Worker) App:**
+```
+STAFF_UPLOAD_KEYSTORE_BASE64       # Base64-encoded keystore file
+STAFF_UPLOAD_STORE_PASSWORD        # Keystore password
+STAFF_UPLOAD_KEY_ALIAS             # Key alias
+STAFF_UPLOAD_KEY_PASSWORD          # Key password
+STAFF_KEYSTORE_PROPERTIES_BASE64   # Base64-encoded key.properties file
+```
+
+**Client App:**
+```
+CLIENT_UPLOAD_KEYSTORE_BASE64
+CLIENT_UPLOAD_STORE_PASSWORD
+CLIENT_UPLOAD_KEY_ALIAS
+CLIENT_UPLOAD_KEY_PASSWORD
+CLIENT_KEYSTORE_PROPERTIES_BASE64
+```
+
+### Generating Secrets
+
+**Step 1: Create Keystore**
+
+```bash
+# For staff app
+keytool -genkey -v \
+  -keystore staff-upload-keystore.jks \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 10000 \
+  -alias staff-upload
+
+# For client app
+keytool -genkey -v \
+  -keystore client-upload-keystore.jks \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 10000 \
+  -alias client-upload
+```
+
+**Step 2: Base64 Encode**
+
+```bash
+# Encode keystore
+base64 -i staff-upload-keystore.jks | tr -d '\n' > staff-keystore.txt
+
+# Encode key.properties
+base64 -i key.properties | tr -d '\n' > key-props.txt
+```
+
+**Step 3: Add to GitHub Secrets**
+
+```
+Repository → Settings → Secrets and variables → Actions → New repository secret
+```
+
+Add each secret:
+- Name: `STAFF_UPLOAD_KEYSTORE_BASE64`
+- Value: Contents of `staff-keystore.txt`
+
+Repeat for all 24 secrets.
+
+### key.properties Format
+
+```properties
+storePassword=your_store_password
+keyPassword=your_key_password
+keyAlias=staff-upload
+storeFile=../staff-upload-keystore.jks
+```
+
+## 6. Release Process (Step-by-Step)
+
+### Standard Release (Dev/Stage/Prod)
+
+**Step 1: Prepare CHANGELOG**
+
+Update `CHANGELOG.md` with all changes since last release:
+```markdown
+## [0.1.0-m5] - Milestone 5 - 2026-03-15
+
+### Added
+- Shift calendar with month/week views
+- Enhanced navigation with typed routes
+- Profile completion wizard
+
+### Fixed
+- Session token refresh timing
+- Navigation fallback logic
+```
+
+**Step 2: Update Version**
+
+Edit `pubspec.yaml`:
+```yaml
+version: 0.1.0-m5+1  # Changed from 0.0.1-m4+1
+```
+
+**Step 3: Commit and Push**
+
+```bash
+git add apps/mobile/apps/staff/CHANGELOG.md
+git add apps/mobile/apps/staff/pubspec.yaml
+git commit -m "chore(staff): prepare v0.1.0-m5 release"
+git push origin dev
+```
+
+**Step 4: Trigger Workflow**
+
+1. Go to GitHub Actions → "📦 Product Release"
+2. Click "Run workflow"
+3. Select branch: `dev`
+4. Select app: `worker` (or `client`)
+5. Select environment: `dev` (or `stage`, `prod`)
+6. Click "Run workflow"
+
+**Step 5: Monitor Progress**
+
+Watch workflow execution:
+- ⏳ Version extraction
+- ⏳ APK building
+- ⏳ APK signing
+- ⏳ GitHub Release creation
+- ⏳ Tag creation
+- ⏳ Asset upload
+
+**Step 6: Verify Release**
+
+1. Check GitHub Releases page
+2. Download APK to verify
+3. Install on test device
+4. Verify version in app
+
+### Hotfix Release
+
+**Step 1: Identify Production Issue**
+
+- Critical bug in production
+- User-reported crash
+- Security vulnerability
+
+**Step 2: Trigger Hotfix Workflow**
+
+1. Go to GitHub Actions → "🚨 Product Hotfix - Create Branch"
+2. Click "Run workflow"
+3. Enter current version: `0.0.1-m4`
+4. Enter description: `Critical crash on login screen`
+5. Click "Run workflow"
+
+**Step 3: Review Created Branch**
+
+Workflow creates:
+- Branch: `hotfix/0.0.2-m4-critical-crash-on-login`
+- PR to `main` branch
+- Updated `pubspec.yaml`: `0.0.2-m4+1`
+- Updated `CHANGELOG.md` with hotfix section
+
+**Step 4: Fix Bug**
+
+```bash
+git checkout hotfix/0.0.2-m4-critical-crash-on-login
+
+# Make fixes
+# ... code changes ...
+
+git add .
+git commit -m "fix(auth): resolve crash on login screen"
+git push origin hotfix/0.0.2-m4-critical-crash-on-login
+```
+
+**Step 5: Merge PR**
+
+1. Review PR on GitHub
+2. Approve and merge to `main`
+3. Delete hotfix branch
+
+**Step 6: Release to Production**
+
+1. Use Product Release workflow
+2. Select `main` branch
+3. Select `prod` environment
+4. Deploy hotfix
+
+## 7. Release Cadence
+
+### Development (dev)
+
+- **Frequency:** Multiple times per day
+- **Purpose:** Testing features in dev environment
+- **Branch:** `dev`
+- **Audience:** Internal development team
+- **Approval:** Not required
+
+### Staging (stage)
+
+- **Frequency:** 1-2 times per week
+- **Purpose:** QA testing, stakeholder demos
+- **Branch:** `main`
+- **Audience:** QA team, stakeholders
+- **Approval:** Tech lead approval
+
+### Production (prod)
+
+- **Frequency:** Every 2-3 weeks (milestone completion)
+- **Purpose:** End-user releases
+- **Branch:** `main`
+- **Audience:** All users
+- **Approval:** Product owner + tech lead approval
+
+### Milestone Releases
+
+- **Frequency:** Every 2-4 weeks
+- **Version Bump:** Minor version (e.g., `0.1.0-m5` → `0.2.0-m6`)
+- **Process:**
+  1. Complete all milestone features
+  2. Update CHANGELOG with comprehensive release notes
+  3. Deploy to stage for final QA
+  4. After approval, deploy to prod
+  5. Create GitHub release with milestone summary
+
+## 8. Troubleshooting
+
+### Workflow Fails: Version Extraction
+
+**Error:** "Could not extract version from pubspec.yaml"
+
+**Solutions:**
+1. Verify `pubspec.yaml` exists at expected path
+2. Check version format: `version: X.Y.Z-mN+B`
+3. Ensure no extra spaces or tabs
+4. Verify file is committed and pushed
+
+### Workflow Fails: APK Signing
+
+**Error:** "Keystore password incorrect"
+
+**Solutions:**
+1. Verify GitHub Secrets are set correctly
+2. Re-generate and re-encode keystore
+3. Check key.properties format
+4. Ensure passwords don't contain special characters that need escaping
+
+### Workflow Fails: CHANGELOG Extraction
+
+**Error:** "Could not find version in CHANGELOG"
+
+**Solutions:**
+1. Verify CHANGELOG format matches: `## [X.Y.Z-mN] - Milestone N - YYYY-MM-DD`
+2. Check square brackets are present
+3. Ensure version matches pubspec.yaml
+4. Add version section if missing
+
+### Tag Already Exists
+
+**Error:** "tag already exists"
+
+**Solutions:**
+1. Delete existing tag locally and remotely:
+```bash
+git tag -d krow-withus-worker-mobile/dev-v0.0.1-m4
+git push origin :refs/tags/krow-withus-worker-mobile/dev-v0.0.1-m4
+```
+2. Re-run workflow
+
+### Build Fails: Flutter Errors
+
+**Error:** "flutter build failed"
+
+**Solutions:**
+1. Test build locally first:
+```bash
+cd apps/mobile/apps/staff
+flutter build apk --release
+```
+2. Fix any analyzer errors
+3. Ensure all dependencies are compatible
+4. Clear build cache:
+```bash
+flutter clean
+flutter pub get
+```
+
+## 9. Local Testing
+
+Before triggering workflows, test builds locally:
+
+### Building APKs Locally
+
+**Staff App:**
+```bash
+cd apps/mobile/apps/staff
+flutter clean
+flutter pub get
+flutter build apk --release
+```
+
+**Client App:**
+```bash
+cd apps/mobile/apps/client
+flutter clean
+flutter pub get
+flutter build apk --release
+```
+
+### Testing Release Notes
+
+Extract CHANGELOG section:
+```bash
+.github/scripts/extract-release-notes.sh \
+  apps/mobile/apps/staff/CHANGELOG.md \
+  0.0.1-m4
+```
+
+### Verifying Version
+
+Extract version from pubspec:
+```bash
+.github/scripts/extract-version.sh \
+  apps/mobile/apps/staff/pubspec.yaml
+```
+
+## 10. Best Practices
+
+### CHANGELOG
+- ✅ Update continuously during development
+- ✅ Be specific and user-focused
+- ✅ Group related changes
+- ✅ Include UI/UX changes
+- ❌ Don't include technical debt or refactoring (unless user-facing)
+- ❌ Don't use vague descriptions
+
+### Versioning
+- ✅ Use semantic versioning strictly
+- ✅ Increment patch for bug fixes
+- ✅ Increment minor for new features
+- ✅ Keep milestone suffix until production
+- ❌ Don't skip versions
+- ❌ Don't use arbitrary version numbers
+
+### Git Tags
+- ✅ Follow standard format
+- ✅ Let workflow create tags automatically
+- ✅ Keep tags synced with releases
+- ❌ Don't create tags manually unless necessary
+- ❌ Don't reuse deleted tags
+
+### Workflows
+- ✅ Test builds locally first
+- ✅ Monitor workflow execution
+- ✅ Verify release assets
+- ✅ Test APK on device before announcing
+- ❌ Don't trigger multiple workflows simultaneously
+- ❌ Don't bypass approval process
+
+## Summary
+
+**Release Process Overview:**
+1. Update CHANGELOG with changes
+2. Update version in pubspec.yaml
+3. Commit and push to appropriate branch
+4. Trigger Product Release workflow
+5. Monitor execution and verify release
+6. Test APK on device
+7. Announce to team/users
+
+**Key Files:**
+- `apps/mobile/apps/staff/CHANGELOG.md`
+- `apps/mobile/apps/client/CHANGELOG.md`
+- `apps/mobile/apps/staff/pubspec.yaml`
+- `apps/mobile/apps/client/pubspec.yaml`
+
+**Key Workflows:**
+- Product Release (standard releases)
+- Product Hotfix (emergency fixes)
+
+**For Complete Details:**
+See [`docs/RELEASE/mobile-releases.md`](docs/RELEASE/mobile-releases.md) - 900+ line comprehensive guide with:
+- Detailed APK signing setup
+- Complete troubleshooting guide
+- All helper scripts documentation
+- Release checklist
+- Security best practices
+
+When in doubt, refer to the comprehensive documentation or ask for clarification before releasing to production.

.agent/skills/krow-paper-design/SKILL.md

@@ -0,0 +1,413 @@
+---
+name: krow-paper-design
+description: KROW Paper design file conventions covering design tokens, component patterns, screen structure, and naming rules. Use this when creating or updating screens in the Paper design tool, auditing designs for token compliance, building new flows, or restructuring existing frames. Ensures visual consistency across all Paper design files for the KROW staff and client apps.
+---
+
+# KROW Paper Design Conventions
+
+This skill defines the design token system, component patterns, screen structure conventions, and workflow rules established for the KROW Design Revamp Paper file. All design work in Paper must follow these conventions.
+
+## When to Use This Skill
+
+- Creating new screens or flows in Paper
+- Updating existing frames to match the design system
+- Auditing designs for token compliance
+- Adding components (buttons, chips, inputs, badges, cards)
+- Structuring shift detail pages, onboarding flows, or list screens
+- Setting up navigation patterns (back buttons, bottom nav, CTAs)
+- Reviewing Paper designs before handoff to development
+
+## 1. Design Tokens
+
+### Color Palette
+
+| Token | Hex | Usage |
+|-------|-----|-------|
+| Primary | `#0A39DF` | CTAs, active states, links, selected chips, nav active icons, pay rates |
+| Foreground | `#121826` | Headings, primary text, dark UI elements |
+| Text Secondary | `#6A7382` | Labels, captions, inactive nav, section headers, placeholder text, back chevrons |
+| Secondary BG | `#F1F3F5` | Subtle backgrounds, dividers, map placeholders |
+| Border | `#D1D5DB` | Card borders, unselected chip borders, outline button borders |
+| Input Border | `#E2E8F0` | Text input borders (lighter than general border) |
+| Destructive | `#F04444` | Error states, destructive actions (e.g., Request Swap) |
+| Background | `#FAFBFC` | Page/artboard background |
+| Card BG | `#FFFFFF` | Card surfaces, input backgrounds |
+| Success | `#059669` | Active status dot, checkmark icons, requirement met |
+| Warning Amber | `#D97706` | Urgent/Pending badge text |
+
+### Semantic Badge Colors
+
+| Badge | Background | Text Color |
+|-------|-----------|------------|
+| Active | `#ECFDF5` | `#059669` |
+| Confirmed | `#EBF0FF` | `#0A39DF` |
+| Pending | `#FEF9EE` | `#D97706` |
+| Urgent | `#FEF9EE` | `#D97706` |
+| One-Time | `#ECFDF5` | `#059669` |
+| Recurring | `#EBF0FF` | `#0A39DF` (use `#EFF6FF` bg on detail pages) |
+
+### Typography
+
+| Style | Font | Size | Weight | Line Height | Usage |
+|-------|------|------|--------|-------------|-------|
+| Display | Inter Tight | 28px | 700 | 34px | Page titles (Find Shifts, My Shifts) |
+| H1 | Inter Tight | 24px | 700 | 30px | Detail page titles (venue names) |
+| H2 | Inter Tight | 20px | 700 | 26px | Section headings |
+| H3 | Inter Tight | 18px | 700 | 22px | Card titles, schedule values |
+| Body Large | Manrope | 16px | 600 | 20px | Button text, CTA labels |
+| Body Default | Manrope | 14px | 400-500 | 18px | Body text, descriptions |
+| Body Small | Manrope | 13px | 400-500 | 16px | Card metadata, time/pay info |
+| Caption | Manrope | 12px | 500-600 | 16px | Small chip text, tab labels |
+| Section Label | Manrope | 11px | 700 | 14px | Uppercase section headers (letter-spacing: 0.06em) |
+| Badge Text | Manrope | 11px | 600-700 | 14px | Status badge labels (letter-spacing: 0.04em) |
+| Nav Label | Manrope | 10px | 600 | 12px | Bottom nav labels |
+
+### Spacing
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| Page padding | 24px | Horizontal padding from screen edge |
+| Section gap | 16-24px | Between major content sections |
+| Group gap | 8-12px | Within a section (e.g., label to input) |
+| Element gap | 4px | Tight spacing (e.g., subtitle under title) |
+| Bottom safe area | 40px | Padding below last element / CTA |
+
+### Border Radii
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| sm | 8px | Small chips, badges, status pills, map placeholder |
+| md | 12px | Cards, inputs, location cards, contact cards, search fields |
+| lg | 14px | Buttons, CTA containers, shift cards (Find Shifts) |
+| xl | 24px | Not commonly used |
+| pill | 999px | Progress bar segments only |
+
+## 2. Component Patterns
+
+### Buttons
+
+**Primary CTA:**
+- Background: `#0A39DF`, radius: 14px, height: 52px
+- Text: Manrope 16px/600, color: `#FFFFFF`
+- Padding: 16px vertical, 16px horizontal
+
+**Secondary/Outline Button:**
+- Background: `#FFFFFF`, border: 1.5px `#D1D5DB`, radius: 14px, height: 52px
+- Text: Manrope 16px/600, color: `#121826`
+
+**Destructive Outline Button:**
+- Background: `#FFFFFF`, border: 1.5px `#F04444`, radius: 14px
+- Text: Manrope 14px/600, color: `#F04444`
+
+**Back Icon Button (Bottom CTA):**
+- 52x52px square, border: 1.5px `#D1D5DB`, radius: 14px, background: `#FFFFFF`
+- Contains chevron-left SVG (20x20, viewBox 0 0 24 24, stroke `#121826`, strokeWidth 2)
+- Path: `M15 18L9 12L15 6`
+
+### Chips
+
+**Default (Large) - for role/skill selection:**
+- Selected: bg `#EFF6FF`, border 1.5px `#0A39DF`, radius 10px, padding 12px/16px
+  - Checkmark icon (14x14, stroke `#0A39DF`), text Manrope 14px/600 `#0A39DF`
+- Unselected: bg `#FFFFFF`, border 1.5px `#6A7382`, radius 10px, padding 12px/16px
+  - Text Manrope 14px/500 `#6A7382`
+
+**Small - for tabs, filters:**
+- Selected: bg `#EFF6FF`, border 1.5px `#0A39DF`, radius 8px, padding 6px/12px
+  - Checkmark icon (12x12), text Manrope 12px/600 `#0A39DF`
+- Unselected: bg `#FFFFFF`, border 1.5px `#D1D5DB`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/500 `#6A7382`
+- Active (filled): bg `#0A39DF`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/600 `#FFFFFF`
+- Dark (filters button): bg `#121826`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/600 `#FFFFFF`, with leading icon
+
+**Status Badges:**
+- Radius: 8px, padding: 4px/8px
+- Text: Manrope 11px/600-700, uppercase, letter-spacing 0.04em
+- Colors follow semantic badge table above
+
+### Text Inputs
+
+- Border: 1.5px `#E2E8F0`, radius: 12px, padding: 12px/14px
+- Background: `#FFFFFF`
+- Placeholder: Manrope 14px/400, color `#6A7382`
+- Filled: Manrope 14px/500, color `#121826`
+- Label above: Manrope 14px/500, color `#121826`
+- Focused: border color `#0A39DF`, border-width 2px
+- Error: border color `#F04444`, helper text `#F04444`
+
+### Cards (Shift List Items)
+
+- Background: `#FFFFFF`, border: 1px `#D1D5DB`, radius: 12-14px
+- Padding: 16px
+- Content: venue name (Manrope 15px/600 `#121826`), subtitle (Manrope 13px/400 `#6A7382`)
+- Metadata row: icon (14px, `#6A7382`) + text (Manrope 13px/500 `#6A7382`)
+- Pay rate: Inter Tight 18px/700 `#0A39DF`
+
+### Schedule/Pay Info Cards
+
+- Two-column layout with 12px gap
+- Background: `#FFFFFF`, border: 1px `#D1D5DB`, radius: 12px, padding: 16px
+- Label: Manrope 11px/500-700 uppercase `#6A7382` (letter-spacing 0.05em)
+- Value: Inter Tight 18px/700 `#121826` (schedule) or `#121826` (pay)
+- Sub-text: Manrope 13px/400 `#6A7382`
+
+### Contact/Info Rows
+
+- Container: radius 12px, border 1px `#D1D5DB`, background `#FFFFFF`, overflow clip
+- Row: padding 13px/16px, gap 10px, border-bottom 1px `#F1F3F5` (except last)
+- Icon: 16px, stroke `#6A7382`
+- Label: Manrope 13px/500 `#6A7382`, width 72px fixed
+- Value: Manrope 13px/500 `#121826` (or `#0A39DF` for phone/links)
+
+### Section Headers
+
+- Text: Manrope 11px/700, uppercase, letter-spacing 0.06em, color `#6A7382`
+- Gap to content below: 10px
+
+## 3. Screen Structure
+
+### Artboard Setup
+
+- Width: 390px (iPhone standard)
+- Height: 844px (default), or `fit-content` for scrollable detail pages
+- Background: `#FAFBFC`
+- Flex column layout, overflow: clip
+
+### Frame Naming Convention
+
+```
+<app>-<section>-<screen_number>-<screen_name>
+```
+
+Examples:
+- `staff-1-1-splash`
+- `staff-2-3-personal-information`
+- `staff-4-1-my-shifts`
+- `staff-5-2-shift-details`
+- `shift-5-3-confirmation`
+
+Section headers use: `<number> - <Section Name>` (e.g., `4 - My Shifts`)
+
+### Status Bar
+
+- Height: 44px, full width (390px)
+- Left: "9:41" text (system font)
+- Right: Signal, WiFi, Battery SVG icons (68px wide)
+
+### Header Back Button
+
+- Placed below status bar in a combined "Status Bar + Back" frame (390x72px)
+- Chevron SVG: 20x20, viewBox 0 0 24 24, stroke `#6A7382`, strokeWidth 2
+- Path: `M15 18L9 12L15 6`
+- Back button frame: 390x28px, padding-left: 24px
+
+### Progress Bar (Onboarding)
+
+- Container: 342px wide (24px margins), 3px height segments
+- Segments: pill radius (999px), gap between
+- Filled: `#0A39DF`, Unfilled: `#F1F3F5`
+
+### Bottom CTA Convention
+
+- Pinned to bottom using `marginTop: auto` on the CTA container
+- Layout: flex row, gap 12px, padding 0 24px
+- Back button: 52x52px icon-only button with chevron-left (stroke `#121826`)
+- Primary CTA: flex 1, height 52px, radius 14px, bg `#0A39DF`
+- Bottom safe padding: 40px (on artboard paddingBottom)
+
+### Bottom Navigation Bar
+
+- Full width, padding: 10px top, 28px bottom
+- Border-top: 1px `#F1F3F5`, background: `#FFFFFF`
+- 5 items: Home, Shifts, Find, Payments, Profile
+- Active: icon stroke `#0A39DF`, label Manrope 10px/600 `#0A39DF`
+- Inactive: icon stroke `#6A7382`, label Manrope 10px/600 `#6A7382`
+- Active icon may have light fill (e.g., `#EBF0FF` on calendar/search)
+
+## 4. Screen Templates
+
+### List Screen (My Shifts, Find Shifts)
+
+```
+Artboard (390x844, bg #FAFBFC)
+  Status Bar (390x44)
+  Header Section
+    Page Title (Display: Inter Tight 28px/700)
+    Tab/Filter Chips (Small chip variant)
+  Content
+    Date Header (Section label style, uppercase)
+    Shift Cards (12px radius, 1px border #D1D5DB)
+  Bottom Nav Bar
+```
+
+### Detail Screen (Shift Details)
+
+```
+Artboard (390x fit-content, bg #FAFBFC)
+  Status Bar (390x44)
+  Header Bar (Back chevron + "Shift Details" title + share icon)
+  Badges Row (status chips)
+  Role Title (H1) + Venue (with avatar)
+  Schedule/Pay Cards (two-column)
+  Job Description (section label + body text)
+  Location (card with map + address)
+  Requirements (section label + checkmark list)
+  Shift Contact (section label + contact card with rows)
+  [Optional] Note from Manager (warm bg card)
+  Bottom CTA (pinned)
+```
+
+### Onboarding Screen
+
+```
+Artboard (390x844, bg #FAFBFC, justify: flex-start, paddingBottom: 40px)
+  Status Bar + Back (390x72)
+  Progress Bar (342px, 3px segments)
+  Step Counter ("Step X of Y" - Body Small)
+  Page Title (H1: Inter Tight 24px/700)
+  [Optional] Subtitle (Body Default)
+  Form Content (inputs, chips, sliders)
+  Bottom CTA (marginTop: auto - back icon + Continue)
+```
+
+### Confirmation Screen
+
+```
+Artboard (390x844, bg #FAFBFC)
+  Status Bar
+  Centered Content
+    Success Icon (green circle + checkmark)
+    Title (Display: Inter Tight 26px/700, centered)
+    Subtitle (Body Default, centered, #6A7382)
+    Details Card (border #D1D5DB, rows with label/value pairs)
+  Bottom CTAs (primary + outline)
+```
+
+## 5. Workflow Rules
+
+### Write Incrementally
+
+Each `write_html` call should produce ONE visual group:
+- A header, a card, a single list row, a button bar, a section
+- Never batch an entire screen in one call
+
+### Review Checkpoints
+
+After every 2-3 modifications, take a screenshot and evaluate:
+- **Spacing**: Uneven gaps, cramped groups
+- **Typography**: Hierarchy, readability, correct font/weight
+- **Contrast**: Text legibility, element distinction
+- **Alignment**: Vertical lanes, horizontal alignment
+- **Clipping**: Content cut off at edges
+- **Token compliance**: All values match design system tokens
+
+### Color Audit Process
+
+When updating frames to match the design system:
+1. Get computed styles for all text, background, border elements
+2. Map old colors to design system tokens:
+   - Dark navy (`#0F4C81`, `#1A3A5C`) -> Primary `#0A39DF`
+   - Near-black (`#111827`, `#0F172A`) -> Foreground `#121826`
+   - Gray variants (`#94A3B8`, `#64748B`, `#475569`) -> Text Secondary `#6A7382`
+   - Green accents (`#20B486`) -> Primary `#0A39DF` (for pay) or `#059669` (for status)
+3. Batch update using `update_styles` with multiple nodeIds per style change
+4. Verify with screenshots
+
+### Structural Consistency
+
+When creating matching screens (e.g., two shift detail views):
+- Use identical section ordering
+- Match section header styles (11px/700 uppercase `#6A7382`)
+- Use same card/row component patterns
+- Maintain consistent padding and gap values
+
+## 6. SVG Icon Patterns
+
+### Chevron Left (Back)
+```html
+<svg width="20" height="20" viewBox="0 0 24 24" fill="none">
+  <path d="M15 18L9 12L15 6" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Map Pin
+```html
+<svg width="18" height="18" viewBox="0 0 24 24" fill="none">
+  <path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="12" cy="10" r="3" stroke="#6A7382" stroke-width="2"/>
+</svg>
+```
+
+### User (Supervisor)
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="12" cy="7" r="4" stroke="#6A7382" stroke-width="2"/>
+</svg>
+```
+
+### Phone
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72c.127.96.361 1.903.7 2.81a2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45c.907.339 1.85.573 2.81.7A2 2 0 0 1 22 16.92z" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Checkmark (Requirement Met)
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M22 4L12 14.01l-3-3" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Chip Checkmark
+```html
+<!-- Large chip (14x14) -->
+<svg width="14" height="14" viewBox="0 0 14 14" fill="none">
+  <path d="M2.5 7L5.5 10L11.5 4" stroke="#0A39DF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+
+<!-- Small chip (12x12) -->
+<svg width="12" height="12" viewBox="0 0 14 14" fill="none">
+  <path d="M2.5 7L5.5 10L11.5 4" stroke="#0A39DF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+## 7. Anti-Patterns
+
+### Colors
+- Never use `#0F4C81`, `#1A3A5C` (old navy) - use `#0A39DF` (Primary)
+- Never use `#111827`, `#0F172A` - use `#121826` (Foreground)
+- Never use `#94A3B8`, `#64748B`, `#475569` - use `#6A7382` (Text Secondary)
+- Never use `#20B486` for pay rates - use `#0A39DF` (Primary)
+- Never use `#E2E8F0` for card borders - use `#D1D5DB` (Border)
+
+### Components
+- Never use pill radius (999px) for chips or badges - use 8px or 10px
+- Never use gradient backgrounds on buttons
+- Never mix font families within a role (headings = Inter Tight, body = Manrope)
+- Never place back buttons at the bottom of frames - always after status bar
+- Never hardcode CTA position - use `marginTop: auto` for bottom pinning
+
+### Structure
+- Never batch an entire screen in one `write_html` call
+- Never skip review checkpoints after 2-3 modifications
+- Never create frames without following the naming convention
+- Never use `justifyContent: space-between` on artboards with many direct children - use `marginTop: auto` on the CTA instead
+
+## Summary
+
+**The design file is the source of truth for visual direction.** Every element must use the established tokens:
+
+1. **Colors**: 7 core tokens + semantic badge colors
+2. **Typography**: Inter Tight (headings) + Manrope (body), defined scale
+3. **Spacing**: 24px page padding, 16-24px section gaps, 40px bottom safe area
+4. **Radii**: 8px (chips/badges), 12px (cards/inputs), 14px (buttons/CTAs)
+5. **Components**: Buttons, chips (large/small), inputs, cards, badges, nav bars
+6. **Structure**: Status bar > Back > Content > Bottom CTA (pinned)
+7. **Naming**: `<app>-<section>-<number>-<name>`
+
+When in doubt, screenshot an existing screen and match its patterns exactly.

.agents/settings.local.json

@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(grep:*)",
+      "mcp__paper__get_basic_info",
+      "mcp__paper__get_screenshot",
+      "mcp__paper__get_tree_summary",
+      "mcp__paper__update_styles",
+      "mcp__paper__set_text_content",
+      "mcp__paper__get_computed_styles",
+      "mcp__paper__finish_working_on_nodes",
+      "mcp__paper__get_font_family_info",
+      "mcp__paper__rename_nodes",
+      "mcp__paper__write_html",
+      "mcp__paper__get_children",
+      "mcp__paper__create_artboard",
+      "mcp__paper__delete_nodes",
+      "mcp__paper__get_jsx",
+      "mcp__paper__get_node_info",
+      "mcp__paper__duplicate_nodes"
+    ]
+  }
+}

.agents/skills/krow-mobile-architecture/SKILL.md

@@ -0,0 +1,900 @@
+---
+name: krow-mobile-architecture
+description: KROW mobile app Clean Architecture implementation including package structure, dependency rules, feature isolation, BLoC lifecycle management, session handling, and Data Connect connectors pattern. Use this when architecting new mobile features, debugging state management issues, preventing prop drilling, managing BLoC disposal, implementing session stores, or setting up connector repositories. Essential for maintaining architectural integrity across staff and client apps.
+---
+
+# KROW Mobile Architecture
+
+This skill defines the authoritative mobile architecture for the KROW platform. All code must strictly adhere to these principles to prevent architectural degradation.
+
+## When to Use This Skill
+
+- Architecting new mobile features
+- Debugging state management or BLoC lifecycle issues
+- Preventing prop drilling in UI code
+- Managing session state and authentication
+- Implementing Data Connect connector repositories
+- Setting up feature modules and dependency injection
+- Understanding package boundaries and dependencies
+- Refactoring legacy code to Clean Architecture
+
+## 1. High-Level Architecture
+
+KROW follows **Clean Architecture** in a **Melos Monorepo**. Dependencies flow **inward** toward the Domain.
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    Apps (Entry Points)                  │
+│  • apps/mobile/apps/client                              │
+│  • apps/mobile/apps/staff                               │
+│  Role: DI roots, navigation assembly, env config        │
+└─────────────────┬───────────────────────────────────────┘
+                  │ depends on
+┌─────────────────▼───────────────────────────────────────┐
+│                   Features (Vertical Slices)            │
+│  • apps/mobile/packages/features/client/*               │
+│  • apps/mobile/packages/features/staff/*                │
+│  Role: Pages, BLoCs, Use Cases, Feature Repositories    │
+└─────┬───────────────────────────────────────┬───────────┘
+      │ depends on                            │ depends on
+┌─────▼────────────────┐              ┌───────▼───────────┐
+│   Design System      │              │  Core Localization│
+│  • UI components     │              │  • LocaleBloc     │
+│  • Theme/colors      │              │  • Translations   │
+│  • Typography        │              │  • ErrorTranslator│
+└──────────────────────┘              └───────────────────┘
+                  │ both depend on
+┌─────────────────▼───────────────────────────────────────┐
+│               Services (Interface Adapters)             │
+│  • data_connect: Backend integration, session mgmt      │
+│  • core: Extensions, base classes, utilities            │
+└─────────────────┬───────────────────────────────────────┘
+                  │ both depend on
+┌─────────────────▼───────────────────────────────────────┐
+│                Domain (Stable Core)                     │
+│  • Entities (immutable data models)                     │
+│  • Failures (domain-specific errors)                    │
+│  • Pure Dart only, zero Flutter dependencies            │
+└─────────────────────────────────────────────────────────┘
+```
+
+**Critical Rule:** Dependencies point INWARD only. Domain knows nothing about the outer layers.
+
+## 2. Package Structure & Responsibilities
+
+### 2.1 Apps (`apps/mobile/apps/`)
+
+**Role:** Application entry points and DI roots
+
+**Responsibilities:**
+- Initialize Flutter Modular
+- Assemble features into navigation tree
+- Inject concrete implementations (from `data_connect`) into features
+- Configure environment-specific settings (dev/stage/prod)
+- Initialize session management
+
+**Structure:**
+```
+apps/mobile/apps/staff/
+├── lib/
+│   ├── main.dart              # Entry point, session initialization
+│   ├── app_module.dart        # Root module, imports features
+│   ├── app_widget.dart        # MaterialApp setup
+│   └── src/
+│       ├── navigation/        # Typed navigators
+│       └── widgets/           # SessionListener wrapper
+└── pubspec.yaml
+```
+
+**RESTRICTION:** NO business logic. NO UI widgets (except App and Main).
+
+### 2.2 Features (`apps/mobile/packages/features/<APP>/<FEATURE>`)
+
+**Role:** Vertical slices of user-facing functionality
+
+**Internal Structure:**
+```
+features/staff/profile/
+├── lib/
+│   ├── src/
+│   │   ├── domain/
+│   │   │   ├── repositories/        # Repository interfaces
+│   │   │   │   └── profile_repository_interface.dart
+│   │   │   └── usecases/           # Application logic
+│   │   │       └── get_profile_usecase.dart
+│   │   ├── data/
+│   │   │   └── repositories_impl/   # Repository concrete classes
+│   │   │       └── profile_repository_impl.dart
+│   │   └── presentation/
+│   │       ├── blocs/              # State management
+│   │       │   └── profile_cubit.dart
+│   │       ├── pages/              # Screens (StatelessWidget preferred)
+│   │       │   └── profile_page.dart
+│   │       └── widgets/            # Reusable UI components
+│   │           └── profile_header.dart
+│   └── profile_feature.dart        # Barrel file (public API only)
+└── pubspec.yaml
+```
+
+**Key Principles:**
+- **Presentation:** UI Pages and Widgets, BLoCs/Cubits for state
+- **Application:** Use Cases (business logic orchestration)
+- **Data:** Repository implementations (backend integration)
+- **Pages as StatelessWidget:** Move state to BLoCs for better performance and testability
+
+**RESTRICTION:** Features MUST NOT import other features. Communication happens via:
+- Shared domain entities
+- Session stores (`StaffSessionStore`, `ClientSessionStore`)
+- Navigation via Modular
+- Data Connect connector repositories
+
+### 2.3 Domain (`apps/mobile/packages/domain`)
+
+**Role:** The stable, pure heart of the system
+
+**Responsibilities:**
+- Define **Entities** (immutable data models using Data Classes or Freezed)
+- Define **Failures** (domain-specific error types)
+
+**Structure:**
+```
+domain/
+├── lib/
+│   └── src/
+│       ├── entities/
+│       │   ├── user.dart
+│       │   ├── staff.dart
+│       │   └── shift.dart
+│       └── failures/
+│           ├── failure.dart        # Base class
+│           ├── auth_failure.dart
+│           └── network_failure.dart
+└── pubspec.yaml
+```
+
+**Example Entity:**
+```dart
+import 'package:equatable/equatable.dart';
+
+class Staff extends Equatable {
+  final String id;
+  final String name;
+  final String email;
+  final StaffStatus status;
+  
+  const Staff({
+    required this.id,
+    required this.name,
+    required this.email,
+    required this.status,
+  });
+  
+  @override
+  List<Object?> get props => [id, name, email, status];
+}
+```
+
+**RESTRICTION:** 
+- NO Flutter dependencies (no `import 'package:flutter/material.dart'`)
+- NO `json_annotation` or serialization code
+- Only `equatable` for value equality
+- Pure Dart only
+
+### 2.4 Data Connect (`apps/mobile/packages/data_connect`)
+
+**Role:** Interface Adapter for Backend Access
+
+**Responsibilities:**
+- Centralized connector repositories (see Data Connect Connectors Pattern section)
+- Implement Firebase Data Connect service layer
+- Map Domain Entities ↔ Data Connect generated code
+- Handle Firebase exceptions → domain failures
+- Provide `DataConnectService` with session management
+
+**Structure:**
+```
+data_connect/
+├── lib/
+│   ├── src/
+│   │   ├── services/
+│   │   │   ├── data_connect_service.dart     # Core service
+│   │   │   └── mixins/
+│   │   │       └── session_handler_mixin.dart
+│   │   ├── connectors/                        # Connector pattern (see below)
+│   │   │   ├── staff/
+│   │   │   │   ├── domain/
+│   │   │   │   │   ├── repositories/
+│   │   │   │   │   │   └── staff_connector_repository.dart
+│   │   │   │   │   └── usecases/
+│   │   │   │   │       └── get_profile_completion_usecase.dart
+│   │   │   │   └── data/
+│   │   │   │       └── repositories/
+│   │   │   │           └── staff_connector_repository_impl.dart
+│   │   │   ├── order/
+│   │   │   └── shifts/
+│   │   └── session/
+│   │       ├── staff_session_store.dart
+│   │       └── client_session_store.dart
+│   └── krow_data_connect.dart               # Exports
+└── pubspec.yaml
+```
+
+**RESTRICTION:**
+- NO feature-specific logic
+- Connectors are domain-neutral and reusable
+- All queries follow Clean Architecture (domain interfaces → data implementations)
+
+### 2.5 Design System (`apps/mobile/packages/design_system`)
+
+**Role:** Visual language and component library
+
+**Responsibilities:**
+- Theme definitions (`UiColors`, `UiTypography`)
+- UI constants (`spacingL`, `radiusM`, etc.)
+- Shared widgets (if reused across multiple features)
+- Assets (icons, images, fonts)
+
+**Structure:**
+```
+design_system/
+├── lib/
+│   └── src/
+│       ├── ui_colors.dart
+│       ├── ui_typography.dart
+│       ├── ui_icons.dart
+│       ├── ui_constants.dart
+│       ├── ui_theme.dart          # ThemeData factory
+│       └── widgets/               # Shared UI components
+│           └── custom_button.dart
+└── assets/
+    ├── icons/
+    └── images/
+```
+
+**RESTRICTION:**
+- Dumb widgets ONLY (no state management)
+- NO business logic
+- Colors and typography are IMMUTABLE (no feature can override)
+
+### 2.6 Core Localization (`apps/mobile/packages/core_localization`)
+
+**Role:** Centralized i18n management
+
+**Responsibilities:**
+- Define all user-facing strings in `l10n/`
+- Provide `LocaleBloc` for locale state management
+- Export `TranslationProvider` for `context.strings` access
+- Map domain failures to localized error messages via `ErrorTranslator`
+
+**Feature Integration:**
+```dart
+// Features access strings
+Text(context.strings.loginButton)
+
+// BLoCs emit domain failures (not strings)
+emit(AuthError(InvalidCredentialsFailure()));
+
+// UI translates failures to localized messages
+final message = ErrorTranslator.translate(failure, context.strings);
+```
+
+**App Setup:**
+```dart
+// App imports LocalizationModule
+class AppModule extends Module {
+  @override
+  List<Module> get imports => [LocalizationModule()];
+}
+
+// Wrap app with providers
+BlocProvider<LocaleBloc>(
+  create: (_) => Modular.get<LocaleBloc>(),
+  child: TranslationProvider(
+    child: MaterialApp.router(...),
+  ),
+)
+```
+
+### 2.7 Core (`apps/mobile/packages/core`)
+
+**Role:** Cross-cutting concerns
+
+**Responsibilities:**
+- Extension methods (NavigationExtensions, ListExtensions, etc.)
+- Base classes (UseCase, Failure, BlocErrorHandler)
+- Logger configuration
+- Result types for functional error handling
+
+## 3. Dependency Direction Rules
+
+1. **Domain Independence:** `domain` knows NOTHING about outer layers
+   - Defines *what* needs to be done, not *how*
+   - Pure Dart, zero Flutter dependencies
+   - Stable contracts that rarely change
+
+2. **UI Agnosticism:** Features depend on `design_system` for UI and `domain` for logic
+   - Features do NOT know about Firebase or backend details
+   - Backend changes don't affect feature implementation
+
+3. **Data Isolation:** `data_connect` depends on `domain` to know interfaces
+   - Implements domain repository interfaces
+   - Maps backend models to domain entities
+   - Does NOT know about UI
+
+**Dependency Flow:**
+```
+Apps → Features → Design System
+                → Core Localization
+                → Data Connect → Domain
+                              → Core
+```
+
+## 4. Data Connect Service & Session Management
+
+### 4.1 Session Handler Mixin
+
+**Location:** `apps/mobile/packages/data_connect/lib/src/services/mixins/session_handler_mixin.dart`
+
+**Responsibilities:**
+- Automatic token refresh (triggered when <5 minutes to expiry)
+- Firebase auth state listening
+- Role-based access validation
+- Session state stream emissions
+- 3-attempt retry with exponential backoff (1s → 2s → 4s)
+
+**Key Method:**
+```dart
+// Call once on app startup
+DataConnectService.instance.initializeAuthListener(
+  allowedRoles: ['STAFF', 'BOTH'],  // or ['CLIENT', 'BUSINESS', 'BOTH']
+);
+```
+
+### 4.2 Session Listener Widget
+
+**Location:** `apps/mobile/apps/<app>/lib/src/widgets/session_listener.dart`
+
+**Responsibilities:**
+- Wraps entire app to listen to session state changes
+- Shows user-friendly dialogs for session expiration/errors
+- Handles navigation on auth state changes
+
+**Usage:**
+```dart
+// main.dart
+runApp(
+  SessionListener(  // ← Critical wrapper
+    child: ModularApp(module: AppModule(), child: AppWidget()),
+  ),
+);
+```
+
+### 4.3 Repository Pattern with Data Connect
+
+**Step 1:** Define interface in feature domain:
+```dart
+// features/staff/profile/lib/src/domain/repositories/
+abstract interface class ProfileRepositoryInterface {
+  Future<Staff> getProfile(String id);
+}
+```
+
+**Step 2:** Implement using `DataConnectService.run()`:
+```dart
+// features/staff/profile/lib/src/data/repositories_impl/
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**Benefits of `_service.run()`:**
+- ✅ Auto validates user is authenticated
+- ✅ Refreshes token if <5 min to expiry
+- ✅ Executes the query
+- ✅ 3-attempt retry with exponential backoff
+- ✅ Maps exceptions to domain failures
+
+### 4.4 Session Store Pattern
+
+After successful auth, populate session stores:
+
+**Staff App:**
+```dart
+StaffSessionStore.instance.setSession(
+  StaffSession(
+    user: user,
+    staff: staff,
+    ownerId: ownerId,
+  ),
+);
+```
+
+**Client App:**
+```dart
+ClientSessionStore.instance.setSession(
+  ClientSession(
+    user: user,
+    business: business,
+  ),
+);
+```
+
+**Lazy Loading:** If session is null, fetch from backend and update:
+```dart
+final session = StaffSessionStore.instance.session;
+if (session?.staff == null) {
+  final staff = await getStaffById(session!.user.uid);
+  StaffSessionStore.instance.setSession(
+    session.copyWith(staff: staff),
+  );
+}
+```
+
+## 5. Feature Isolation & Communication
+
+### Zero Direct Imports
+
+```dart
+// ❌ FORBIDDEN
+import 'package:staff_profile/staff_profile.dart';  // in another feature
+
+// ✅ ALLOWED
+import 'package:krow_domain/krow_domain.dart';      // shared domain
+import 'package:krow_core/krow_core.dart';          // shared utilities
+import 'package:design_system/design_system.dart';  // shared UI
+```
+
+### Navigation: Typed Navigators with Safe Extensions
+
+**Safe Navigation Extensions** (from `core` package):
+```dart
+extension NavigationExtensions on IModularNavigator {
+  /// Safely navigate with fallback to home
+  Future<void> safeNavigate(String route) async {
+    try {
+      await navigate(route);
+    } catch (e) {
+      await navigate('/home');  // Fallback
+    }
+  }
+  
+  /// Safely push with fallback to home
+  Future<T?> safePush<T>(String route) async {
+    try {
+      return await pushNamed<T>(route);
+    } catch (e) {
+      await navigate('/home');
+      return null;
+    }
+  }
+  
+  /// Safely pop with guard against empty stack
+  void popSafe() {
+    if (canPop()) {
+      pop();
+    } else {
+      navigate('/home');
+    }
+  }
+}
+```
+
+**Typed Navigators:**
+```dart
+// apps/mobile/apps/staff/lib/src/navigation/staff_navigator.dart
+extension StaffNavigator on IModularNavigator {
+  Future<void> toStaffHome() => safeNavigate(StaffPaths.home);
+  
+  Future<void> toShiftDetails(String shiftId) => 
+      safePush('${StaffPaths.shifts}/$shiftId');
+  
+  Future<void> toProfileEdit() => safePush(StaffPaths.profileEdit);
+}
+```
+
+**Usage in Features:**
+```dart
+// ✅ CORRECT
+Modular.to.toStaffHome();
+Modular.to.toShiftDetails(shiftId: '123');
+Modular.to.popSafe();
+
+// ❌ AVOID
+Modular.to.navigate('/home');  // No safety
+Navigator.push(...);            // No Modular integration
+```
+
+### Data Sharing Patterns
+
+Features don't share state directly. Use:
+
+1. **Domain Repositories:** Centralized data sources
+2. **Session Stores:** `StaffSessionStore`, `ClientSessionStore` for app-wide context
+3. **Event Streams:** If needed, via `DataConnectService` streams
+4. **Navigation Arguments:** Pass IDs, not full objects
+
+## 6. App-Specific Session Management
+
+### Staff App
+
+```dart
+// main.dart
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['STAFF', 'BOTH'],
+  );
+  
+  runApp(
+    SessionListener(
+      child: ModularApp(module: StaffAppModule(), child: StaffApp()),
+    ),
+  );
+}
+```
+
+**Session Store:** `StaffSessionStore`
+- Fields: `user`, `staff`, `ownerId`
+- Lazy load: `getStaffById()` if staff is null
+
+**Navigation:**
+- Authenticated → `Modular.to.toStaffHome()`
+- Unauthenticated → `Modular.to.toInitialPage()`
+
+### Client App
+
+```dart
+// main.dart
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['CLIENT', 'BUSINESS', 'BOTH'],
+  );
+  
+  runApp(
+    SessionListener(
+      child: ModularApp(module: ClientAppModule(), child: ClientApp()),
+    ),
+  );
+}
+```
+
+**Session Store:** `ClientSessionStore`
+- Fields: `user`, `business`
+- Lazy load: `getBusinessById()` if business is null
+
+**Navigation:**
+- Authenticated → `Modular.to.toClientHome()`
+- Unauthenticated → `Modular.to.toInitialPage()`
+
+## 7. Data Connect Connectors Pattern
+
+**Problem:** Without connectors, each feature duplicates backend queries.
+
+**Solution:** Centralize all backend queries in `data_connect/connectors/`.
+
+### Structure
+
+Mirror backend connector structure:
+
+```
+data_connect/lib/src/connectors/
+├── staff/
+│   ├── domain/
+│   │   ├── repositories/
+│   │   │   └── staff_connector_repository.dart      # Interface
+│   │   └── usecases/
+│   │       └── get_profile_completion_usecase.dart
+│   └── data/
+│       └── repositories/
+│           └── staff_connector_repository_impl.dart # Implementation
+├── order/
+├── shifts/
+└── user/
+```
+
+**Maps to backend:**
+```
+backend/dataconnect/connector/
+├── staff/
+├── order/
+├── shifts/
+└── user/
+```
+
+### Clean Architecture in Connectors
+
+**Domain Interface:**
+```dart
+// staff_connector_repository.dart
+abstract interface class StaffConnectorRepository {
+  Future<bool> getProfileCompletion();
+  Future<Staff> getStaffById(String id);
+}
+```
+
+**Use Case:**
+```dart
+// get_profile_completion_usecase.dart
+class GetProfileCompletionUseCase {
+  final StaffConnectorRepository _repository;
+  
+  GetProfileCompletionUseCase({required StaffConnectorRepository repository})
+      : _repository = repository;
+  
+  Future<bool> call() => _repository.getProfileCompletion();
+}
+```
+
+**Data Implementation:**
+```dart
+// staff_connector_repository_impl.dart
+class StaffConnectorRepositoryImpl implements StaffConnectorRepository {
+  final DataConnectService _service;
+  
+  @override
+  Future<bool> getProfileCompletion() async {
+    return _service.run(() async {
+      final staffId = await _service.getStaffId();
+      final response = await _service.connector
+          .getStaffProfileCompletion(id: staffId)
+          .execute();
+      
+      return _isProfileComplete(response);
+    });
+  }
+}
+```
+
+### Feature Integration
+
+**Step 1:** Feature registers connector repository:
+```dart
+// staff_main_module.dart
+class StaffMainModule extends Module {
+  @override
+  void binds(Injector i) {
+    i.addLazySingleton<StaffConnectorRepository>(
+      StaffConnectorRepositoryImpl.new,
+    );
+    
+    i.addLazySingleton(
+      () => GetProfileCompletionUseCase(
+        repository: i.get<StaffConnectorRepository>(),
+      ),
+    );
+    
+    i.addLazySingleton(
+      () => StaffMainCubit(
+        getProfileCompletionUsecase: i.get(),
+      ),
+    );
+  }
+}
+```
+
+**Step 2:** BLoC uses it:
+```dart
+class StaffMainCubit extends Cubit<StaffMainState> {
+  final GetProfileCompletionUseCase _getProfileCompletionUsecase;
+  
+  Future<void> loadProfileCompletion() async {
+    final isComplete = await _getProfileCompletionUsecase();
+    emit(state.copyWith(isProfileComplete: isComplete));
+  }
+}
+```
+
+### Benefits
+
+✅ **No Duplication** - Query implemented once, used by many features  
+✅ **Single Source of Truth** - Backend change → update one place  
+✅ **Reusability** - Any feature can use any connector  
+✅ **Testability** - Mock connector repo to test features  
+✅ **Scalability** - Easy to add connectors as backend grows  
+
+## 8. Avoiding Prop Drilling: Direct BLoC Access
+
+### The Problem
+
+Passing data through intermediate widgets creates maintenance burden:
+
+```dart
+// ❌ BAD: Prop drilling
+ProfilePage(status: status)
+  → ProfileHeader(status: status)
+    → ProfileLevelBadge(status: status)  // Only widget that needs it
+```
+
+### The Solution: BlocBuilder in Leaf Widgets
+
+```dart
+// ✅ GOOD: Direct BLoC access
+class ProfileLevelBadge extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<ProfileCubit, ProfileState>(
+      builder: (context, state) {
+        if (state.profile == null) return const SizedBox.shrink();
+        
+        final level = _mapStatusToLevel(state.profile!.status);
+        return LevelBadgeUI(level: level);
+      },
+    );
+  }
+}
+```
+
+### Guidelines
+
+1. **Leaf Widgets Access BLoC:** Widgets needing specific data should use `BlocBuilder`
+2. **Container Widgets Stay Simple:** Parent widgets only manage layout
+3. **No Unnecessary Props:** Don't pass data to intermediate widgets
+4. **Single Responsibility:** Each widget has one reason to exist
+
+**Decision Tree:**
+```
+Does this widget need data?
+├─ YES, leaf widget → Use BlocBuilder
+├─ YES, container → Use BlocBuilder in child
+└─ NO → Don't add prop
+```
+
+## 9. BLoC Lifecycle & State Emission Safety
+
+### The Problem: StateError After Dispose
+
+When async operations complete after BLoC is closed:
+```
+StateError: Cannot emit new states after calling close
+```
+
+**Root Causes:**
+1. Transient BLoCs created with `BlocProvider(create:)` → disposed prematurely
+2. Multiple BlocProviders disposing same singleton
+3. User navigates away during async operation
+
+### The Solution: Singleton BLoCs + Safe Emit
+
+#### Step 1: Register as Singleton
+
+```dart
+// ✅ GOOD: Singleton registration
+i.addLazySingleton<ProfileCubit>(
+  () => ProfileCubit(useCase1, useCase2),
+);
+
+// ❌ BAD: Creates new instance each time
+i.add(ProfileCubit.new);
+```
+
+#### Step 2: Use BlocProvider.value()
+
+```dart
+// ✅ GOOD: Reuse singleton
+final cubit = Modular.get<ProfileCubit>();
+BlocProvider<ProfileCubit>.value(
+  value: cubit,
+  child: MyWidget(),
+)
+
+// ❌ BAD: Creates duplicate
+BlocProvider<ProfileCubit>(
+  create: (_) => Modular.get<ProfileCubit>(),
+  child: MyWidget(),
+)
+```
+
+#### Step 3: Safe Emit with BlocErrorHandler
+
+**Location:** `apps/mobile/packages/core/lib/src/presentation/mixins/bloc_error_handler.dart`
+
+```dart
+mixin BlocErrorHandler<S> on Cubit<S> {
+  void _safeEmit(void Function(S) emit, S state) {
+    try {
+      emit(state);
+    } on StateError catch (e) {
+      developer.log(
+        'Could not emit state: ${e.message}. Bloc may have been disposed.',
+        name: runtimeType.toString(),
+      );
+    }
+  }
+}
+```
+
+**Usage:**
+```dart
+class ProfileCubit extends Cubit<ProfileState> with BlocErrorHandler<ProfileState> {
+  Future<void> loadProfile() async {
+    emit(state.copyWith(status: ProfileStatus.loading));
+    
+    await handleError(
+      emit: emit,
+      action: () async {
+        final profile = await getProfile();
+        emit(state.copyWith(status: ProfileStatus.loaded, profile: profile));
+        // ✅ Safe even if BLoC disposed
+      },
+      onError: (errorKey) => state.copyWith(status: ProfileStatus.error),
+    );
+  }
+}
+```
+
+### Pattern Summary
+
+| Pattern | When to Use | Risk |
+|---------|------------|------|
+| Singleton + BlocProvider.value() | Long-lived features | Low |
+| Transient + BlocProvider(create:) | Temporary widgets | Medium |
+| Direct BlocBuilder | Leaf widgets | Low |
+
+## 10. Anti-Patterns to Avoid
+
+❌ **Feature imports feature**
+```dart
+import 'package:staff_profile/staff_profile.dart';  // in another feature
+```
+
+❌ **Business logic in BLoC**
+```dart
+on<LoginRequested>((event, emit) {
+  if (event.email.isEmpty) {  // ← Use case responsibility
+    emit(AuthError('Email required'));
+  }
+});
+```
+
+❌ **Direct Data Connect in features**
+```dart
+final response = await FirebaseDataConnect.instance.query();  // ← Use repository
+```
+
+❌ **Global state variables**
+```dart
+User? currentUser;  // ← Use SessionStore
+```
+
+❌ **Direct Navigator.push**
+```dart
+Navigator.push(context, MaterialPageRoute(...));  // ← Use Modular
+```
+
+❌ **Hardcoded navigation**
+```dart
+Modular.to.navigate('/profile');  // ← Use safe extensions
+```
+
+## Summary
+
+The architecture enforces:
+- **Clean Architecture** with strict layer boundaries
+- **Feature Isolation** via zero cross-feature imports
+- **Session Management** via DataConnectService and SessionListener
+- **Connector Pattern** for reusable backend queries
+- **BLoC Lifecycle** safety with singletons and safe emit
+- **Navigation Safety** with typed navigators and fallbacks
+
+When implementing features:
+1. Follow package structure strictly
+2. Use connector repositories for backend access
+3. Register BLoCs as singletons with `.value()`
+4. Use safe navigation extensions
+5. Avoid prop drilling with direct BLoC access
+6. Keep domain pure and stable
+
+Architecture is not negotiable. When in doubt, refer to existing well-structured features or ask for clarification.

.agents/skills/krow-mobile-design-system/SKILL.md

@@ -0,0 +1,717 @@
+---
+name: krow-mobile-design-system
+description: KROW mobile design system usage rules covering colors, typography, icons, spacing, and UI component patterns. Use this when implementing UI in KROW mobile features, matching POC designs to production, creating themed widgets, enforcing visual consistency, or reviewing UI code compliance. Prevents hardcoded values and ensures brand consistency across staff and client apps. Critical for maintaining immutable design tokens.
+---
+
+# KROW Mobile Design System Usage
+
+This skill defines mandatory standards for UI implementation using the shared `apps/mobile/packages/design_system`. All UI must consume design system tokens exclusively.
+
+## When to Use This Skill
+
+- Implementing any UI in mobile features
+- Migrating POC/prototype designs to production
+- Creating new themed widgets or components
+- Reviewing UI code for design system compliance
+- Matching colors and typography from designs
+- Adding icons, spacing, or layout elements
+- Setting up theme configuration in apps
+- Refactoring UI code with hardcoded values
+
+## Core Principle
+
+**Design tokens (colors, typography, spacing) are IMMUTABLE and defined centrally.**
+
+Features consume tokens but NEVER modify them. The design system maintains visual coherence across all apps.
+
+## 1. Design System Ownership
+
+### Centralized Authority
+
+- `apps/mobile/packages/design_system` owns:
+  - All brand assets
+  - Colors and semantic color mappings
+  - Typography and font configurations
+  - Core UI components
+  - Icons and images
+  - Spacing, radius, elevation constants
+
+### No Local Overrides
+
+**✅ CORRECT:**
+```dart
+// Feature uses design system
+import 'package:design_system/design_system.dart';
+
+Container(
+  color: UiColors.background,
+  padding: EdgeInsets.all(UiConstants.spacingL),
+  child: Text(
+    'Hello',
+    style: UiTypography.display1m,
+  ),
+)
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Custom colors in feature
+const myBlue = Color(0xFF1A2234);
+
+// ❌ Custom text styles in feature
+const myStyle = TextStyle(fontSize: 24, fontWeight: FontWeight.bold);
+
+// ❌ Theme overrides in feature
+Theme(
+  data: ThemeData(primaryColor: Colors.blue),
+  child: MyWidget(),
+)
+```
+
+### Extension Policy
+
+If a required style is missing:
+1. **FIRST:** Add it to `design_system` following existing patterns
+2. **THEN:** Use it in your feature
+
+**DO NOT** create temporary workarounds with hardcoded values.
+
+## 2. Package Structure
+
+```
+apps/mobile/packages/design_system/
+├── lib/
+│   ├── src/
+│   │   ├── ui_colors.dart          # Color tokens
+│   │   ├── ui_typography.dart      # Text styles
+│   │   ├── ui_icons.dart           # Icon exports
+│   │   ├── ui_constants.dart       # Spacing, radius, elevation
+│   │   ├── ui_theme.dart           # ThemeData factory
+│   │   └── widgets/                # Shared UI components
+│   │       ├── custom_button.dart
+│   │       └── custom_app_bar.dart
+│   └── design_system.dart          # Public exports
+├── assets/
+│   ├── icons/
+│   ├── images/
+│   └── fonts/
+└── pubspec.yaml
+```
+
+## 3. Colors Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiColors for all color needs
+Container(color: UiColors.background)
+Text('Hello', style: TextStyle(color: UiColors.foreground))
+Icon(Icons.home, color: UiColors.primary)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Hardcoded hex colors
+Container(color: Color(0xFF1A2234))
+
+// ❌ Material color constants
+Container(color: Colors.blue)
+
+// ❌ Opacity on hardcoded colors
+Container(color: Color(0xFF1A2234).withOpacity(0.5))
+```
+
+### Available Color Categories
+
+**Brand Colors:**
+- `UiColors.primary` - Main brand color
+- `UiColors.secondary` - Secondary brand color
+- `UiColors.accent` - Accent highlights
+
+**Semantic Colors:**
+- `UiColors.background` - Page background
+- `UiColors.foreground` - Primary text color
+- `UiColors.card` - Card/container background
+- `UiColors.border` - Border colors
+- `UiColors.mutedForeground` - Secondary text
+
+**Status Colors:**
+- `UiColors.success` - Success states
+- `UiColors.warning` - Warning states
+- `UiColors.error` - Error states
+- `UiColors.info` - Information states
+
+### Color Matching from POCs
+
+When migrating POC designs:
+
+1. **Find closest match** in `UiColors`
+2. **Use existing color** even if slightly different
+3. **DO NOT add new colors** without design team approval
+
+**Example Process:**
+```dart
+// POC has: Color(0xFF2C3E50)
+// Find closest: UiColors.background or UiColors.card
+// Use: UiColors.card
+
+// POC has: Color(0xFF27AE60)
+// Find closest: UiColors.success
+// Use: UiColors.success
+```
+
+### Theme Access
+
+Colors can also be accessed via theme:
+```dart
+// Both are valid:
+Container(color: UiColors.primary)
+Container(color: Theme.of(context).colorScheme.primary)
+```
+
+## 4. Typography Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiTypography for all text
+Text('Title', style: UiTypography.display1m)
+Text('Body', style: UiTypography.body1r)
+Text('Label', style: UiTypography.caption1m)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Custom TextStyle
+Text('Title', style: TextStyle(
+  fontSize: 24,
+  fontWeight: FontWeight.bold,
+))
+
+// ❌ Manual font configuration
+Text('Body', style: TextStyle(
+  fontFamily: 'Inter',
+  fontSize: 16,
+))
+
+// ❌ Modifying existing styles inline
+Text('Title', style: UiTypography.display1m.copyWith(
+  fontSize: 28,  // ← Don't override size
+))
+```
+
+### Available Typography Styles
+
+**Display Styles (Large Headers):**
+- `UiTypography.display1m` - Display Medium
+- `UiTypography.display1sb` - Display Semi-Bold
+- `UiTypography.display1b` - Display Bold
+
+**Heading Styles:**
+- `UiTypography.heading1m` - H1 Medium
+- `UiTypography.heading1sb` - H1 Semi-Bold
+- `UiTypography.heading1b` - H1 Bold
+- `UiTypography.heading2m` - H2 Medium
+- `UiTypography.heading2sb` - H2 Semi-Bold
+
+**Body Styles:**
+- `UiTypography.body1r` - Body Regular
+- `UiTypography.body1m` - Body Medium
+- `UiTypography.body1sb` - Body Semi-Bold
+- `UiTypography.body2r` - Body 2 Regular
+
+**Caption/Label Styles:**
+- `UiTypography.caption1m` - Caption Medium
+- `UiTypography.caption1sb` - Caption Semi-Bold
+- `UiTypography.label1m` - Label Medium
+
+### Allowed Customizations
+
+**✅ ALLOWED (Color Only):**
+```dart
+// You MAY change color
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(
+    color: UiColors.error,  // ← OK
+  ),
+)
+```
+
+**❌ FORBIDDEN (Size, Weight, Family):**
+```dart
+// ❌ Don't change size
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontSize: 28),
+)
+
+// ❌ Don't change weight
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontWeight: FontWeight.w900),
+)
+
+// ❌ Don't change family
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontFamily: 'Roboto'),
+)
+```
+
+### Typography Matching from POCs
+
+When migrating:
+1. Identify text role (heading, body, caption)
+2. Find closest matching style in `UiTypography`
+3. Use existing style even if size/weight differs slightly
+
+## 5. Icons Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiIcons
+Icon(UiIcons.home)
+Icon(UiIcons.profile)
+Icon(UiIcons.chevronLeft)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Direct icon library imports
+import 'package:lucide_icons/lucide_icons.dart';
+Icon(LucideIcons.home)
+
+// ❌ Font Awesome direct
+import 'package:font_awesome_flutter/font_awesome_flutter.dart';
+FaIcon(FontAwesomeIcons.house)
+```
+
+### Why Centralize Icons?
+
+1. **Consistency:** Same icon for same action everywhere
+2. **Branding:** Unified icon set with consistent stroke weight
+3. **Swappability:** Change icon library in one place
+
+### Icon Libraries
+
+Design system uses:
+- `typedef _IconLib = LucideIcons;` (primary)
+- `typedef _IconLib2 = FontAwesomeIcons;` (secondary)
+
+**Features MUST NOT import these directly.**
+
+### Adding New Icons
+
+If icon missing:
+1. Add to `ui_icons.dart`:
+```dart
+class UiIcons {
+  static const home = _IconLib.home;
+  static const newIcon = _IconLib.newIcon;  // Add here
+}
+```
+2. Use in feature:
+```dart
+Icon(UiIcons.newIcon)
+```
+
+## 6. Spacing & Layout Constants
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiConstants for spacing
+Padding(padding: EdgeInsets.all(UiConstants.spacingL))
+SizedBox(height: UiConstants.spacingM)
+Container(
+  padding: EdgeInsets.symmetric(
+    horizontal: UiConstants.spacingL,
+    vertical: UiConstants.spacingM,
+  ),
+)
+
+// Use UiConstants for radius
+Container(
+  decoration: BoxDecoration(
+    borderRadius: BorderRadius.circular(UiConstants.radiusM),
+  ),
+)
+
+// Use UiConstants for elevation
+elevation: UiConstants.elevationLow
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Magic numbers
+Padding(padding: EdgeInsets.all(16.0))
+SizedBox(height: 24.0)
+BorderRadius.circular(8.0)
+elevation: 2.0
+```
+
+### Available Constants
+
+**Spacing:**
+```dart
+UiConstants.spacingXs   // Extra small
+UiConstants.spacingS    // Small
+UiConstants.spacingM    // Medium
+UiConstants.spacingL    // Large
+UiConstants.spacingXl   // Extra large
+UiConstants.spacing2xl  // 2x Extra large
+```
+
+**Border Radius:**
+```dart
+UiConstants.radiusS     // Small
+UiConstants.radiusM     // Medium
+UiConstants.radiusL     // Large
+UiConstants.radiusXl    // Extra large
+UiConstants.radiusFull  // Fully rounded
+```
+
+**Elevation:**
+```dart
+UiConstants.elevationNone
+UiConstants.elevationLow
+UiConstants.elevationMedium
+UiConstants.elevationHigh
+```
+
+## 7. Smart Widgets Usage
+
+### When to Use
+
+- **Prefer standard Flutter Material widgets** styled via theme
+- **Use design system widgets** for non-standard patterns
+- **Create new widgets** in design system if reused >3 features
+
+### Navigation in Widgets
+
+Widgets with navigation MUST use safe methods:
+
+**✅ CORRECT:**
+```dart
+// In UiAppBar back button:
+import 'package:flutter_modular/flutter_modular.dart';
+import 'package:krow_core/krow_core.dart';
+
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Modular.to.popSafe(),  // ← Safe pop
+)
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Direct Navigator
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Navigator.pop(context),
+)
+
+// ❌ Unsafe Modular
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Modular.to.pop(),  // Can crash
+)
+```
+
+### Composition Over Inheritance
+
+**✅ CORRECT:**
+```dart
+// Compose standard widgets
+Container(
+  padding: EdgeInsets.all(UiConstants.spacingL),
+  decoration: BoxDecoration(
+    color: UiColors.card,
+    borderRadius: BorderRadius.circular(UiConstants.radiusM),
+  ),
+  child: Column(
+    children: [
+      Text('Title', style: UiTypography.heading1sb),
+      SizedBox(height: UiConstants.spacingM),
+      Text('Body', style: UiTypography.body1r),
+    ],
+  ),
+)
+```
+
+**❌ AVOID:**
+```dart
+// ❌ Deep custom widget hierarchies
+class CustomCard extends StatelessWidget {
+  // Complex custom implementation
+}
+```
+
+## 8. Theme Configuration
+
+### App Setup
+
+Apps initialize theme ONCE in root MaterialApp:
+
+**✅ CORRECT:**
+```dart
+// apps/mobile/apps/staff/lib/app_widget.dart
+import 'package:design_system/design_system.dart';
+
+class StaffApp extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp.router(
+      theme: StaffTheme.light,  // ← Design system theme
+      darkTheme: StaffTheme.dark,  // ← Optional dark mode
+      themeMode: ThemeMode.system,
+      // ...
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Custom theme in app
+MaterialApp.router(
+  theme: ThemeData(
+    primaryColor: Colors.blue,  // ← NO!
+  ),
+)
+
+// ❌ Theme override in feature
+Theme(
+  data: ThemeData(...),
+  child: MyFeatureWidget(),
+)
+```
+
+### Accessing Theme
+
+**Both methods valid:**
+```dart
+// Method 1: Direct design system import
+import 'package:design_system/design_system.dart';
+Text('Hello', style: UiTypography.body1r)
+
+// Method 2: Via theme context
+Text('Hello', style: Theme.of(context).textTheme.bodyMedium)
+```
+
+**Prefer Method 1** for explicit type safety.
+
+## 9. POC → Production Workflow
+
+### Step 1: Implement Structure (POC Matching)
+
+Implement UI layout exactly matching POC:
+```dart
+// Temporary: Match POC visually
+Container(
+  color: Color(0xFF1A2234),  // ← POC color
+  padding: EdgeInsets.all(16.0),  // ← POC spacing
+  child: Text(
+    'Title',
+    style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),  // ← POC style
+  ),
+)
+```
+
+**Purpose:** Ensure visual parity with POC before refactoring.
+
+### Step 2: Architecture Refactor
+
+Move to Clean Architecture:
+- Extract business logic to use cases
+- Move state management to BLoCs
+- Implement repository pattern
+- Use dependency injection
+
+### Step 3: Design System Integration
+
+Replace hardcoded values:
+```dart
+// Production: Design system tokens
+Container(
+  color: UiColors.background,  // ← Found closest match
+  padding: EdgeInsets.all(UiConstants.spacingL),  // ← Used constant
+  child: Text(
+    'Title',
+    style: UiTypography.heading1sb,  // ← Matched typography
+  ),
+)
+```
+
+**Color Matching:**
+- POC `#1A2234` → `UiColors.background`
+- POC `#3498DB` → `UiColors.primary`
+- POC `#27AE60` → `UiColors.success`
+
+**Typography Matching:**
+- POC `24px bold` → `UiTypography.heading1sb`
+- POC `16px regular` → `UiTypography.body1r`
+- POC `14px medium` → `UiTypography.caption1m`
+
+**Spacing Matching:**
+- POC `16px` → `UiConstants.spacingL`
+- POC `8px` → `UiConstants.spacingM`
+- POC `4px` → `UiConstants.spacingS`
+
+## 10. Anti-Patterns & Common Mistakes
+
+### ❌ Magic Numbers
+```dart
+// BAD
+EdgeInsets.all(12.0)
+SizedBox(height: 24.0)
+BorderRadius.circular(8.0)
+
+// GOOD
+EdgeInsets.all(UiConstants.spacingM)
+SizedBox(height: UiConstants.spacingL)
+BorderRadius.circular(UiConstants.radiusM)
+```
+
+### ❌ Local Themes
+```dart
+// BAD
+Theme(
+  data: ThemeData(primaryColor: Colors.blue),
+  child: MyWidget(),
+)
+
+// GOOD
+// Use global theme defined in app
+```
+
+### ❌ Hex Hunting
+```dart
+// BAD: Copy-paste from Figma
+Container(color: Color(0xFF3498DB))
+
+// GOOD: Find matching design system color
+Container(color: UiColors.primary)
+```
+
+### ❌ Direct Icon Library
+```dart
+// BAD
+import 'package:lucide_icons/lucide_icons.dart';
+Icon(LucideIcons.home)
+
+// GOOD
+Icon(UiIcons.home)
+```
+
+### ❌ Custom Text Styles
+```dart
+// BAD
+Text('Title', style: TextStyle(
+  fontSize: 24,
+  fontWeight: FontWeight.bold,
+  fontFamily: 'Inter',
+))
+
+// GOOD
+Text('Title', style: UiTypography.heading1sb)
+```
+
+## 11. Design System Review Checklist
+
+Before merging UI code:
+
+### ✅ Design System Compliance
+- [ ] No hardcoded `Color(...)` or `0xFF...` hex values
+- [ ] No custom `TextStyle(...)` definitions
+- [ ] All spacing uses `UiConstants.spacing*`
+- [ ] All radius uses `UiConstants.radius*`
+- [ ] All elevation uses `UiConstants.elevation*`
+- [ ] All icons from `UiIcons`, not direct library imports
+- [ ] Theme consumed from design system, no local overrides
+- [ ] Layout matches POC intent using design system primitives
+
+### ✅ Architecture Compliance
+- [ ] No business logic in widgets
+- [ ] State managed by BLoCs
+- [ ] Navigation uses Modular safe extensions
+- [ ] Localization used for all text (no hardcoded strings)
+- [ ] No direct Data Connect queries in widgets
+
+### ✅ Code Quality
+- [ ] Widget build methods concise (<50 lines)
+- [ ] Complex widgets extracted to separate files
+- [ ] Meaningful widget names
+- [ ] Doc comments on reusable widgets
+
+## 12. When to Extend Design System
+
+### Add New Color
+**When:** New brand color approved by design team
+
+**Process:**
+1. Add to `ui_colors.dart`:
+```dart
+class UiColors {
+  static const myNewColor = Color(0xFF123456);
+}
+```
+2. Update theme if needed
+3. Use in features
+
+### Add New Typography Style
+**When:** New text style pattern emerges across multiple features
+
+**Process:**
+1. Add to `ui_typography.dart`:
+```dart
+class UiTypography {
+  static const myNewStyle = TextStyle(
+    fontSize: 20,
+    fontWeight: FontWeight.w600,
+    fontFamily: _fontFamily,
+  );
+}
+```
+2. Use in features
+
+### Add Shared Widget
+**When:** Widget reused in 3+ features
+
+**Process:**
+1. Create in `lib/src/widgets/`:
+```dart
+// my_widget.dart
+class MyWidget extends StatelessWidget {
+  // Implementation using design system tokens
+}
+```
+2. Export from `design_system.dart`
+3. Use across features
+
+## Summary
+
+**Core Rules:**
+1. **All colors from `UiColors`** - Zero hex codes in features
+2. **All typography from `UiTypography`** - Zero custom TextStyle
+3. **All spacing/radius/elevation from `UiConstants`** - Zero magic numbers
+4. **All icons from `UiIcons`** - Zero direct library imports
+5. **Theme defined once** in app entry point
+6. **POC → Production** requires design system integration step
+
+**The Golden Rule:** Design system is immutable. Features adapt to the system, not the other way around.
+
+When implementing UI:
+1. Import `package:design_system/design_system.dart`
+2. Use design system tokens exclusively
+3. Match POC intent with available tokens
+4. Request new tokens only when truly necessary
+5. Never create temporary hardcoded workarounds
+
+Visual consistency is non-negotiable. Every pixel must come from the design system.

.agents/skills/krow-mobile-development-rules/SKILL.md

@@ -0,0 +1,646 @@
+---
+name: krow-mobile-development-rules
+description: Enforce KROW mobile app development standards including file structure, naming conventions, logic placement boundaries, localization, Data Connect integration, and prototype migration rules. Use this skill whenever working on KROW Flutter mobile features, creating new packages, implementing BLoCs, integrating with backend, or migrating from prototypes. Critical for maintaining clean architecture and preventing architectural degradation.
+---
+
+# KROW Mobile Development Rules
+
+These rules are **NON-NEGOTIABLE** enforcement guidelines for the KROW mobile application. They prevent architectural degradation and ensure consistency across the codebase.
+
+## When to Use This Skill
+
+- Creating new mobile features or packages
+- Implementing BLoCs, Use Cases, or Repositories
+- Integrating with Firebase Data Connect backend
+- Migrating code from prototypes
+- Reviewing mobile code for compliance
+- Setting up new feature modules
+- Handling user sessions and authentication
+- Implementing navigation flows
+
+## 1. File Creation & Package Structure
+
+### Feature-First Packaging
+
+**✅ DO:**
+- Create new features as independent packages:
+  ```
+  apps/mobile/packages/features/<app_name>/<feature_name>/
+  ├── lib/
+  │   ├── src/
+  │   │   ├── domain/
+  │   │   │   ├── repositories/
+  │   │   │   └── usecases/
+  │   │   ├── data/
+  │   │   │   └── repositories_impl/
+  │   │   └── presentation/
+  │   │       ├── blocs/
+  │   │       ├── pages/
+  │   │       └── widgets/
+  │   └── <feature_name>.dart  # Barrel file
+  └── pubspec.yaml
+  ```
+
+**❌ DON'T:**
+- Add features to `apps/mobile/packages/core` directly
+- Create files in app directories (`apps/mobile/apps/client/` or `apps/mobile/apps/staff/`)
+- Create cross-feature or cross-app dependencies (features must not import other features)
+
+### Path Conventions (Strict)
+
+Follow these exact paths:
+
+| Layer | Path Pattern | Example |
+|-------|-------------|---------|
+| **Entities** | `apps/mobile/packages/domain/lib/src/entities/<entity>.dart` | `user.dart`, `shift.dart` |
+| **Repository Interface** | `.../features/<app>/<feature>/lib/src/domain/repositories/<name>_repository_interface.dart` | `auth_repository_interface.dart` |
+| **Repository Impl** | `.../features/<app>/<feature>/lib/src/data/repositories_impl/<name>_repository_impl.dart` | `auth_repository_impl.dart` |
+| **Use Cases** | `.../features/<app>/<feature>/lib/src/application/<name>_usecase.dart` | `login_usecase.dart` |
+| **BLoCs** | `.../features/<app>/<feature>/lib/src/presentation/blocs/<name>_bloc.dart` | `auth_bloc.dart` |
+| **Pages** | `.../features/<app>/<feature>/lib/src/presentation/pages/<name>_page.dart` | `login_page.dart` |
+| **Widgets** | `.../features/<app>/<feature>/lib/src/presentation/widgets/<name>_widget.dart` | `password_field.dart` |
+
+### Barrel Files
+
+**✅ DO:**
+```dart
+// lib/auth_feature.dart
+export 'src/presentation/pages/login_page.dart';
+export 'src/domain/repositories/auth_repository_interface.dart';
+// Only export PUBLIC API
+```
+
+**❌ DON'T:**
+```dart
+// Don't export internal implementation details
+export 'src/data/repositories_impl/auth_repository_impl.dart';
+export 'src/presentation/blocs/auth_bloc.dart';
+```
+
+## 2. Naming Conventions (Dart Standard)
+
+| Type | Convention | Example | File Name |
+|------|-----------|---------|-----------|
+| **Files** | `snake_case` | `user_profile_page.dart` | - |
+| **Classes** | `PascalCase` | `UserProfilePage` | - |
+| **Variables** | `camelCase` | `userProfile` | - |
+| **Interfaces** | End with `Interface` | `AuthRepositoryInterface` | `auth_repository_interface.dart` |
+| **Implementations** | End with `Impl` | `AuthRepositoryImpl` | `auth_repository_impl.dart` |
+| **BLoCs** | End with `Bloc` or `Cubit` | `AuthBloc`, `ProfileCubit` | `auth_bloc.dart` |
+| **Use Cases** | End with `UseCase` | `LoginUseCase` | `login_usecase.dart` |
+
+## 3. Logic Placement (Zero Tolerance Boundaries)
+
+### Business Rules → Use Cases ONLY
+
+**✅ CORRECT:**
+```dart
+// login_usecase.dart
+class LoginUseCase extends UseCase<User, LoginParams> {
+  @override
+  Future<Either<Failure, User>> call(LoginParams params) async {
+    // Business logic here: validation, transformation, orchestration
+    if (params.email.isEmpty) {
+      return Left(ValidationFailure('Email required'));
+    }
+    return await repository.login(params);
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Business logic in BLoC
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) {
+    if (event.email.isEmpty) {  // ← NO! This is business logic
+      emit(AuthError('Email required'));
+    }
+  });
+}
+
+// ❌ Business logic in Widget
+class LoginPage extends StatelessWidget {
+  void _login() {
+    if (_emailController.text.isEmpty) {  // ← NO! This is business logic
+      showSnackbar('Email required');
+    }
+  }
+}
+```
+
+### State Logic → BLoCs ONLY
+
+**✅ CORRECT:**
+```dart
+// auth_bloc.dart
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) async {
+    emit(AuthLoading());
+    final result = await loginUseCase(LoginParams(email: event.email));
+    result.fold(
+      (failure) => emit(AuthError(failure)),
+      (user) => emit(AuthAuthenticated(user)),
+    );
+  });
+}
+
+// login_page.dart (StatelessWidget)
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<AuthBloc, AuthState>(
+      builder: (context, state) {
+        if (state is AuthLoading) return LoadingIndicator();
+        if (state is AuthError) return ErrorWidget(state.message);
+        return LoginForm();
+      },
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ setState in Pages for complex state
+class LoginPage extends StatefulWidget {
+  @override
+  State<LoginPage> createState() => _LoginPageState();
+}
+
+class _LoginPageState extends State<LoginPage> {
+  bool _isLoading = false;  // ← NO! Use BLoC
+  String? _error;          // ← NO! Use BLoC
+  
+  void _login() {
+    setState(() => _isLoading = true);  // ← NO! Use BLoC
+  }
+}
+```
+
+**RECOMMENDATION:** Pages should be `StatelessWidget` with state delegated to BLoCs.
+
+### Data Transformation → Repositories
+
+**✅ CORRECT:**
+```dart
+// profile_repository_impl.dart
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  @override
+  Future<Staff> getProfile(String id) async {
+    final response = await dataConnect.getStaffById(id: id).execute();
+    // Data transformation happens here
+    return Staff(
+      id: response.data.staff.id,
+      name: response.data.staff.name,
+      // Map Data Connect model to Domain entity
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ JSON parsing in UI
+class ProfilePage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    final json = jsonDecode(response.body);  // ← NO!
+    final name = json['name'];
+  }
+}
+
+// ❌ JSON parsing in Domain Use Case
+class GetProfileUseCase extends UseCase<Staff, String> {
+  @override
+  Future<Either<Failure, Staff>> call(String id) async {
+    final response = await http.get('/staff/$id');
+    final json = jsonDecode(response.body);  // ← NO!
+  }
+}
+```
+
+### Navigation → Flutter Modular + Safe Extensions
+
+**✅ CORRECT:**
+```dart
+// Use Safe Navigation Extensions
+import 'package:krow_core/krow_core.dart';
+
+// In widget/BLoC:
+Modular.to.safePush('/profile');
+Modular.to.safeNavigate('/home');
+Modular.to.popSafe();
+
+// Even better: Use Typed Navigators
+Modular.to.toStaffHome();  // Defined in StaffNavigator
+Modular.to.toShiftDetails(shiftId: '123');
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Direct Navigator.push
+Navigator.push(
+  context,
+  MaterialPageRoute(builder: (_) => ProfilePage()),
+);
+
+// ❌ Direct Modular navigation without safety
+Modular.to.navigate('/profile');  // ← Can cause blank screens
+Modular.to.pop();  // ← Can crash if stack is empty
+```
+
+**PATTERN:** All navigation MUST have fallback to Home page. Safe extensions automatically handle this.
+
+### Session Management → DataConnectService + SessionHandlerMixin
+
+**✅ CORRECT:**
+```dart
+// In main.dart:
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  // Initialize session listener (pick allowed roles for app)
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['STAFF', 'BOTH'],  // for staff app
+  );
+  
+  runApp(
+    SessionListener(  // Wraps entire app
+      child: ModularApp(module: AppModule(), child: AppWidget()),
+    ),
+  );
+}
+
+// In repository:
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    // _service.run() handles:
+    // - Auth validation
+    // - Token refresh (if <5 min to expiry)
+    // - Error handling with 3 retries
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**PATTERN:**
+- **SessionListener** widget wraps app and shows dialogs for session errors
+- **SessionHandlerMixin** in `DataConnectService` provides automatic token refresh
+- **3-attempt retry logic** with exponential backoff (1s → 2s → 4s)
+- **Role validation** configurable per app
+
+## 4. Localization Integration (core_localization)
+
+All user-facing text MUST be localized.
+
+### String Management
+
+**✅ CORRECT:**
+```dart
+// In presentation layer:
+import 'package:core_localization/core_localization.dart';
+
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Text(context.strings.loginButton);  // ← From localization
+    return ElevatedButton(
+      onPressed: _login,
+      child: Text(context.strings.submit),
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Hardcoded English strings
+Text('Login')
+Text('Submit')
+ElevatedButton(child: Text('Click here'))
+```
+
+### BLoC Integration
+
+**✅ CORRECT:**
+```dart
+// BLoCs emit domain failures (not localized strings)
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) async {
+    final result = await loginUseCase(params);
+    result.fold(
+      (failure) => emit(AuthError(failure)),  // ← Domain failure
+      (user) => emit(AuthAuthenticated(user)),
+    );
+  });
+}
+
+// UI translates failures to user-friendly messages
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<AuthBloc, AuthState>(
+      builder: (context, state) {
+        if (state is AuthError) {
+          final message = ErrorTranslator.translate(
+            state.failure,
+            context.strings,
+          );
+          return ErrorWidget(message);  // ← Localized
+        }
+      },
+    );
+  }
+}
+```
+
+### App Setup
+
+Apps must import `LocalizationModule()`:
+```dart
+// app_module.dart
+class AppModule extends Module {
+  @override
+  List<Module> get imports => [
+    LocalizationModule(),  // ← Required
+    DataConnectModule(),
+  ];
+}
+
+// main.dart
+runApp(
+  BlocProvider<LocaleBloc>(  // ← Expose locale state
+    create: (_) => Modular.get<LocaleBloc>(),
+    child: TranslationProvider(  // ← Enable context.strings
+      child: MaterialApp.router(...),
+    ),
+  ),
+);
+```
+
+## 5. Data Connect Integration
+
+All backend access goes through `DataConnectService`.
+
+### Repository Pattern
+
+**Step 1:** Define interface in feature domain:
+```dart
+// domain/repositories/profile_repository_interface.dart
+abstract interface class ProfileRepositoryInterface {
+  Future<Staff> getProfile(String id);
+  Future<bool> updateProfile(Staff profile);
+}
+```
+
+**Step 2:** Implement using `DataConnectService.run()`:
+```dart
+// data/repositories_impl/profile_repository_impl.dart
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**Benefits of `_service.run()`:**
+- ✅ Automatic auth validation
+- ✅ Token refresh if needed
+- ✅ 3-attempt retry with exponential backoff
+- ✅ Consistent error handling
+
+### Session Store Pattern
+
+After successful auth, populate session stores:
+```dart
+// For Staff App:
+StaffSessionStore.instance.setSession(
+  StaffSession(
+    user: user,
+    staff: staff,
+    ownerId: ownerId,
+  ),
+);
+
+// For Client App:
+ClientSessionStore.instance.setSession(
+  ClientSession(
+    user: user,
+    business: business,
+  ),
+);
+```
+
+**Lazy Loading:** If session is null, fetch via `getStaffById()` or `getBusinessById()` and update store.
+
+## 6. Prototype Migration Rules
+
+When migrating from `prototypes/`:
+
+### ✅ MAY Copy
+- Icons, images, assets (but match to design system)
+- `build` methods for UI layout structure
+- Screen flow and navigation patterns
+
+### ❌ MUST REJECT & REFACTOR
+- `GetX`, `Provider`, or `MVC` patterns
+- Any state management not using BLoC
+- Direct HTTP calls (must use Data Connect)
+- Hardcoded colors/typography (must use design system)
+- Global state variables
+- Navigation without Modular
+
+### Colors & Typography Migration
+**When matching POC to production:**
+1. Find closest color in `UiColors` (don't add new colors without approval)
+2. Find closest text style in `UiTypography`
+3. Use design system constants, NOT POC hardcoded values
+
+**DO NOT change the design system itself.** Colors and typography are FINAL. Match your feature to the system, not the other way around.
+
+## 7. Handling Ambiguity
+
+If requirements are unclear:
+
+1. **STOP** - Don't guess domain fields or workflows
+2. **ANALYZE** - Refer to:
+   - Architecture: `apps/mobile/docs/01-architecture-principles.md`
+   - Design System: `apps/mobile/docs/02-design-system-usage.md`
+   - Existing features for patterns
+3. **DOCUMENT** - Add `// ASSUMPTION: <explanation>` if you must proceed
+4. **ASK** - Prefer asking user for clarification on business rules
+
+## 8. Dependencies
+
+### DO NOT
+- Add 3rd party packages without checking `apps/mobile/packages/core` first
+- Add `firebase_auth` or `firebase_data_connect` to Feature packages (they belong in `data_connect` only)
+- Use `addSingleton` for BLoCs (always use `add` method in Modular)
+
+### DO
+- Use `DataConnectService.instance` for backend operations
+- Use Flutter Modular for dependency injection
+- Register BLoCs with `i.addSingleton<CubitType>(() => CubitType(...))`
+- Register Use Cases as factories or singletons as needed
+
+## 9. Error Handling Pattern
+
+### Domain Failures
+```dart
+// domain/failures/auth_failure.dart
+abstract class AuthFailure extends Failure {
+  const AuthFailure(String message) : super(message);
+}
+
+class InvalidCredentialsFailure extends AuthFailure {
+  const InvalidCredentialsFailure() : super('Invalid credentials');
+}
+```
+
+### Repository Error Mapping
+```dart
+// Map Data Connect exceptions to Domain failures
+try {
+  final response = await dataConnect.query();
+  return Right(response);
+} on DataConnectException catch (e) {
+  if (e.message.contains('unauthorized')) {
+    return Left(InvalidCredentialsFailure());
+  }
+  return Left(ServerFailure(e.message));
+}
+```
+
+### UI Feedback
+```dart
+// BLoC emits error state
+emit(AuthError(failure));
+
+// UI shows user-friendly message
+if (state is AuthError) {
+  final message = ErrorTranslator.translate(state.failure, context.strings);
+  ScaffoldMessenger.of(context).showSnackBar(
+    SnackBar(content: Text(message)),
+  );
+}
+```
+
+### Session Errors
+`SessionListener` automatically shows dialogs for:
+- Session expiration
+- Token refresh failures
+- Network errors during auth
+
+## 10. Testing Requirements
+
+### Unit Tests
+```dart
+// Test use cases with real repository implementations
+test('login with valid credentials returns user', () async {
+  final useCase = LoginUseCase(repository: mockRepository);
+  final result = await useCase(LoginParams(email: 'test@test.com'));
+  expect(result.isRight(), true);
+});
+```
+
+### Widget Tests
+```dart
+// Test UI widgets and BLoC interactions
+testWidgets('shows loading indicator when logging in', (tester) async {
+  await tester.pumpWidget(
+    BlocProvider<AuthBloc>(
+      create: (_) => authBloc,
+      child: LoginPage(),
+    ),
+  );
+  
+  authBloc.add(LoginRequested(email: 'test@test.com'));
+  await tester.pump();
+  
+  expect(find.byType(LoadingIndicator), findsOneWidget);
+});
+```
+
+### Integration Tests
+- Test full feature flows end-to-end with Data Connect
+- Use dependency injection to swap implementations if needed
+
+## 11. Clean Code Principles
+
+### Documentation
+- ✅ Add human readable doc comments for `dartdoc`  for all classes and methods.
+```dart
+/// Authenticates user with email and password.
+/// 
+/// Returns [User] on success or [AuthFailure] on failure.
+/// Throws [NetworkException] if connection fails.
+class LoginUseCase extends UseCase<User, LoginParams> {
+  // ...
+}
+```
+
+### Single Responsibility
+- Keep methods focused on one task
+- Extract complex logic to separate methods
+- Keep widget build methods concise
+- Extract complex widgets to separate files
+
+### Meaningful Names
+```dart
+// ✅ GOOD
+final isProfileComplete = await checkProfileCompletion();
+final userShifts = await fetchUserShifts();
+
+// ❌ BAD
+final flag = await check();
+final data = await fetch();
+```
+
+## Enforcement Checklist
+
+Before merging any mobile feature code:
+
+### Architecture Compliance
+- [ ] Feature follows package structure (domain/data/presentation)
+- [ ] No business logic in BLoCs or Widgets
+- [ ] All state management via BLoCs
+- [ ] All backend access via repositories
+- [ ] Session accessed via SessionStore, not global state
+- [ ] Navigation uses Flutter Modular safe extensions
+- [ ] No feature-to-feature imports
+
+### Code Quality
+- [ ] No hardcoded strings (use localization)
+- [ ] No hardcoded colors/typography (use design system)
+- [ ] All spacing uses UiConstants
+- [ ] Doc comments on public APIs
+- [ ] Meaningful variable names
+- [ ] Zero analyzer warnings
+
+### Integration
+- [ ] Data Connect queries via `_service.run()`
+- [ ] Error handling with domain failures
+- [ ] Proper dependency injection in modules
+
+## Summary
+
+The key principle: **Clean Architecture with zero tolerance for violations.** Business logic in Use Cases, state in BLoCs, data access in Repositories, UI in Widgets. Features are isolated, backend is centralized, localization is mandatory, and design system is immutable.
+
+When in doubt, refer to existing features following these patterns or ask for clarification. It's better to ask than to introduce architectural debt.

.agents/skills/krow-mobile-release/SKILL.md

@@ -0,0 +1,778 @@
+---
+name: krow-mobile-release
+description: KROW mobile app release process including versioning strategy, CHANGELOG management, GitHub Actions workflows, APK signing, Git tagging, and hotfix procedures. Use this when preparing mobile releases, updating CHANGELOGs, triggering release workflows, creating hotfix branches, troubleshooting release issues, or documenting release features. Covers both staff (worker) and client mobile products across dev/stage/prod environments.
+---
+
+# KROW Mobile Release Process
+
+This skill defines the comprehensive release process for KROW mobile applications (staff and client). It covers versioning, changelog management, GitHub Actions automation, and hotfix procedures.
+
+## When to Use This Skill
+
+- Preparing for a mobile app release
+- Updating CHANGELOG files with new features
+- Triggering GitHub Actions release workflows
+- Creating hotfix branches for production issues
+- Understanding version numbering strategy
+- Setting up APK signing secrets
+- Troubleshooting release workflow failures
+- Documenting release notes
+- Managing release cadence (dev → stage → prod)
+
+## Quick Reference
+
+### Release Workflows
+- **Product Release:** [GitHub Actions - Product Release](https://github.com/Oloodi/krow-workforce/actions/workflows/product-release.yml)
+- **Hotfix Creation:** [GitHub Actions - Product Hotfix](https://github.com/Oloodi/krow-workforce/actions/workflows/hotfix-branch-creation.yml)
+
+### Key Files
+- **Staff CHANGELOG:** `apps/mobile/apps/staff/CHANGELOG.md`
+- **Client CHANGELOG:** `apps/mobile/apps/client/CHANGELOG.md`
+- **Staff Version:** `apps/mobile/apps/staff/pubspec.yaml`
+- **Client Version:** `apps/mobile/apps/client/pubspec.yaml`
+
+### Comprehensive Documentation
+For complete details, see: [`docs/RELEASE/mobile-releases.md`](docs/RELEASE/mobile-releases.md) (900+ lines)
+
+## 1. Versioning Strategy
+
+### Format
+
+```
+v{major}.{minor}.{patch}-{milestone}
+```
+
+**Examples:**
+- `v0.0.1-m4` - Milestone 4 release
+- `v0.1.0-m5` - Minor version bump for Milestone 5
+- `v1.0.0` - First production release (no milestone suffix)
+
+### Semantic Versioning Rules
+
+**Major (X.0.0):**
+- Breaking changes
+- Complete architecture overhaul
+- Incompatible API changes
+
+**Minor (0.X.0):**
+- New features
+- Backwards-compatible additions
+- Milestone completions
+
+**Patch (0.0.X):**
+- Bug fixes
+- Security patches
+- Performance improvements
+
+**Milestone Suffix:**
+- `-m1`, `-m2`, `-m3`, `-m4`, etc.
+- Indicates pre-production milestone phase
+- Removed for production releases
+
+### Version Location
+
+Versions are defined in `pubspec.yaml`:
+
+**Staff App:**
+```yaml
+# apps/mobile/apps/staff/pubspec.yaml
+name: krow_staff_app
+version: 0.0.1-m4+1  # version+build_number
+```
+
+**Client App:**
+```yaml
+# apps/mobile/apps/client/pubspec.yaml
+name: krow_client_app
+version: 0.0.1-m4+1
+```
+
+**Format:** `version+build`
+- `version`: Semantic version with milestone (e.g., `0.0.1-m4`)
+- `build`: Build number (increments with each build, e.g., `+1`, `+2`)
+
+## 2. CHANGELOG Management
+
+### Format
+
+Each app maintains a separate CHANGELOG following [Keep a Changelog](https://keepachangelog.com/) format.
+
+**Structure:**
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+### Added
+- New feature descriptions
+
+### Changed
+- Modified feature descriptions
+
+### Fixed
+- Bug fix descriptions
+
+### Removed
+- Removed feature descriptions
+
+## [0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added
+- Profile management with 13 subsections
+- Documents & certificates management
+- Benefits overview section
+- Camera/gallery support for attire verification
+
+### Changed
+- Enhanced session management with auto token refresh
+
+### Fixed
+- Navigation fallback to home on invalid routes
+```
+
+### Section Guidelines
+
+**[Unreleased]**
+- Work in progress
+- Features merged to dev but not released
+- Updated continuously during development
+
+**[Version] - Milestone X - Date**
+- Released version
+- Format: `[X.Y.Z-mN] - Milestone N - YYYY-MM-DD`
+- Organized by change type (Added/Changed/Fixed/Removed)
+
+### Change Type Definitions
+
+**Added:**
+- New features
+- New UI screens
+- New API integrations
+- New user-facing capabilities
+
+**Changed:**
+- Modifications to existing features
+- UI/UX improvements
+- Performance enhancements
+- Refactored code (if user-facing impact)
+
+**Fixed:**
+- Bug fixes
+- Error handling improvements
+- Crash fixes
+- UI/UX issues resolved
+
+**Removed:**
+- Deprecated features
+- Removed screens or capabilities
+- Discontinued integrations
+
+### Writing Guidelines
+
+**✅ GOOD:**
+```markdown
+### Added
+- Profile management with 13 subsections organized into onboarding, compliance, finances, and support categories
+- Documents & certificates management with upload, status tracking, and expiry dates
+- Camera and gallery support for attire verification with photo capture
+- Benefits overview section displaying perks and company information
+```
+
+**❌ BAD:**
+```markdown
+### Added
+- New stuff
+- Fixed things
+- Updated code
+```
+
+**Key Principles:**
+- Be specific and descriptive
+- Focus on user-facing changes
+- Mention UI screens, features, or capabilities
+- Avoid technical jargon users won't understand
+- Group related changes together
+
+### Updating CHANGELOG Workflow
+
+**Step 1:** During development, add to `[Unreleased]`:
+```markdown
+## [Unreleased]
+
+### Added
+- New shift calendar view with month/week toggle
+- Shift acceptance confirmation dialog
+
+### Fixed
+- Navigation crash when popping empty stack
+```
+
+**Step 2:** Before release, move to version section:
+```markdown
+## [0.1.0-m5] - Milestone 5 - 2026-03-15
+
+### Added
+- New shift calendar view with month/week toggle
+- Shift acceptance confirmation dialog
+
+### Fixed
+- Navigation crash when popping empty stack
+
+## [Unreleased]
+<!-- Empty for next development cycle -->
+```
+
+**Step 3:** Update version in `pubspec.yaml`:
+```yaml
+version: 0.1.0-m5+1
+```
+
+## 3. Git Tagging Strategy
+
+### Tag Format
+
+```
+krow-withus-<app>-mobile/<env>-vX.Y.Z
+```
+
+**Components:**
+- `<app>`: `worker` (staff) or `client`
+- `<env>`: `dev`, `stage`, or `prod`
+- `vX.Y.Z`: Semantic version (from pubspec.yaml)
+
+**Examples:**
+```
+krow-withus-worker-mobile/dev-v0.0.1-m4
+krow-withus-worker-mobile/stage-v0.0.1-m4
+krow-withus-worker-mobile/prod-v0.0.1-m4
+krow-withus-client-mobile/dev-v0.0.1-m4
+```
+
+### Tag Creation
+
+Tags are created automatically by GitHub Actions workflows. Manual tagging:
+
+```bash
+# Staff app - dev environment
+git tag krow-withus-worker-mobile/dev-v0.0.1-m4
+git push origin krow-withus-worker-mobile/dev-v0.0.1-m4
+
+# Client app - prod environment
+git tag krow-withus-client-mobile/prod-v1.0.0
+git push origin krow-withus-client-mobile/prod-v1.0.0
+```
+
+### Tag Listing
+
+```bash
+# List all mobile tags
+git tag -l "krow-withus-*-mobile/*"
+
+# List staff app tags
+git tag -l "krow-withus-worker-mobile/*"
+
+# List production tags
+git tag -l "krow-withus-*-mobile/prod-*"
+```
+
+## 4. GitHub Actions Workflows
+
+### 4.1 Product Release Workflow
+
+**File:** `.github/workflows/product-release.yml`
+
+**Purpose:** Automated production releases with APK signing
+
+**Trigger:** Manual dispatch via GitHub UI
+
+**Inputs:**
+- `app`: Select `worker` (staff) or `client`
+- `environment`: Select `dev`, `stage`, or `prod`
+
+**Process:**
+1. ✅ Extracts version from `pubspec.yaml` automatically
+2. ✅ Builds signed APKs for selected app
+3. ✅ Creates GitHub release with CHANGELOG notes
+4. ✅ Tags release (e.g., `krow-withus-worker-mobile/dev-v0.0.1-m4`)
+5. ✅ Uploads APKs as release assets
+6. ✅ Generates step summary with emojis
+
+**Key Features:**
+- **No manual version input** - reads from pubspec.yaml
+- **APK signing** - uses GitHub Secrets for keystore
+- **CHANGELOG extraction** - pulls release notes automatically
+- **Visual feedback** - emojis in all steps
+
+**Usage:**
+```
+1. Go to: GitHub Actions → "📦 Product Release"
+2. Click "Run workflow"
+3. Select app (worker/client)
+4. Select environment (dev/stage/prod)
+5. Click "Run workflow"
+6. Wait for completion (~5-10 minutes)
+```
+
+**Release Naming:**
+```
+Krow With Us - Worker Product - DEV - v0.0.1-m4
+Krow With Us - Client Product - PROD - v1.0.0
+```
+
+### 4.2 Product Hotfix Workflow
+
+**File:** `.github/workflows/hotfix-branch-creation.yml`
+
+**Purpose:** Emergency production fix automation
+
+**Trigger:** Manual dispatch with version input
+
+**Inputs:**
+- `current_version`: Current production version (e.g., `0.0.1-m4`)
+- `issue_description`: Brief description of the hotfix
+
+**Process:**
+1. ✅ Creates `hotfix/<version>` branch from latest production tag
+2. ✅ Auto-increments PATCH version (e.g., `0.0.1-m4` → `0.0.2-m4`)
+3. ✅ Updates `pubspec.yaml` with new version
+4. ✅ Updates `CHANGELOG.md` with hotfix section
+5. ✅ Creates PR back to main branch
+6. ✅ Includes hotfix instructions in PR description
+
+**Usage:**
+```
+1. Go to: GitHub Actions → "🚨 Product Hotfix - Create Branch"
+2. Click "Run workflow"
+3. Enter current production version (e.g., 0.0.1-m4)
+4. Enter issue description (e.g., "critical crash on login")
+5. Click "Run workflow"
+6. Workflow creates branch and PR
+7. Fix bug on hotfix branch
+8. Merge PR to main
+9. Use Product Release workflow to deploy
+```
+
+**Hotfix Branch Naming:**
+```
+hotfix/0.0.2-m4-critical-crash-on-login
+```
+
+### 4.3 Helper Scripts
+
+**Location:** `.github/scripts/`
+
+**Available Scripts:**
+1. **extract-version.sh** - Extract version from pubspec.yaml
+2. **generate-tag-name.sh** - Generate standardized tag names
+3. **extract-release-notes.sh** - Extract CHANGELOG sections
+4. **create-release-summary.sh** - Generate GitHub Step Summary with emojis
+
+**Script Permissions:**
+```bash
+chmod +x .github/scripts/*.sh
+```
+
+**Usage Example:**
+```bash
+# Extract version from staff app
+.github/scripts/extract-version.sh apps/mobile/apps/staff/pubspec.yaml
+
+# Generate tag name
+.github/scripts/generate-tag-name.sh worker dev 0.0.1-m4
+
+# Extract release notes for version
+.github/scripts/extract-release-notes.sh apps/mobile/apps/staff/CHANGELOG.md 0.0.1-m4
+```
+
+## 5. APK Signing Setup
+
+### Required GitHub Secrets (24 Total)
+
+**Per App (12 secrets each):**
+
+**Staff (Worker) App:**
+```
+STAFF_UPLOAD_KEYSTORE_BASE64       # Base64-encoded keystore file
+STAFF_UPLOAD_STORE_PASSWORD        # Keystore password
+STAFF_UPLOAD_KEY_ALIAS             # Key alias
+STAFF_UPLOAD_KEY_PASSWORD          # Key password
+STAFF_KEYSTORE_PROPERTIES_BASE64   # Base64-encoded key.properties file
+```
+
+**Client App:**
+```
+CLIENT_UPLOAD_KEYSTORE_BASE64
+CLIENT_UPLOAD_STORE_PASSWORD
+CLIENT_UPLOAD_KEY_ALIAS
+CLIENT_UPLOAD_KEY_PASSWORD
+CLIENT_KEYSTORE_PROPERTIES_BASE64
+```
+
+### Generating Secrets
+
+**Step 1: Create Keystore**
+
+```bash
+# For staff app
+keytool -genkey -v \
+  -keystore staff-upload-keystore.jks \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 10000 \
+  -alias staff-upload
+
+# For client app
+keytool -genkey -v \
+  -keystore client-upload-keystore.jks \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 10000 \
+  -alias client-upload
+```
+
+**Step 2: Base64 Encode**
+
+```bash
+# Encode keystore
+base64 -i staff-upload-keystore.jks | tr -d '\n' > staff-keystore.txt
+
+# Encode key.properties
+base64 -i key.properties | tr -d '\n' > key-props.txt
+```
+
+**Step 3: Add to GitHub Secrets**
+
+```
+Repository → Settings → Secrets and variables → Actions → New repository secret
+```
+
+Add each secret:
+- Name: `STAFF_UPLOAD_KEYSTORE_BASE64`
+- Value: Contents of `staff-keystore.txt`
+
+Repeat for all 24 secrets.
+
+### key.properties Format
+
+```properties
+storePassword=your_store_password
+keyPassword=your_key_password
+keyAlias=staff-upload
+storeFile=../staff-upload-keystore.jks
+```
+
+## 6. Release Process (Step-by-Step)
+
+### Standard Release (Dev/Stage/Prod)
+
+**Step 1: Prepare CHANGELOG**
+
+Update `CHANGELOG.md` with all changes since last release:
+```markdown
+## [0.1.0-m5] - Milestone 5 - 2026-03-15
+
+### Added
+- Shift calendar with month/week views
+- Enhanced navigation with typed routes
+- Profile completion wizard
+
+### Fixed
+- Session token refresh timing
+- Navigation fallback logic
+```
+
+**Step 2: Update Version**
+
+Edit `pubspec.yaml`:
+```yaml
+version: 0.1.0-m5+1  # Changed from 0.0.1-m4+1
+```
+
+**Step 3: Commit and Push**
+
+```bash
+git add apps/mobile/apps/staff/CHANGELOG.md
+git add apps/mobile/apps/staff/pubspec.yaml
+git commit -m "chore(staff): prepare v0.1.0-m5 release"
+git push origin dev
+```
+
+**Step 4: Trigger Workflow**
+
+1. Go to GitHub Actions → "📦 Product Release"
+2. Click "Run workflow"
+3. Select branch: `dev`
+4. Select app: `worker` (or `client`)
+5. Select environment: `dev` (or `stage`, `prod`)
+6. Click "Run workflow"
+
+**Step 5: Monitor Progress**
+
+Watch workflow execution:
+- ⏳ Version extraction
+- ⏳ APK building
+- ⏳ APK signing
+- ⏳ GitHub Release creation
+- ⏳ Tag creation
+- ⏳ Asset upload
+
+**Step 6: Verify Release**
+
+1. Check GitHub Releases page
+2. Download APK to verify
+3. Install on test device
+4. Verify version in app
+
+### Hotfix Release
+
+**Step 1: Identify Production Issue**
+
+- Critical bug in production
+- User-reported crash
+- Security vulnerability
+
+**Step 2: Trigger Hotfix Workflow**
+
+1. Go to GitHub Actions → "🚨 Product Hotfix - Create Branch"
+2. Click "Run workflow"
+3. Enter current version: `0.0.1-m4`
+4. Enter description: `Critical crash on login screen`
+5. Click "Run workflow"
+
+**Step 3: Review Created Branch**
+
+Workflow creates:
+- Branch: `hotfix/0.0.2-m4-critical-crash-on-login`
+- PR to `main` branch
+- Updated `pubspec.yaml`: `0.0.2-m4+1`
+- Updated `CHANGELOG.md` with hotfix section
+
+**Step 4: Fix Bug**
+
+```bash
+git checkout hotfix/0.0.2-m4-critical-crash-on-login
+
+# Make fixes
+# ... code changes ...
+
+git add .
+git commit -m "fix(auth): resolve crash on login screen"
+git push origin hotfix/0.0.2-m4-critical-crash-on-login
+```
+
+**Step 5: Merge PR**
+
+1. Review PR on GitHub
+2. Approve and merge to `main`
+3. Delete hotfix branch
+
+**Step 6: Release to Production**
+
+1. Use Product Release workflow
+2. Select `main` branch
+3. Select `prod` environment
+4. Deploy hotfix
+
+## 7. Release Cadence
+
+### Development (dev)
+
+- **Frequency:** Multiple times per day
+- **Purpose:** Testing features in dev environment
+- **Branch:** `dev`
+- **Audience:** Internal development team
+- **Approval:** Not required
+
+### Staging (stage)
+
+- **Frequency:** 1-2 times per week
+- **Purpose:** QA testing, stakeholder demos
+- **Branch:** `main`
+- **Audience:** QA team, stakeholders
+- **Approval:** Tech lead approval
+
+### Production (prod)
+
+- **Frequency:** Every 2-3 weeks (milestone completion)
+- **Purpose:** End-user releases
+- **Branch:** `main`
+- **Audience:** All users
+- **Approval:** Product owner + tech lead approval
+
+### Milestone Releases
+
+- **Frequency:** Every 2-4 weeks
+- **Version Bump:** Minor version (e.g., `0.1.0-m5` → `0.2.0-m6`)
+- **Process:**
+  1. Complete all milestone features
+  2. Update CHANGELOG with comprehensive release notes
+  3. Deploy to stage for final QA
+  4. After approval, deploy to prod
+  5. Create GitHub release with milestone summary
+
+## 8. Troubleshooting
+
+### Workflow Fails: Version Extraction
+
+**Error:** "Could not extract version from pubspec.yaml"
+
+**Solutions:**
+1. Verify `pubspec.yaml` exists at expected path
+2. Check version format: `version: X.Y.Z-mN+B`
+3. Ensure no extra spaces or tabs
+4. Verify file is committed and pushed
+
+### Workflow Fails: APK Signing
+
+**Error:** "Keystore password incorrect"
+
+**Solutions:**
+1. Verify GitHub Secrets are set correctly
+2. Re-generate and re-encode keystore
+3. Check key.properties format
+4. Ensure passwords don't contain special characters that need escaping
+
+### Workflow Fails: CHANGELOG Extraction
+
+**Error:** "Could not find version in CHANGELOG"
+
+**Solutions:**
+1. Verify CHANGELOG format matches: `## [X.Y.Z-mN] - Milestone N - YYYY-MM-DD`
+2. Check square brackets are present
+3. Ensure version matches pubspec.yaml
+4. Add version section if missing
+
+### Tag Already Exists
+
+**Error:** "tag already exists"
+
+**Solutions:**
+1. Delete existing tag locally and remotely:
+```bash
+git tag -d krow-withus-worker-mobile/dev-v0.0.1-m4
+git push origin :refs/tags/krow-withus-worker-mobile/dev-v0.0.1-m4
+```
+2. Re-run workflow
+
+### Build Fails: Flutter Errors
+
+**Error:** "flutter build failed"
+
+**Solutions:**
+1. Test build locally first:
+```bash
+cd apps/mobile/apps/staff
+flutter build apk --release
+```
+2. Fix any analyzer errors
+3. Ensure all dependencies are compatible
+4. Clear build cache:
+```bash
+flutter clean
+flutter pub get
+```
+
+## 9. Local Testing
+
+Before triggering workflows, test builds locally:
+
+### Building APKs Locally
+
+**Staff App:**
+```bash
+cd apps/mobile/apps/staff
+flutter clean
+flutter pub get
+flutter build apk --release
+```
+
+**Client App:**
+```bash
+cd apps/mobile/apps/client
+flutter clean
+flutter pub get
+flutter build apk --release
+```
+
+### Testing Release Notes
+
+Extract CHANGELOG section:
+```bash
+.github/scripts/extract-release-notes.sh \
+  apps/mobile/apps/staff/CHANGELOG.md \
+  0.0.1-m4
+```
+
+### Verifying Version
+
+Extract version from pubspec:
+```bash
+.github/scripts/extract-version.sh \
+  apps/mobile/apps/staff/pubspec.yaml
+```
+
+## 10. Best Practices
+
+### CHANGELOG
+- ✅ Update continuously during development
+- ✅ Be specific and user-focused
+- ✅ Group related changes
+- ✅ Include UI/UX changes
+- ❌ Don't include technical debt or refactoring (unless user-facing)
+- ❌ Don't use vague descriptions
+
+### Versioning
+- ✅ Use semantic versioning strictly
+- ✅ Increment patch for bug fixes
+- ✅ Increment minor for new features
+- ✅ Keep milestone suffix until production
+- ❌ Don't skip versions
+- ❌ Don't use arbitrary version numbers
+
+### Git Tags
+- ✅ Follow standard format
+- ✅ Let workflow create tags automatically
+- ✅ Keep tags synced with releases
+- ❌ Don't create tags manually unless necessary
+- ❌ Don't reuse deleted tags
+
+### Workflows
+- ✅ Test builds locally first
+- ✅ Monitor workflow execution
+- ✅ Verify release assets
+- ✅ Test APK on device before announcing
+- ❌ Don't trigger multiple workflows simultaneously
+- ❌ Don't bypass approval process
+
+## Summary
+
+**Release Process Overview:**
+1. Update CHANGELOG with changes
+2. Update version in pubspec.yaml
+3. Commit and push to appropriate branch
+4. Trigger Product Release workflow
+5. Monitor execution and verify release
+6. Test APK on device
+7. Announce to team/users
+
+**Key Files:**
+- `apps/mobile/apps/staff/CHANGELOG.md`
+- `apps/mobile/apps/client/CHANGELOG.md`
+- `apps/mobile/apps/staff/pubspec.yaml`
+- `apps/mobile/apps/client/pubspec.yaml`
+
+**Key Workflows:**
+- Product Release (standard releases)
+- Product Hotfix (emergency fixes)
+
+**For Complete Details:**
+See [`docs/RELEASE/mobile-releases.md`](docs/RELEASE/mobile-releases.md) - 900+ line comprehensive guide with:
+- Detailed APK signing setup
+- Complete troubleshooting guide
+- All helper scripts documentation
+- Release checklist
+- Security best practices
+
+When in doubt, refer to the comprehensive documentation or ask for clarification before releasing to production.

.agents/skills/krow-paper-design/SKILL.md

@@ -0,0 +1,413 @@
+---
+name: krow-paper-design
+description: KROW Paper design file conventions covering design tokens, component patterns, screen structure, and naming rules. Use this when creating or updating screens in the Paper design tool, auditing designs for token compliance, building new flows, or restructuring existing frames. Ensures visual consistency across all Paper design files for the KROW staff and client apps.
+---
+
+# KROW Paper Design Conventions
+
+This skill defines the design token system, component patterns, screen structure conventions, and workflow rules established for the KROW Design Revamp Paper file. All design work in Paper must follow these conventions.
+
+## When to Use This Skill
+
+- Creating new screens or flows in Paper
+- Updating existing frames to match the design system
+- Auditing designs for token compliance
+- Adding components (buttons, chips, inputs, badges, cards)
+- Structuring shift detail pages, onboarding flows, or list screens
+- Setting up navigation patterns (back buttons, bottom nav, CTAs)
+- Reviewing Paper designs before handoff to development
+
+## 1. Design Tokens
+
+### Color Palette
+
+| Token | Hex | Usage |
+|-------|-----|-------|
+| Primary | `#0A39DF` | CTAs, active states, links, selected chips, nav active icons, pay rates |
+| Foreground | `#121826` | Headings, primary text, dark UI elements |
+| Text Secondary | `#6A7382` | Labels, captions, inactive nav, section headers, placeholder text, back chevrons |
+| Secondary BG | `#F1F3F5` | Subtle backgrounds, dividers, map placeholders |
+| Border | `#D1D5DB` | Card borders, unselected chip borders, outline button borders |
+| Input Border | `#E2E8F0` | Text input borders (lighter than general border) |
+| Destructive | `#F04444` | Error states, destructive actions (e.g., Request Swap) |
+| Background | `#FAFBFC` | Page/artboard background |
+| Card BG | `#FFFFFF` | Card surfaces, input backgrounds |
+| Success | `#059669` | Active status dot, checkmark icons, requirement met |
+| Warning Amber | `#D97706` | Urgent/Pending badge text |
+
+### Semantic Badge Colors
+
+| Badge | Background | Text Color |
+|-------|-----------|------------|
+| Active | `#ECFDF5` | `#059669` |
+| Confirmed | `#EBF0FF` | `#0A39DF` |
+| Pending | `#FEF9EE` | `#D97706` |
+| Urgent | `#FEF9EE` | `#D97706` |
+| One-Time | `#ECFDF5` | `#059669` |
+| Recurring | `#EBF0FF` | `#0A39DF` (use `#EFF6FF` bg on detail pages) |
+
+### Typography
+
+| Style | Font | Size | Weight | Line Height | Usage |
+|-------|------|------|--------|-------------|-------|
+| Display | Inter Tight | 28px | 700 | 34px | Page titles (Find Shifts, My Shifts) |
+| H1 | Inter Tight | 24px | 700 | 30px | Detail page titles (venue names) |
+| H2 | Inter Tight | 20px | 700 | 26px | Section headings |
+| H3 | Inter Tight | 18px | 700 | 22px | Card titles, schedule values |
+| Body Large | Manrope | 16px | 600 | 20px | Button text, CTA labels |
+| Body Default | Manrope | 14px | 400-500 | 18px | Body text, descriptions |
+| Body Small | Manrope | 13px | 400-500 | 16px | Card metadata, time/pay info |
+| Caption | Manrope | 12px | 500-600 | 16px | Small chip text, tab labels |
+| Section Label | Manrope | 11px | 700 | 14px | Uppercase section headers (letter-spacing: 0.06em) |
+| Badge Text | Manrope | 11px | 600-700 | 14px | Status badge labels (letter-spacing: 0.04em) |
+| Nav Label | Manrope | 10px | 600 | 12px | Bottom nav labels |
+
+### Spacing
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| Page padding | 24px | Horizontal padding from screen edge |
+| Section gap | 16-24px | Between major content sections |
+| Group gap | 8-12px | Within a section (e.g., label to input) |
+| Element gap | 4px | Tight spacing (e.g., subtitle under title) |
+| Bottom safe area | 40px | Padding below last element / CTA |
+
+### Border Radii
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| sm | 8px | Small chips, badges, status pills, map placeholder |
+| md | 12px | Cards, inputs, location cards, contact cards, search fields |
+| lg | 14px | Buttons, CTA containers, shift cards (Find Shifts) |
+| xl | 24px | Not commonly used |
+| pill | 999px | Progress bar segments only |
+
+## 2. Component Patterns
+
+### Buttons
+
+**Primary CTA:**
+- Background: `#0A39DF`, radius: 14px, height: 52px
+- Text: Manrope 16px/600, color: `#FFFFFF`
+- Padding: 16px vertical, 16px horizontal
+
+**Secondary/Outline Button:**
+- Background: `#FFFFFF`, border: 1.5px `#D1D5DB`, radius: 14px, height: 52px
+- Text: Manrope 16px/600, color: `#121826`
+
+**Destructive Outline Button:**
+- Background: `#FFFFFF`, border: 1.5px `#F04444`, radius: 14px
+- Text: Manrope 14px/600, color: `#F04444`
+
+**Back Icon Button (Bottom CTA):**
+- 52x52px square, border: 1.5px `#D1D5DB`, radius: 14px, background: `#FFFFFF`
+- Contains chevron-left SVG (20x20, viewBox 0 0 24 24, stroke `#121826`, strokeWidth 2)
+- Path: `M15 18L9 12L15 6`
+
+### Chips
+
+**Default (Large) - for role/skill selection:**
+- Selected: bg `#EFF6FF`, border 1.5px `#0A39DF`, radius 10px, padding 12px/16px
+  - Checkmark icon (14x14, stroke `#0A39DF`), text Manrope 14px/600 `#0A39DF`
+- Unselected: bg `#FFFFFF`, border 1.5px `#6A7382`, radius 10px, padding 12px/16px
+  - Text Manrope 14px/500 `#6A7382`
+
+**Small - for tabs, filters:**
+- Selected: bg `#EFF6FF`, border 1.5px `#0A39DF`, radius 8px, padding 6px/12px
+  - Checkmark icon (12x12), text Manrope 12px/600 `#0A39DF`
+- Unselected: bg `#FFFFFF`, border 1.5px `#D1D5DB`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/500 `#6A7382`
+- Active (filled): bg `#0A39DF`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/600 `#FFFFFF`
+- Dark (filters button): bg `#121826`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/600 `#FFFFFF`, with leading icon
+
+**Status Badges:**
+- Radius: 8px, padding: 4px/8px
+- Text: Manrope 11px/600-700, uppercase, letter-spacing 0.04em
+- Colors follow semantic badge table above
+
+### Text Inputs
+
+- Border: 1.5px `#E2E8F0`, radius: 12px, padding: 12px/14px
+- Background: `#FFFFFF`
+- Placeholder: Manrope 14px/400, color `#6A7382`
+- Filled: Manrope 14px/500, color `#121826`
+- Label above: Manrope 14px/500, color `#121826`
+- Focused: border color `#0A39DF`, border-width 2px
+- Error: border color `#F04444`, helper text `#F04444`
+
+### Cards (Shift List Items)
+
+- Background: `#FFFFFF`, border: 1px `#D1D5DB`, radius: 12-14px
+- Padding: 16px
+- Content: venue name (Manrope 15px/600 `#121826`), subtitle (Manrope 13px/400 `#6A7382`)
+- Metadata row: icon (14px, `#6A7382`) + text (Manrope 13px/500 `#6A7382`)
+- Pay rate: Inter Tight 18px/700 `#0A39DF`
+
+### Schedule/Pay Info Cards
+
+- Two-column layout with 12px gap
+- Background: `#FFFFFF`, border: 1px `#D1D5DB`, radius: 12px, padding: 16px
+- Label: Manrope 11px/500-700 uppercase `#6A7382` (letter-spacing 0.05em)
+- Value: Inter Tight 18px/700 `#121826` (schedule) or `#121826` (pay)
+- Sub-text: Manrope 13px/400 `#6A7382`
+
+### Contact/Info Rows
+
+- Container: radius 12px, border 1px `#D1D5DB`, background `#FFFFFF`, overflow clip
+- Row: padding 13px/16px, gap 10px, border-bottom 1px `#F1F3F5` (except last)
+- Icon: 16px, stroke `#6A7382`
+- Label: Manrope 13px/500 `#6A7382`, width 72px fixed
+- Value: Manrope 13px/500 `#121826` (or `#0A39DF` for phone/links)
+
+### Section Headers
+
+- Text: Manrope 11px/700, uppercase, letter-spacing 0.06em, color `#6A7382`
+- Gap to content below: 10px
+
+## 3. Screen Structure
+
+### Artboard Setup
+
+- Width: 390px (iPhone standard)
+- Height: 844px (default), or `fit-content` for scrollable detail pages
+- Background: `#FAFBFC`
+- Flex column layout, overflow: clip
+
+### Frame Naming Convention
+
+```
+<app>-<section>-<screen_number>-<screen_name>
+```
+
+Examples:
+- `staff-1-1-splash`
+- `staff-2-3-personal-information`
+- `staff-4-1-my-shifts`
+- `staff-5-2-shift-details`
+- `shift-5-3-confirmation`
+
+Section headers use: `<number> - <Section Name>` (e.g., `4 - My Shifts`)
+
+### Status Bar
+
+- Height: 44px, full width (390px)
+- Left: "9:41" text (system font)
+- Right: Signal, WiFi, Battery SVG icons (68px wide)
+
+### Header Back Button
+
+- Placed below status bar in a combined "Status Bar + Back" frame (390x72px)
+- Chevron SVG: 20x20, viewBox 0 0 24 24, stroke `#6A7382`, strokeWidth 2
+- Path: `M15 18L9 12L15 6`
+- Back button frame: 390x28px, padding-left: 24px
+
+### Progress Bar (Onboarding)
+
+- Container: 342px wide (24px margins), 3px height segments
+- Segments: pill radius (999px), gap between
+- Filled: `#0A39DF`, Unfilled: `#F1F3F5`
+
+### Bottom CTA Convention
+
+- Pinned to bottom using `marginTop: auto` on the CTA container
+- Layout: flex row, gap 12px, padding 0 24px
+- Back button: 52x52px icon-only button with chevron-left (stroke `#121826`)
+- Primary CTA: flex 1, height 52px, radius 14px, bg `#0A39DF`
+- Bottom safe padding: 40px (on artboard paddingBottom)
+
+### Bottom Navigation Bar
+
+- Full width, padding: 10px top, 28px bottom
+- Border-top: 1px `#F1F3F5`, background: `#FFFFFF`
+- 5 items: Home, Shifts, Find, Payments, Profile
+- Active: icon stroke `#0A39DF`, label Manrope 10px/600 `#0A39DF`
+- Inactive: icon stroke `#6A7382`, label Manrope 10px/600 `#6A7382`
+- Active icon may have light fill (e.g., `#EBF0FF` on calendar/search)
+
+## 4. Screen Templates
+
+### List Screen (My Shifts, Find Shifts)
+
+```
+Artboard (390x844, bg #FAFBFC)
+  Status Bar (390x44)
+  Header Section
+    Page Title (Display: Inter Tight 28px/700)
+    Tab/Filter Chips (Small chip variant)
+  Content
+    Date Header (Section label style, uppercase)
+    Shift Cards (12px radius, 1px border #D1D5DB)
+  Bottom Nav Bar
+```
+
+### Detail Screen (Shift Details)
+
+```
+Artboard (390x fit-content, bg #FAFBFC)
+  Status Bar (390x44)
+  Header Bar (Back chevron + "Shift Details" title + share icon)
+  Badges Row (status chips)
+  Role Title (H1) + Venue (with avatar)
+  Schedule/Pay Cards (two-column)
+  Job Description (section label + body text)
+  Location (card with map + address)
+  Requirements (section label + checkmark list)
+  Shift Contact (section label + contact card with rows)
+  [Optional] Note from Manager (warm bg card)
+  Bottom CTA (pinned)
+```
+
+### Onboarding Screen
+
+```
+Artboard (390x844, bg #FAFBFC, justify: flex-start, paddingBottom: 40px)
+  Status Bar + Back (390x72)
+  Progress Bar (342px, 3px segments)
+  Step Counter ("Step X of Y" - Body Small)
+  Page Title (H1: Inter Tight 24px/700)
+  [Optional] Subtitle (Body Default)
+  Form Content (inputs, chips, sliders)
+  Bottom CTA (marginTop: auto - back icon + Continue)
+```
+
+### Confirmation Screen
+
+```
+Artboard (390x844, bg #FAFBFC)
+  Status Bar
+  Centered Content
+    Success Icon (green circle + checkmark)
+    Title (Display: Inter Tight 26px/700, centered)
+    Subtitle (Body Default, centered, #6A7382)
+    Details Card (border #D1D5DB, rows with label/value pairs)
+  Bottom CTAs (primary + outline)
+```
+
+## 5. Workflow Rules
+
+### Write Incrementally
+
+Each `write_html` call should produce ONE visual group:
+- A header, a card, a single list row, a button bar, a section
+- Never batch an entire screen in one call
+
+### Review Checkpoints
+
+After every 2-3 modifications, take a screenshot and evaluate:
+- **Spacing**: Uneven gaps, cramped groups
+- **Typography**: Hierarchy, readability, correct font/weight
+- **Contrast**: Text legibility, element distinction
+- **Alignment**: Vertical lanes, horizontal alignment
+- **Clipping**: Content cut off at edges
+- **Token compliance**: All values match design system tokens
+
+### Color Audit Process
+
+When updating frames to match the design system:
+1. Get computed styles for all text, background, border elements
+2. Map old colors to design system tokens:
+   - Dark navy (`#0F4C81`, `#1A3A5C`) -> Primary `#0A39DF`
+   - Near-black (`#111827`, `#0F172A`) -> Foreground `#121826`
+   - Gray variants (`#94A3B8`, `#64748B`, `#475569`) -> Text Secondary `#6A7382`
+   - Green accents (`#20B486`) -> Primary `#0A39DF` (for pay) or `#059669` (for status)
+3. Batch update using `update_styles` with multiple nodeIds per style change
+4. Verify with screenshots
+
+### Structural Consistency
+
+When creating matching screens (e.g., two shift detail views):
+- Use identical section ordering
+- Match section header styles (11px/700 uppercase `#6A7382`)
+- Use same card/row component patterns
+- Maintain consistent padding and gap values
+
+## 6. SVG Icon Patterns
+
+### Chevron Left (Back)
+```html
+<svg width="20" height="20" viewBox="0 0 24 24" fill="none">
+  <path d="M15 18L9 12L15 6" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Map Pin
+```html
+<svg width="18" height="18" viewBox="0 0 24 24" fill="none">
+  <path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="12" cy="10" r="3" stroke="#6A7382" stroke-width="2"/>
+</svg>
+```
+
+### User (Supervisor)
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="12" cy="7" r="4" stroke="#6A7382" stroke-width="2"/>
+</svg>
+```
+
+### Phone
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72c.127.96.361 1.903.7 2.81a2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45c.907.339 1.85.573 2.81.7A2 2 0 0 1 22 16.92z" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Checkmark (Requirement Met)
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M22 4L12 14.01l-3-3" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Chip Checkmark
+```html
+<!-- Large chip (14x14) -->
+<svg width="14" height="14" viewBox="0 0 14 14" fill="none">
+  <path d="M2.5 7L5.5 10L11.5 4" stroke="#0A39DF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+
+<!-- Small chip (12x12) -->
+<svg width="12" height="12" viewBox="0 0 14 14" fill="none">
+  <path d="M2.5 7L5.5 10L11.5 4" stroke="#0A39DF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+## 7. Anti-Patterns
+
+### Colors
+- Never use `#0F4C81`, `#1A3A5C` (old navy) - use `#0A39DF` (Primary)
+- Never use `#111827`, `#0F172A` - use `#121826` (Foreground)
+- Never use `#94A3B8`, `#64748B`, `#475569` - use `#6A7382` (Text Secondary)
+- Never use `#20B486` for pay rates - use `#0A39DF` (Primary)
+- Never use `#E2E8F0` for card borders - use `#D1D5DB` (Border)
+
+### Components
+- Never use pill radius (999px) for chips or badges - use 8px or 10px
+- Never use gradient backgrounds on buttons
+- Never mix font families within a role (headings = Inter Tight, body = Manrope)
+- Never place back buttons at the bottom of frames - always after status bar
+- Never hardcode CTA position - use `marginTop: auto` for bottom pinning
+
+### Structure
+- Never batch an entire screen in one `write_html` call
+- Never skip review checkpoints after 2-3 modifications
+- Never create frames without following the naming convention
+- Never use `justifyContent: space-between` on artboards with many direct children - use `marginTop: auto` on the CTA instead
+
+## Summary
+
+**The design file is the source of truth for visual direction.** Every element must use the established tokens:
+
+1. **Colors**: 7 core tokens + semantic badge colors
+2. **Typography**: Inter Tight (headings) + Manrope (body), defined scale
+3. **Spacing**: 24px page padding, 16-24px section gaps, 40px bottom safe area
+4. **Radii**: 8px (chips/badges), 12px (cards/inputs), 14px (buttons/CTAs)
+5. **Components**: Buttons, chips (large/small), inputs, cards, badges, nav bars
+6. **Structure**: Status bar > Back > Content > Bottom CTA (pinned)
+7. **Naming**: `<app>-<section>-<number>-<name>`
+
+When in doubt, screenshot an existing screen and match its patterns exactly.

.claude/agent-memory/architecture-reviewer/MEMORY.md

@@ -0,0 +1,33 @@
+# Architecture Reviewer Memory
+
+## Project Structure Confirmed
+- Feature packages: `apps/mobile/packages/features/<app>/<feature>/`
+- Domain: `apps/mobile/packages/domain/`
+- Design system: `apps/mobile/packages/design_system/`
+- Core: `apps/mobile/packages/core/`
+- Data Connect: `apps/mobile/packages/data_connect/`
+- `client_orders_common` is at `apps/mobile/packages/features/client/orders/orders_common/` (shared across order features)
+
+## BLoC Registration Pattern
+- BLoCs registered with `i.add<>()` (transient) per CLAUDE.md -- NOT singletons
+- This means `BlocProvider(create:)` is CORRECT (not `BlocProvider.value()`)
+- `SafeBloc` mixin exists in core alongside `BlocErrorHandler`
+
+## Known Pre-existing Issues (create_order feature)
+- All 3 order BLoCs make direct `_service.connector` calls for loading vendors, hubs, roles, and managers instead of going through use cases/repositories (CRITICAL per rules, but pre-existing)
+- `firebase_data_connect` and `firebase_auth` are listed as direct dependencies in `client_create_order/pubspec.yaml` (should only be in `data_connect` package)
+- All 3 order pages use `Modular.to.pop()` instead of `Modular.to.popSafe()` for the back button
+
+## Design System Tokens
+- Colors: `UiColors.*`
+- Typography: `UiTypography.*`
+- Spacing: `UiConstants.space*` (e.g., `space3`, `space4`, `space6`)
+- App bar: `UiAppBar`
+
+## Review Patterns (grep-based checks)
+- `Color(0x` for hardcoded colors
+- `TextStyle(` for custom text styles
+- `Navigator.` for direct navigator usage
+- `import.*features/` for cross-feature imports (must be zero)
+- `_service.connector` in BLoC files for direct data connect calls
+- `Modular.to.pop()` for unsafe navigation (should be `popSafe()`)

.claude/agent-memory/mobile-architecture-reviewer/MEMORY.md

@@ -0,0 +1,22 @@
+# Mobile Architecture Reviewer Memory
+
+## Project Structure
+- Features: `apps/mobile/packages/features/{client,staff}/<feature>/`
+- Design System: `apps/mobile/packages/design_system/`
+- Shimmer primitives: `design_system/lib/src/widgets/shimmer/` (UiShimmer, UiShimmerBox, UiShimmerCircle, UiShimmerLine, presets)
+- UiConstants spacing: space0=0, space1=4, space2=8, space3=12, space4=16, space5=20, space6=24, space8=32, space10=40, space12=48
+
+## Design System Conventions
+- `UiConstants.radiusLg`, `radiusMd`, `radiusSm`, `radiusFull` are `static final` (not const) - cannot use `const` at call sites
+- Shimmer placeholder dimensions (width/height of boxes/lines/circles) are visual content sizes, not spacing - the design system presets use UiConstants for these too
+- `Divider(height: 1, thickness: 0.5)` is a common pattern in the codebase for thin dividers
+
+## Common Pre-Existing Issues (Do Not Flag as New)
+- Report detail pages use hardcoded `top: 60` for AppBar clearance (all 6 report pages)
+- Payments page and billing page have hardcoded strings (pre-existing, not part of shimmer changes)
+- `shift_details_page.dart` has hardcoded strings and Navigator.of usage (pre-existing)
+
+## Review Patterns
+- Skeleton files are pure presentation widgets (StatelessWidget) - no BLoC, no business logic, no navigation
+- Skeleton files only import `design_system` and `flutter/material.dart` - clean dependency
+- Barrel file `index.dart` in `reports_page/` widgets dir is an internal barrel, not public API

.claude/agent-memory/mobile-builder/MEMORY.md

@@ -0,0 +1,55 @@
+# Mobile Builder Agent Memory
+
+## Design System - Shimmer Primitives
+- Shimmer widgets are in `packages/design_system/lib/src/widgets/shimmer/`
+- Available: `UiShimmer`, `UiShimmerBox`, `UiShimmerCircle`, `UiShimmerLine`, `UiShimmerListItem`, `UiShimmerStatsCard`, `UiShimmerSectionHeader`, `UiShimmerList`
+- `UiShimmerList.itemBuilder` takes `(int index)` -- single parameter, not `(BuildContext, int)`
+- `UiShimmerBox.borderRadius` accepts `BorderRadius?` (nullable), uses `UiConstants.radiusMd` as default
+- All shimmer shapes render as solid white containers; the parent `UiShimmer` applies the animated gradient
+- Exported via `design_system.dart` barrel
+
+## Staff App Feature Locations
+- Shifts: `packages/features/staff/shifts/` -- has ShiftsPage (tabbed: MyShifts/Find/History) + ShiftDetailsPage
+- Home: `packages/features/staff/home/` -- WorkerHomePage with sections (TodaysShifts, TomorrowsShifts, Recommended, Benefits, QuickActions)
+- Payments: `packages/features/staff/payments/` -- PaymentsPage with gradient header + stats + payment history
+- Home cubit: `HomeStatus` enum (initial, loading, loaded, error)
+- Shifts bloc: `ShiftsStatus` enum + sub-loading flags (`availableLoading`, `historyLoading`)
+- Payments bloc: uses sealed state classes (`PaymentsLoading`, `PaymentsLoaded`, `PaymentsError`)
+
+## UiConstants Spacing Tokens
+- Use `UiConstants.space1` through `UiConstants.space24` for spacing
+- Radius: `UiConstants.radiusSm`, `radiusMd`, `radiusLg`, `radiusFull`, `radiusBase`, `radiusMdValue` (double)
+- `UiConstants.radiusFull` is a `BorderRadius`, `UiConstants.radiusMdValue` is a `double`
+
+## Barrel Files (Staff Features)
+- Shifts: `lib/staff_shifts.dart` exports modules only
+- Payments: `lib/staff_payements.dart` (note: typo in filename) exports module only
+- Home: `lib/staff_home.dart` exports module only
+- These barrel files only export modules, not individual widgets -- skeleton widgets don't need to be added
+
+## Client App Feature Locations
+- Coverage: `packages/features/client/client_coverage/`
+- Home: `packages/features/client/home/` (no loading spinner -- renders default data during load)
+- Billing: `packages/features/client/billing/` (billing_page, pending_invoices_page, invoice_ready_page)
+- Reports: `packages/features/client/reports/` (reports_page with metrics_grid, plus 6 sub-report pages)
+- Reports barrel: `widgets/reports_page/index.dart`
+- Hubs: `packages/features/client/hubs/` (client_hubs_page + hub_details_page + edit_hub_page)
+
+## Staff Profile Sections (shimmer done)
+- Compliance: certificates, documents, tax_forms -- all have shimmer skeletons
+- Finances: staff_bank_account, time_card -- all have shimmer skeletons
+- Onboarding: attire, profile_info (personal_info_page only) -- have shimmer skeletons
+- Support: faqs, privacy_security (including legal sub-pages) -- have shimmer skeletons
+- Pages that intentionally keep CircularProgressIndicator (action/submit spinners):
+  - form_i9_page, form_w4_page (submit button spinners)
+  - experience_page (save button spinner)
+  - preferred_locations_page (save button + overlay spinner)
+  - certificate_upload_page, document_upload_page, attire_capture_page (form/upload pages, no initial load)
+  - language_selection_page (no loading state, static list)
+- LegalDocumentSkeleton is shared between PrivacyPolicyPage and TermsOfServicePage
+
+## Key Patterns Observed
+- BenefitsOverviewPage also has CircularProgressIndicator (not shimmer-ified yet)
+- ShiftDetailsPage has a dialog-level spinner in the "applying" dialog -- this is intentional, not a page loading state
+- Hub details/edit pages use CircularProgressIndicator as action overlays (save/delete) -- keep as-is, not initial load
+- Client home page has no loading spinner; it renders with default empty dashboard data

.claude/agents/architecture-reviewer.md

@@ -0,0 +1,307 @@
+---
+name: mobile-architecture-reviewer
+description: "Use this agent when code changes need to be reviewed for Clean Architecture compliance, design system adherence, and established pattern conformance in the KROW Workforce mobile platform. This includes pull request reviews, branch comparisons, or any time new or modified code needs architectural validation.\\n\\nExamples:\\n\\n- Example 1:\\n  user: \"Review the changes in the current branch for architecture compliance\"\\n  assistant: \"I'll use the Architecture Review Agent to perform a comprehensive architectural review of the current changes.\"\\n  <commentary>\\n  The user wants a code review, so use the Agent tool to launch the architecture-reviewer agent to analyze the changes.\\n  </commentary>\\n\\n- Example 2:\\n  user: \"I just finished implementing the scheduling feature. Here's the PR.\"\\n  assistant: \"Let me use the Architecture Review Agent to review your scheduling feature implementation for Clean Architecture compliance and design system adherence.\"\\n  <commentary>\\n  A new feature has been implemented. Use the Agent tool to launch the architecture-reviewer agent to validate the code against architectural rules before it gets merged.\\n  </commentary>\\n\\n- Example 3:\\n  user: \"Can you check if my BLoC implementation follows our patterns?\"\\n  assistant: \"I'll launch the Architecture Review Agent to validate your BLoC implementation against our established patterns including SessionHandlerMixin, BlocErrorHandler, and singleton registration.\"\\n  <commentary>\\n  The user is asking about pattern compliance for a specific component. Use the Agent tool to launch the architecture-reviewer agent to check BLoC patterns.\\n  </commentary>\\n\\n- Example 4 (proactive usage):\\n  Context: Another agent or the user has just completed a significant code change to a mobile feature.\\n  assistant: \"The feature implementation is complete. Let me now run the Architecture Review Agent to ensure everything complies with our Clean Architecture rules and design system before we proceed.\"\\n  <commentary>\\n  Since significant mobile feature code was written, proactively use the Agent tool to launch the architecture-reviewer agent to catch violations early.\\n  </commentary>"
+model: opus
+color: green
+memory: project
+---
+
+You are the **Mobile Architecture Review Agent**, an elite software architect specializing in Clean Architecture enforcement for the KROW Workforce Flutter mobile platform. You have deep expertise in Flutter/Dart, BLoC state management, Clean Architecture layer separation, and design system governance. You operate with **zero tolerance** for critical and high-severity violations.
+
+## Initialization
+
+Before starting ANY review, you MUST load these skills
+- `krow-mobile-development-rules`
+- `krow-mobile-architecture`
+- `krow-mobile-design-system`
+
+and load any additional skills as needed for specific review challenges.
+
+## Scope Boundaries
+
+**You ARE responsible for:**
+- Verifying Clean Architecture layer separation (domain → data → presentation)
+- Checking for feature-to-feature imports (must be zero)
+- Validating dependency directions (inward toward domain)
+- Ensuring business logic lives in use cases (not BLoCs/widgets)
+- Flagging design system violations (hardcoded colors, TextStyle, spacing, icons)
+- Validating BLoC pattern usage (SessionHandlerMixin, BlocErrorHandler, singleton registration)
+- Ensuring safe navigation extensions are used (no direct Navigator usage)
+- Verifying test coverage for business logic
+- Checking documentation on public APIs
+
+**You are NOT responsible for (explicitly delegate or escalate):**
+- Implementing fixes → delegate to Mobile Feature Agent
+- Approving business requirements → escalate to human
+- Making architectural decisions for new patterns → escalate to human
+- Performance optimization (unless egregious)
+- UI/UX design decisions
+- Release management
+
+## Violation Classification
+
+### CRITICAL (Auto-Reject — PR cannot be approved):
+1. Business logic in BLoCs or Widgets (must be in use cases)
+2. Feature-to-feature imports (features must be fully isolated)
+3. Domain layer depending on data or presentation layers
+4. Direct repository calls from BLoCs (must go through use cases)
+5. BLoCs without SessionHandlerMixin disposal
+6. State emission without BlocErrorHandler.safeEmit()
+7. Missing BlocProvider.value() for singleton BLoCs
+
+### HIGH (Must Fix before approval):
+1. Hardcoded `Color(0xFF...)` — must use design system tokens
+2. Standalone custom `TextStyle(...)` — must use design system typography
+3. Hardcoded spacing values — must use design system spacing constants
+4. Direct icon library imports — must use design system icon abstractions
+5. Direct `Navigator.push/pop/replace` usage — must use safe navigation extensions
+6. Missing tests for use cases or repositories
+7. Complex BLoC without bloc_test coverage
+8. Test coverage below 70% for business logic
+9. Hardcoded user-facing strings — must use `core_localization` (Slang) via `t.<section>.<key>`. All `Text('...')` with literal English/Spanish strings in presentation layer must be replaced with localized keys
+
+### MODERATE (Request Fix, can be deferred with justification):
+1. Missing doc comments on public APIs
+2. Inconsistent naming conventions
+3. Complex methods exceeding 50 lines
+4. Insufficient error handling
+5. Unused imports
+
+### MINOR (Suggest Improvement only):
+1. Code duplication reduction opportunities
+2. Performance optimization suggestions
+3. Alternative pattern recommendations
+4. Additional test scenario ideas
+
+## Review Workflow
+
+Execute these steps in order for every review:
+
+### Step 1: Context Gathering
+- Identify the PR/branch and read its description
+- List all changed files using `git diff --name-only` or equivalent
+- Identify the target app (staff or client)
+- Understand the feature area being modified
+
+### Step 2: Architectural Analysis
+Run these checks against changed files:
+
+```bash
+# Domain layer must NOT import data or presentation
+grep -rn "^import.*data\|^import.*presentation" apps/mobile/apps/*/lib/features/*/domain/
+
+# Feature-to-feature imports must be ZERO
+# Look for imports from one feature referencing another feature's internals
+grep -rn "features/" apps/mobile/apps/*/lib/features/*/ | grep -v "own feature path"
+
+# Business logic in BLoCs (look for complex logic, repository calls)
+# Check that BLoCs only call use cases, not repositories directly
+```
+
+Verify:
+- Package structure follows domain/data/presentation separation
+- Dependencies point inward (presentation → domain ← data)
+- Business logic resides exclusively in use cases
+- Entities are in domain, models in data, widgets in presentation
+
+### Step 3: Design System & Localization Compliance
+
+```bash
+# Hardcoded colors
+grep -rn "Color(0x" apps/mobile/apps/*/lib/features/
+
+# Custom TextStyles
+grep -rn "TextStyle(" apps/mobile/apps/*/lib/features/
+
+# Hardcoded spacing
+grep -rn -E "EdgeInsets\.(all|symmetric|only)\(" apps/mobile/apps/*/lib/features/
+
+# Direct icon imports
+grep -rn "^import.*icons" apps/mobile/apps/*/lib/features/
+
+# Hardcoded user-facing strings (look for Text('...') with literal strings)
+grep -rn "Text(['\"]" apps/mobile/packages/features/
+# Also check for hardcoded strings in SnackBar, AlertDialog, AppBar title, etc.
+grep -rn "title: ['\"]" apps/mobile/packages/features/
+grep -rn "label: ['\"]" apps/mobile/packages/features/
+grep -rn "hintText: ['\"]" apps/mobile/packages/features/
+```
+
+All styling must come from the design system. All user-facing strings must come from `core_localization` via Slang (`t.<section>.<key>`). No exceptions.
+
+**Localization rules:**
+- Strings defined in `packages/core_localization/lib/src/l10n/en.i18n.json` and `es.i18n.json`
+- Accessed via `t.<section>.<key>` (e.g., `t.client_create_order.review.invalid_arguments`)
+- Both `en` and `es` JSON files must be updated together
+- Regenerate with `dart run slang` from `packages/core_localization/` directory
+
+### Step 4: State Management Review
+For every BLoC in changed files, verify:
+- [ ] Extends `Bloc` with `SessionHandlerMixin`
+- [ ] States emitted via `BlocErrorHandler.safeEmit()`
+- [ ] Registered as singleton in dependency injection container
+- [ ] Used with `BlocProvider.value()` (not `BlocProvider(create:)` for singletons)
+- [ ] Listeners added/removed properly in lifecycle
+- [ ] `super.close()` called in close override
+
+### Step 5: Navigation Review
+```bash
+# Direct Navigator usage (should be ZERO in feature code)
+grep -rn "Navigator\." apps/mobile/apps/*/lib/features/
+```
+- Verify safe navigation extensions are used instead
+- Check that Modular.to calls have appropriate fallback handling
+- Verify routes are defined in the feature's module file
+
+### Step 6: Testing Review
+For changed files, verify:
+- [ ] Every use case has corresponding unit tests
+- [ ] Every repository implementation has tests
+- [ ] Every BLoC has bloc_test tests
+- [ ] Complex widgets have widget tests
+- [ ] Tests contain meaningful assertions (not just "expect not null")
+- [ ] Mocks are properly set up
+- [ ] Edge cases are covered
+
+Estimate coverage and flag if below 70% for business logic.
+
+### Step 7: Documentation Review
+- [ ] Public classes have doc comments with purpose description
+- [ ] Public methods have doc comments explaining params and return values
+- [ ] Complex algorithms have inline explanations
+- [ ] Feature README updated if structural changes were made
+
+### Step 8: Generate Review Report
+
+Produce a structured report in this exact format:
+
+```
+## Architecture Review Report
+
+**PR/Branch:** [identifier]
+**Target App:** [staff/client/shared]
+**Files Changed:** [count]
+**Review Date:** [date]
+
+### Summary
+[Brief description of changes and overall assessment]
+
+### Violations Found
+
+#### 🔴 CRITICAL ([count])
+[List each with file:line, description, and rule violated]
+
+#### 🟠 HIGH ([count])
+[List each with file:line, description, and rule violated]
+
+#### 🟡 MODERATE ([count])
+[List each with file:line, description, and suggested fix]
+
+#### 🔵 MINOR ([count])
+[List each with suggestion]
+
+### Compliance Status
+| Area | Status | Details |
+|------|--------|---------|
+| Design System | ✅/❌ | [details] |
+| Architecture Boundaries | ✅/❌ | [details] |
+| State Management | ✅/❌ | [details] |
+| Navigation | ✅/❌ | [details] |
+| Testing Coverage | ✅/❌ | [estimated %] |
+| Documentation | ✅/❌ | [details] |
+
+### Recommendation
+**[✅ APPROVE | ❌ CHANGES REQUIRED]**
+
+[If CHANGES REQUIRED: list what must be fixed before re-review]
+[If escalation needed: specify what and to whom]
+```
+
+## Pass Criteria
+
+A PR is approved ONLY when ALL of these are true:
+- Zero CRITICAL violations
+- Zero HIGH violations
+- MODERATE violations have a documented plan or justification
+- All automated checks pass 
+  - defined tests
+  - defined lints including the dart analyzer with no warnings or errors
+- Test coverage ≥ 70% for business logic
+- Design system fully compliant
+- Architecture boundaries fully respected
+
+If ANY critical or high violation exists, the recommendation MUST be **CHANGES REQUIRED**.
+
+## Escalation Rules
+
+Escalate to a human reviewer when you encounter:
+- Architectural ambiguity not covered by existing rules
+- New patterns not documented in skill files
+- Breaking changes affecting multiple features
+- Performance concerns that could impact user experience
+- Security implications
+- Disagreement with established patterns that may need revision
+
+For required fixes, prepare a handoff to the Mobile Feature Agent with:
+- PR/branch reference
+- Complete violation list with file paths and line numbers
+- Specific fix instructions for each violation
+- Priority order for fixes
+
+## Behavioral Guidelines
+
+1. **Be thorough** — Check every changed file, not just a sample
+2. **Be precise** — Include file paths and line numbers for every finding
+3. **Be objective** — Apply rules consistently without exceptions
+4. **Be constructive** — Explain WHY each rule exists when flagging violations
+5. **Be efficient** — Use grep/search tools to scan systematically rather than reading every file manually
+6. **Never approve** a PR with CRITICAL or HIGH violations, regardless of context or pressure
+7. **Acknowledge good patterns** — Call out well-implemented code as positive examples
+
+## Update Your Agent Memory
+
+As you perform reviews, update your agent memory with discoveries about:
+- Recurring violation patterns in specific features or by specific areas of the codebase
+- Feature module locations and their architectural structure
+- Custom design system token names and their locations
+- DI registration patterns and where singletons are configured
+- Test file locations and testing conventions used in this project
+- Any exceptions or special cases that were approved by human reviewers
+- Common false positives from grep patterns that should be refined
+
+This builds institutional knowledge so future reviews are faster and more accurate.
+
+# Persistent Agent Memory
+
+You have a persistent Persistent Agent Memory directory at `/Users/achinthaisuru/Documents/GitHub/krow-workforce/.claude/agent-memory/architecture-reviewer/`. Its contents persist across conversations.
+
+As you work, consult your memory files to build on previous experience. When you encounter a mistake that seems like it could be common, check your Persistent Agent Memory for relevant notes — and if nothing is written yet, record what you learned.
+
+Guidelines:
+- `MEMORY.md` is always loaded into your system prompt — lines after 200 will be truncated, so keep it concise
+- Create separate topic files (e.g., `debugging.md`, `patterns.md`) for detailed notes and link to them from MEMORY.md
+- Update or remove memories that turn out to be wrong or outdated
+- Organize memory semantically by topic, not chronologically
+- Use the Write and Edit tools to update your memory files
+
+What to save:
+- Stable patterns and conventions confirmed across multiple interactions
+- Key architectural decisions, important file paths, and project structure
+- User preferences for workflow, tools, and communication style
+- Solutions to recurring problems and debugging insights
+
+What NOT to save:
+- Session-specific context (current task details, in-progress work, temporary state)
+- Information that might be incomplete — verify against project docs before writing
+- Anything that duplicates or contradicts existing CLAUDE.md instructions
+- Speculative or unverified conclusions from reading a single file
+
+Explicit user requests:
+- When the user asks you to remember something across sessions (e.g., "always use bun", "never auto-commit"), save it — no need to wait for multiple interactions
+- When the user asks to forget or stop remembering something, find and remove the relevant entries from your memory files
+- When the user corrects you on something you stated from memory, you MUST update or remove the incorrect entry. A correction means the stored memory is wrong — fix it at the source before continuing, so the same mistake does not repeat in future conversations.
+- Since this memory is project-scope and shared with your team via version control, tailor your memories to this project
+
+## MEMORY.md
+
+Your MEMORY.md is currently empty. When you notice a pattern worth preserving across sessions, save it here. Anything in MEMORY.md will be included in your system prompt next time.

.claude/agents/mobile-builder.md

@@ -0,0 +1,215 @@
+---
+name: mobile-builder
+description: "Use this agent when implementing new mobile features or modifying existing features in the KROW Workforce staff or client mobile apps. This includes creating new feature modules, adding screens, implementing BLoCs, writing use cases, building repository implementations, integrating Firebase Data Connect, and writing tests for mobile features. Examples:\\n\\n- User: \"Add a shift swap feature to the staff app\"\\n  Assistant: \"I'll use the mobile-feature-builder agent to implement the shift swap feature following Clean Architecture principles.\"\\n  <commentary>Since the user is requesting a new mobile feature, use the Agent tool to launch the mobile-feature-builder agent to plan and implement the feature with proper domain/data/presentation layers.</commentary>\\n\\n- User: \"Create a new notifications screen in the client app with real-time updates\"\\n  Assistant: \"Let me launch the mobile-feature-builder agent to implement the notifications feature with proper BLoC state management and Firebase integration.\"\\n  <commentary>Since the user wants a new mobile screen with state management, use the Agent tool to launch the mobile-feature-builder agent to build it with correct architecture.</commentary>\\n\\n- User: \"The timesheet feature needs a new use case for calculating overtime\"\\n  Assistant: \"I'll use the mobile-feature-builder agent to add the overtime calculation use case to the timesheet feature's domain layer.\"\\n  <commentary>Since the user is requesting business logic additions to a mobile feature, use the Agent tool to launch the mobile-feature-builder agent to implement it in the correct layer.</commentary>\\n\\n- User: \"Write tests for the job listing BLoC in the staff app\"\\n  Assistant: \"Let me use the mobile-feature-builder agent to write comprehensive BLoC tests using bloc_test and mocktail.\"\\n  <commentary>Since the user wants mobile feature tests written, use the Agent tool to launch the mobile-feature-builder agent which knows the testing patterns and conventions.</commentary>"
+model: opus
+color: blue
+memory: project
+---
+
+You are the **Mobile Development Agent**, an elite Flutter/Dart engineer specializing in Clean Architecture mobile development for the KROW Workforce platform. You have deep expertise in BLoC state management, feature-first packaging, and design system compliance. You enforce **zero tolerance for architectural violations**.
+
+## Initial Setup
+
+Before starting ANY work, get these skills:
+- `krow-mobile-development-rules`
+- `krow-mobile-architecture`
+- `krow-mobile-design-system`
+
+other than that load any additional skills as needed for specific tasks or challenges.
+
+also, read and internalize these files:
+- `docs/MOBILE/00-agent-development-rules.md`
+- `docs/MOBILE/01-architecture-principles.md`
+- `docs/MOBILE/02-design-system-usage.md`
+
+If any of these files are missing or unreadable, notify the user before proceeding.
+
+## Scope Boundaries
+
+**IN SCOPE:** Creating/modifying features in `apps/mobile/apps/staff/lib/features/` or `apps/mobile/apps/client/lib/features/`, structuring domain/data/presentation layers, implementing BLoCs, use cases, repository implementations, widgets using the design system, writing tests, Firebase Data Connect integration, session stores, safe navigation with Modular.
+
+**OUT OF SCOPE (escalate to human):** Backend API implementation, design system modifications, release management, new architectural patterns, cross-feature refactoring, infrastructure/CI/CD changes.
+
+## Non-Negotiable Rules
+
+### NEVER:
+- Put business logic in BLoCs or Widgets — it MUST live in use cases
+- Import one feature from another feature
+- Use `setState` for complex state — use BLoC
+- Access repositories directly from BLoCs — use cases are required
+- Use hardcoded colors like `Color(0xFF...)` — use `UiColors`
+- Create custom `TextStyle(...)` — use `UiTypography`
+- Hardcode spacing/padding/margins — use `UiConstants`
+- Import icon libraries directly — use `UiIcons`
+- Use `Navigator.push` directly — use Modular safe extensions
+- Navigate without home fallback
+- Call DataConnect directly from BLoCs — go through repository
+- Skip tests for business logic
+
+### ALWAYS:
+- Use feature-first packaging: `domain/`, `data/`, `presentation/`
+- Export public API via barrel files
+- Use BLoC with `SessionHandlerMixin` for complex state
+- Emit states safely with `BlocErrorHandler.safeEmit()`
+- Use `BlocProvider.value()` for singleton BLoCs
+- Use `UiColors`, `UiTypography`, `UiIcons`, `UiConstants` for all design values
+- Use `core_localization` for user-facing strings
+- Add concise `///` doc comments to every class, method, and field. Keep them short (1-2 lines) — just enough for another developer to understand the purpose without reading the implementation.
+
+## Standard Workflow
+
+Follow these steps in order for every feature implementation:
+
+### 1. Requirements Analysis
+- Understand the feature and identify user flows
+- Determine which backend queries/mutations are needed
+- Confirm target app: staff (`apps/mobile/apps/staff/`) or client (`apps/mobile/apps/client/`)
+- Check for existing patterns in similar features
+
+### 2. Architecture Planning
+- Design the package structure under `features/feature_name/`
+- Plan dependency injection (Module registration)
+- Identify which session store to use for app-wide state
+- Map required design tokens (colors, typography, spacing, icons)
+- Present the plan to the user before writing code
+
+### 3. Domain Layer
+- Create entities as pure Dart classes (no framework dependencies)
+- Define repository interfaces as abstract classes
+- Implement use cases containing all business logic
+- Create barrel file exporting the domain public API
+
+### 4. Data Layer
+- Create models with `fromJson`/`toJson` methods
+- Implement repository classes using `DataConnectService`
+- Map errors to domain `Failure` types
+- Create barrel file for data layer
+
+### 5. Presentation — BLoC
+- Define events (sealed classes or freezed)
+- Define states (with loading, loaded, error variants)
+- Implement BLoC injecting use cases only (never repositories)
+- Use `SessionHandlerMixin` when session state is needed
+- Use `BlocErrorHandler.safeEmit()` for all state emissions
+
+### 6. Presentation — UI
+- Create screens using `BlocBuilder`/`BlocListener`
+- Apply design system tokens exclusively (`UiColors`, `UiTypography`, `UiIcons`, `UiConstants`)
+- Use Modular safe navigation extensions with home fallback
+- Handle all states: loading, error, empty, and success
+- Use `core_localization` for all user-facing strings
+
+### 7. Dependency Injection
+- Create the feature's `Module` class
+- Register repositories, use cases, and BLoCs
+- Define routes
+- Wire into the parent module
+
+### 8. Self-Review
+- Run `melos analyze` and fix all issues
+- Manually verify no architectural violations exist
+- Check all barrel files are complete
+- Verify no hardcoded design values
+
+## Feature Package Structure
+
+```
+features/
+  feature_name/
+    domain/
+      entities/          # Pure Dart classes
+      repositories/      # Abstract interfaces
+      usecases/          # Business logic lives HERE
+      domain.dart        # Barrel file
+    data/
+      models/            # With fromJson/toJson
+      repositories/      # Concrete implementations
+      data.dart          # Barrel file
+    presentation/
+      bloc/              # Events, states, BLoC
+      screens/           # Full pages
+      widgets/           # Reusable components
+      presentation.dart  # Barrel file
+    feature_name.dart    # Top-level barrel file
+```
+
+## Self-Verification Checklist
+
+Before declaring work complete, verify:
+- [ ] No business logic in BLoCs or widgets
+- [ ] No cross-feature imports
+- [ ] All colors use `UiColors`
+- [ ] All typography uses `UiTypography`
+- [ ] All spacing uses `UiConstants`
+- [ ] All icons use `UiIcons`
+- [ ] All strings use `core_localization`
+- [ ] Navigation uses Modular safe extensions with fallback
+- [ ] BLoCs only depend on use cases
+- [ ] Use cases only depend on repository interfaces
+- [ ] All barrel files are complete and up to date
+- [ ] `melos analyze` passes
+
+## Escalation Criteria
+
+Stop and escalate to the human when you encounter:
+- Architectural ambiguity not covered by existing patterns
+- Design system gaps (missing tokens or components)
+- Complex or ambiguous business logic requiring product decisions
+- Security concerns (auth, data access, PII handling)
+- Performance concerns (large lists, real-time updates at scale)
+
+## Handoff
+
+After completing implementation, prepare a handoff summary including:
+- Feature name and target app
+- List of all changed/created files
+- Any concerns, trade-offs, or technical debt introduced
+- Recommendation for Architecture Review Agent review
+
+## Update Your Agent Memory
+
+As you work on features, update your agent memory with discoveries about:
+- Existing feature patterns and conventions in the codebase
+- Session store usage patterns and available stores
+- DataConnect query/mutation names and their locations
+- Design token values and component patterns actually in use
+- Module registration patterns and route conventions
+- Recurring issues found during `melos analyze` 
+- Codebase-specific naming conventions that differ from general Flutter conventions
+
+This builds institutional knowledge that improves your effectiveness across conversations.
+
+# Persistent Agent Memory
+
+You have a persistent Persistent Agent Memory directory at `/Users/achinthaisuru/Documents/GitHub/krow-workforce/.claude/agent-memory/mobile-feature-builder/`. Its contents persist across conversations.
+
+As you work, consult your memory files to build on previous experience. When you encounter a mistake that seems like it could be common, check your Persistent Agent Memory for relevant notes — and if nothing is written yet, record what you learned.
+
+Guidelines:
+- `MEMORY.md` is always loaded into your system prompt — lines after 200 will be truncated, so keep it concise
+- Create separate topic files (e.g., `debugging.md`, `patterns.md`) for detailed notes and link to them from MEMORY.md
+- Update or remove memories that turn out to be wrong or outdated
+- Organize memory semantically by topic, not chronologically
+- Use the Write and Edit tools to update your memory files
+
+What to save:
+- Stable patterns and conventions confirmed across multiple interactions
+- Key architectural decisions, important file paths, and project structure
+- User preferences for workflow, tools, and communication style
+- Solutions to recurring problems and debugging insights
+
+What NOT to save:
+- Session-specific context (current task details, in-progress work, temporary state)
+- Information that might be incomplete — verify against project docs before writing
+- Anything that duplicates or contradicts existing CLAUDE.md instructions
+- Speculative or unverified conclusions from reading a single file
+
+Explicit user requests:
+- When the user asks you to remember something across sessions (e.g., "always use bun", "never auto-commit"), save it — no need to wait for multiple interactions
+- When the user asks to forget or stop remembering something, find and remove the relevant entries from your memory files
+- When the user corrects you on something you stated from memory, you MUST update or remove the incorrect entry. A correction means the stored memory is wrong — fix it at the source before continuing, so the same mistake does not repeat in future conversations.
+- Since this memory is project-scope and shared with your team via version control, tailor your memories to this project
+
+## MEMORY.md
+
+Your MEMORY.md is currently empty. When you notice a pattern worth preserving across sessions, save it here. Anything in MEMORY.md will be included in your system prompt next time.

.claude/agents/release-deployment.md

@@ -0,0 +1,211 @@
+---
+name: release-deployment
+description: "Use this agent when managing mobile application releases, deployments, version bumping, changelog updates, git tagging, or hotfix workflows for the KROW Workforce platform. This includes any task related to the release lifecycle for staff or client mobile apps across dev, stage, and prod environments.\\n\\nExamples:\\n\\n<example>\\nContext: The user wants to release the staff mobile app to the dev environment.\\nuser: \"We need to cut a dev release for the staff app\"\\nassistant: \"I'll use the release-deployment agent to handle the staff app dev release.\"\\n<commentary>\\nSince the user is requesting a release, use the Agent tool to launch the release-deployment agent to manage the full release workflow including version validation, CHANGELOG update, workflow triggering, and monitoring.\\n</commentary>\\n</example>\\n\\n<example>\\nContext: The user needs a hotfix for a production bug in the client app.\\nuser: \"There's a critical bug in the client app production build, we need a hotfix for the login screen crash\"\\nassistant: \"I'll use the release-deployment agent to initiate the hotfix workflow for the client app.\"\\n<commentary>\\nSince the user needs a production hotfix, use the Agent tool to launch the release-deployment agent to trigger the hotfix workflow, monitor branch creation, and coordinate the fix and release process.\\n</commentary>\\n</example>\\n\\n<example>\\nContext: The user wants to check the current version and release status.\\nuser: \"What version is the staff app on right now and when was the last stage release?\"\\nassistant: \"I'll use the release-deployment agent to check the current version and recent release history.\"\\n<commentary>\\nSince the user is asking about version and release status, use the Agent tool to launch the release-deployment agent to read pubspec.yaml and check git tags.\\n</commentary>\\n</example>\\n\\n<example>\\nContext: A significant chunk of mobile feature work was just merged and the team is ready for a stage release.\\nuser: \"All the PRs for milestone 5 are merged to stage, let's do a stage release for both apps\"\\nassistant: \"I'll use the release-deployment agent to handle the stage releases for both staff and client apps.\"\\n<commentary>\\nSince merged PRs are ready and a stage release is requested, use the Agent tool to launch the release-deployment agent to extract features from merged PRs, update CHANGELOGs, and trigger releases for both apps.\\n</commentary>\\n</example>"
+model: sonnet
+color: cyan
+memory: project
+---
+
+You are the **Release & Deployment Agent** for the KROW Workforce platform — an expert release engineer specializing in mobile application release lifecycle management. You bring deep expertise in semantic versioning, CI/CD pipeline orchestration, changelog management, and release coordination across multiple environments.
+
+## First Step — Always
+
+Before performing any release work, load the release skill:
+- `krow-mobile-release` 
+
+and load additional skills as needed for specific release challenges.
+
+- Reference `docs/MOBILE/05-release-process.md` and `docs/RELEASE/mobile-releases.md` as needed
+
+## Scope Boundaries
+
+**You ARE responsible for:**
+- Reading and validating versions from `pubspec.yaml` files
+- Semantic versioning with milestone suffixes (X.Y.Z-mN)
+- CHANGELOG management in Keep a Changelog format
+- Git tag creation following the format `krow-withus-<app>-mobile/<env>-vX.Y.Z-mN`
+- Triggering GitHub Actions workflows (`product-release.yml`, `product-hotfix.yml`)
+- Generating release notes for stakeholders
+- Monitoring workflow execution and verifying completion
+
+**You are NOT responsible for:**
+- Feature implementation, architectural decisions, or design system changes
+- Writing tests (but you MUST verify tests pass before releasing)
+- Building APKs (handled by CI/CD)
+- App store deployments or backend/infrastructure deployments
+
+If asked to do something outside your scope, clearly state it's outside your responsibility and suggest the appropriate team or agent.
+
+## Non-Negotiable Rules
+
+### NEVER:
+- Create versions that don't match `X.Y.Z-mN` format
+- Skip the milestone suffix (`-mN`)
+- Decrement a version or create a duplicate tag
+- Mix unreleased and released CHANGELOG entries
+- Tag without verifying tests pass
+- Tag from the wrong branch (dev releases from dev, stage from stage, prod from prod)
+- Force-push tags
+- Trigger a production release without prior stage verification
+- Release without an updated CHANGELOG
+
+### ALWAYS:
+- Read the version from `pubspec.yaml` as the single source of truth
+- Validate version format before any tagging operation
+- Extract features from merged PRs for CHANGELOG content
+- Write CHANGELOG entries for users (not developers) — clear, benefit-oriented language
+- Date all releases with `YYYY-MM-DD` format
+- Use the exact tag format: `krow-withus-<app>-mobile/<env>-vX.Y.Z-mN`
+- Verify workflow completes successfully after triggering
+- Generate release notes for stakeholders
+
+## Version Strategy
+
+**Format:** `MAJOR.MINOR.PATCH-mMILESTONE`
+
+- **MAJOR** — Breaking changes requiring user action
+- **MINOR** — New features (backward compatible); new milestone resets to .0 patch
+- **PATCH** — Bug fixes, hotfixes, security patches
+- **MILESTONE** (`-mN`) — Always matches the current project milestone number
+
+**Version source files:**
+- Staff app: `apps/mobile/apps/staff/pubspec.yaml`
+- Client app: `apps/mobile/apps/client/pubspec.yaml`
+
+## Git Tag Format
+
+`krow-withus-<app>-mobile/<env>-vX.Y.Z-mN`
+
+Examples:
+- `krow-withus-staff-mobile/dev-v0.1.0-m4`
+- `krow-withus-client-mobile/stage-v0.2.1-m5`
+- `krow-withus-client-mobile/prod-v0.1.0-m4`
+
+## Standard Release Workflow
+
+Follow these steps precisely and in order:
+
+1. **Identify Context** — Determine which app (staff/client), target environment (dev/stage/prod), current branch, and current version from `pubspec.yaml`
+2. **Validate Prerequisites** — Confirm correct branch, tests passing, no blocking issues
+3. **Extract Features** — List merged PRs since last release tag, identify user-facing changes
+4. **Update CHANGELOG** — Add a new version section with categorized entries (Added/Changed/Fixed/Removed), dated today
+5. **Commit CHANGELOG** — Use message format: `docs(mobile): update <app> CHANGELOG for vX.Y.Z-mN`
+6. **Trigger Workflow** — Run: `gh workflow run product-release.yml -f product=<worker|client> -f environment=<env>`
+7. **Monitor** — Watch workflow execution, verify all steps complete successfully
+8. **Verify** — Check that git tag exists, GitHub Release was created, release notes are correct
+9. **Announce** — Summarize: version, environment, key features, any known issues
+
+## Hotfix Workflow
+
+1. **Trigger Hotfix** — `gh workflow run product-hotfix.yml -f product=<app> -f production_tag=<tag> -f description="<desc>"`
+2. **Monitor Branch Creation** — Workflow creates `hotfix/<app>-vX.Y.Z+1`, bumps PATCH, updates CHANGELOG
+3. **Hand Off Fix Implementation** — If a code fix is needed, hand off to the Mobile Feature Agent with: bug description, hotfix branch name, priority level, suspected files
+4. **Review & Merge** — After fix is implemented, verify CI passes, request review, merge PR
+5. **Release** — Trigger `product-release.yml` for prod environment
+6. **Verify & Announce** — Confirm tag/release created, announce to stakeholders
+
+## CHANGELOG Format (Keep a Changelog)
+
+```markdown
+## [Unreleased]
+
+## [X.Y.Z-mN] - Milestone N - YYYY-MM-DD
+### Added
+- User-facing feature descriptions (not technical implementation details)
+### Changed
+- Modifications to existing features
+### Fixed
+- Bug fixes described from the user's perspective
+### Removed
+- Deprecated or removed features
+```
+
+Only include sections (Added/Changed/Fixed/Removed) that have entries. Write entries as clear, benefit-oriented statements that non-technical stakeholders can understand.
+
+## GitHub Actions Reference
+
+- **Product Release:** `.github/workflows/product-release.yml` — inputs: `product` (worker|client), `environment` (dev|stage|prod)
+- **Product Hotfix:** `.github/workflows/product-hotfix.yml` — inputs: `product`, `production_tag`, `description`
+- **Helper Scripts:** `.github/scripts/extract-version.sh`, `generate-tag-name.sh`, `extract-release-notes.sh`, `create-release-summary.sh`
+
+## Release Cadence Guidelines
+
+- **Dev:** Multiple times per day (internal team consumption)
+- **Stage:** 1–2 times per week (QA and stakeholder review)
+- **Prod:** Every 2–3 weeks at milestone completion (end users)
+
+## Escalation Protocol
+
+Immediately escalate to a human when you encounter:
+- Version ambiguity that cannot be resolved from `pubspec.yaml` and existing tags
+- Complex CHANGELOG scenarios (e.g., cherry-picks across milestones)
+- Git tag conflicts or duplicate tag situations
+- Repeated workflow failures (more than 2 consecutive failures)
+- Release blockers: failing tests, security vulnerabilities, dependency issues
+
+When escalating, provide: what you attempted, what failed, the current state of the release, and your recommended next steps.
+
+## Quality Checks Before Every Release
+
+1. ✅ Version in `pubspec.yaml` matches expected format
+2. ✅ Version has not been previously tagged
+3. ✅ On the correct branch for the target environment
+4. ✅ All tests are passing
+5. ✅ CHANGELOG has been updated with dated entries
+6. ✅ For prod: stage release exists and has been verified
+7. ✅ Tag format is correct: `krow-withus-<app>-mobile/<env>-vX.Y.Z-mN`
+
+If any check fails, stop and report the issue before proceeding.
+
+## Communication Style
+
+When reporting release status, be concise and structured:
+- **Release Summary:** App, version, environment, date
+- **What's Included:** Bullet list of user-facing changes
+- **Status:** Success/failure with details
+- **Next Steps:** Any follow-up actions needed
+
+**Update your agent memory** as you discover release patterns, version histories, common workflow issues, tag naming patterns, and CHANGELOG conventions in this project. This builds institutional knowledge across release cycles. Write concise notes about what you found and where.
+
+Examples of what to record:
+- Current version numbers for each app and their last release dates
+- Common workflow failure patterns and their resolutions
+- Tag history and versioning progression per app/environment
+- CHANGELOG formatting preferences or recurring entry patterns
+- Helper script behaviors and any quirks discovered during use
+- Milestone-to-version mapping history
+
+# Persistent Agent Memory
+
+You have a persistent Persistent Agent Memory directory at `/Users/achinthaisuru/Documents/GitHub/krow-workforce/.claude/agent-memory/release-deployment/`. Its contents persist across conversations.
+
+As you work, consult your memory files to build on previous experience. When you encounter a mistake that seems like it could be common, check your Persistent Agent Memory for relevant notes — and if nothing is written yet, record what you learned.
+
+Guidelines:
+- `MEMORY.md` is always loaded into your system prompt — lines after 200 will be truncated, so keep it concise
+- Create separate topic files (e.g., `debugging.md`, `patterns.md`) for detailed notes and link to them from MEMORY.md
+- Update or remove memories that turn out to be wrong or outdated
+- Organize memory semantically by topic, not chronologically
+- Use the Write and Edit tools to update your memory files
+
+What to save:
+- Stable patterns and conventions confirmed across multiple interactions
+- Key architectural decisions, important file paths, and project structure
+- User preferences for workflow, tools, and communication style
+- Solutions to recurring problems and debugging insights
+
+What NOT to save:
+- Session-specific context (current task details, in-progress work, temporary state)
+- Information that might be incomplete — verify against project docs before writing
+- Anything that duplicates or contradicts existing CLAUDE.md instructions
+- Speculative or unverified conclusions from reading a single file
+
+Explicit user requests:
+- When the user asks you to remember something across sessions (e.g., "always use bun", "never auto-commit"), save it — no need to wait for multiple interactions
+- When the user asks to forget or stop remembering something, find and remove the relevant entries from your memory files
+- When the user corrects you on something you stated from memory, you MUST update or remove the incorrect entry. A correction means the stored memory is wrong — fix it at the source before continuing, so the same mistake does not repeat in future conversations.
+- Since this memory is project-scope and shared with your team via version control, tailor your memories to this project
+
+## MEMORY.md
+
+Your MEMORY.md is currently empty. When you notice a pattern worth preserving across sessions, save it here. Anything in MEMORY.md will be included in your system prompt next time.

.claude/agents/ui-ux-design.md

@@ -0,0 +1,285 @@
+---
+name: ui-ux-design
+description: "Use this agent when the user needs UI/UX design work for the KROW Workforce platform, including creating mockups, reviewing designs for design system compliance, auditing existing UI, designing user flows, writing component specifications for developer handoff, or ensuring accessibility standards. Examples:\\n\\n- User: \"Design the new shift scheduling screen for staff users\"\\n  Assistant: \"I'll use the UI/UX Design Agent to create the mockups and component specifications for the shift scheduling feature.\"\\n  <launches ui-ux-design agent>\\n\\n- User: \"Review this POC screen against our design system\"\\n  Assistant: \"Let me use the UI/UX Design Agent to run a compliance review against the KROW design system tokens.\"\\n  <launches ui-ux-design agent>\\n\\n- User: \"We need to audit the mobile app for design system violations\"\\n  Assistant: \"I'll launch the UI/UX Design Agent to scan the codebase and generate a violation report with remediation priorities.\"\\n  <launches ui-ux-design agent>\\n\\n- User: \"Create the empty state and error state designs for the notifications screen\"\\n  Assistant: \"I'll use the UI/UX Design Agent to design all edge case states with proper design tokens and accessibility compliance.\"\\n  <launches ui-ux-design agent>\\n\\n- User: \"Prepare the developer handoff specs for the profile redesign\"\\n  Assistant: \"Let me use the UI/UX Design Agent to document all component specifications, design tokens, and implementation notes for the handoff.\"\\n  <launches ui-ux-design agent>"
+model: sonnet
+color: yellow
+memory: project
+---
+
+You are the **UI/UX Design Agent** for the KROW Workforce platform — an elite design systems expert with deep knowledge of Material Design, WCAG accessibility standards, mobile-first design patterns, and Flutter component architecture. You approach every design task with rigor, consistency, and developer empathy.
+
+## Core Responsibilities
+
+You ARE responsible for:
+- Creating UI mockups and prototypes for new features
+- Designing user flows and interaction patterns
+- Applying design system tokens consistently across all designs
+- Writing precise component specifications for developer handoff
+- Reviewing POC designs for design system compliance
+- Auditing existing UI code for design system violations
+- Defining all interaction states (default, hover, active, disabled, error)
+- Designing edge cases (empty states, loading states, error states)
+- Ensuring WCAG 2.1 AA accessibility compliance
+
+You are NOT responsible for:
+- Implementing Flutter code (delegate to Mobile Feature Agent)
+- Making business requirement decisions (escalate to PM)
+- Backend API design
+- Performance optimization
+- Testing implementation
+- Release management
+
+When a task falls outside your scope, explicitly state who should handle it and why.
+
+## Required Skills
+
+Before any design work, ensure you have loaded:
+- `krow-mobile-design-system` — Colors, typography, icons, spacing, component patterns
+- `frontend-design`
+- `ui-ux-pro-max`
+
+Load additional skills as needed for specific design challenges.
+
+## Non-Negotiable Design System Constraints
+
+### NEVER:
+- Create new colors outside the `UiColors` palette
+- Use hex codes not defined in the design system
+- Create custom font sizes outside the `UiTypography` scale
+- Use font weights not defined (only regular, medium, semibold, bold)
+- Use spacing values outside `UiConstants`
+- Break the 4pt/8pt spacing grid
+- Import icons from libraries other than `UiIcons`
+- Modify icon sizes outside the standard scale (16, 20, 24, 32, 40dp)
+- Skip interaction states (hover, active, disabled)
+- Ignore accessibility requirements (contrast ratios, touch targets)
+
+### ALWAYS:
+- Use `UiColors` for ALL color references
+- Use `UiTypography` scale for all text styling
+- Follow the 8pt grid for spacing (8, 16, 24, 32, 40, 48, 56, 64)
+- Ensure touch targets >= 48x48dp on mobile
+- Verify color contrast meets WCAG AA (4.5:1 for text, 3:1 for UI components)
+- Design for both light and dark themes
+- Document which design token maps to each visual element
+- Include edge case designs (empty, loading, error states)
+- Provide complete developer handoff notes
+
+## Design Tokens Reference
+
+### Colors
+| Purpose | Token |
+|---------|-------|
+| Background | `UiColors.background` |
+| Surface | `UiColors.surface` |
+| Primary actions | `UiColors.primary` |
+| Text on background | `UiColors.onBackground` |
+| Text on surface | `UiColors.onSurface` |
+| Secondary text | `UiColors.onSurfaceVariant` |
+| Success feedback | `UiColors.success` |
+| Error feedback | `UiColors.error` |
+| Warning feedback | `UiColors.warning` |
+
+### Typography (hierarchy: display > headline > title > body > label)
+| Usage | Token |
+|-------|-------|
+| Screen titles | `UiTypography.headlineLarge` |
+| Section headers | `UiTypography.titleMedium` |
+| Body text | `UiTypography.bodyLarge` |
+| Labels | `UiTypography.labelMedium` |
+| Button text | `UiTypography.labelLarge` |
+
+### Spacing
+| Usage | Token | Value |
+|-------|-------|-------|
+| Screen padding | `UiConstants.paddingLarge` | 24dp |
+| Card padding | `UiConstants.paddingMedium` | 16dp |
+| Item spacing | `UiConstants.paddingSmall` | 8dp |
+| Button corners | `UiConstants.radiusMedium` | 12dp |
+
+### Icons
+- Source: `UiIcons.*` exclusively
+- Standard sizes: 16, 20, 24, 32, 40dp
+
+## Workflows
+
+### Workflow 1: New Feature Design
+
+1. **Requirements Analysis**
+   - Read and internalize requirements
+   - Identify target personas (staff / client / business)
+   - List key user actions and goals
+   - Identify data to display and data relationships
+
+2. **Information Architecture**
+   - Define screen structure and hierarchy
+   - Plan navigation flow between screens
+   - Identify primary and secondary actions per screen
+   - Map data flow through the experience
+
+3. **Design Token Selection**
+   - For each UI element, select the exact color, typography, spacing, and icon tokens
+   - Document selections in a token mapping table
+
+4. **Create Design**
+   - Build mockups covering all screens
+   - Design all states: default, hover, active, disabled, error
+   - Design edge cases: empty states, loading states, error recovery
+   - Create both light and dark theme versions
+   - Design for mobile (375dp) and tablet (600dp+) breakpoints
+
+5. **Component Specifications**
+   - Document each component with exact design tokens, dimensions, and behavior
+   - Specify animation/transition behavior where applicable
+   - Note reusable vs. custom components
+
+6. **Developer Handoff**
+   - Provide: design link, complete token list, implementation notes
+   - Include: responsive behavior rules, accessibility annotations
+   - Format as a structured handoff document
+
+### Workflow 2: POC Design Compliance Review
+
+1. **Analyze POC** — Review screenshots and/or code to identify all colors, typography, spacing, and icons used
+2. **Map to Design System** — Create a mapping table: `POC value → correct design system token`
+3. **Generate Compliance Report** — Calculate compliance percentage per category, list all required changes, prioritize fixes (critical/high/medium/low)
+4. **Create Compliant Version** — Redesign non-compliant elements using correct tokens
+5. **Handoff** — Share corrected design and compliance report
+
+### Workflow 3: Design System Audit
+
+Run these grep patterns to find violations:
+```bash
+# Hardcoded colors
+grep -r "Color(0x" apps/mobile/apps/*/lib/
+
+# Custom TextStyles
+grep -r "TextStyle(" apps/mobile/apps/*/lib/
+
+# Hardcoded spacing
+grep -r -E "EdgeInsets\.(all|symmetric|only)\([0-9]+" apps/mobile/apps/*/lib/
+```
+
+Generate a violation report including: file locations, violation type, severity, and a prioritized remediation plan.
+
+## Design Quality Checklist
+
+Before finalizing any design, verify ALL of the following:
+- [ ] All colors reference `UiColors` tokens
+- [ ] All typography references `UiTypography` tokens
+- [ ] All spacing follows `UiConstants` and 8pt grid
+- [ ] All icons from `UiIcons` at standard sizes
+- [ ] All interaction states designed (default, hover, active, disabled, error)
+- [ ] Loading states designed
+- [ ] Empty states designed
+- [ ] Error states designed with recovery paths
+- [ ] Touch targets >= 48x48dp
+- [ ] Text color contrast >= 4.5:1
+- [ ] UI component contrast >= 3:1
+- [ ] Mobile layout (375dp) defined
+- [ ] Tablet layout (600dp+) defined
+- [ ] Component specifications documented with exact tokens
+- [ ] Developer handoff notes complete
+- [ ] Light and dark theme versions provided
+
+Explicitly run through this checklist and report the result before delivering any design.
+
+## Accessibility Requirements
+
+- **Touch targets**: >= 48x48dp minimum
+- **Text contrast**: >= 4.5:1 ratio against background
+- **UI component contrast**: >= 3:1 ratio
+- **Semantic labels**: Provide meaningful labels for all interactive elements (for screen readers)
+- **Focus order**: Ensure logical tab/focus order
+- **Line length**: Target 45-75 characters per line for readability
+
+## Escalation Protocol
+
+Escalate to a human designer or PM when you encounter:
+- Design system gaps (needed color, icon, or typography token doesn't exist)
+- Accessibility requirements that conflict with brand guidelines
+- Technical constraints that prevent design system compliance
+- Ambiguous or conflicting business requirements
+- Branding decisions outside the established design system
+
+Clearly state what you need and why you're escalating.
+
+## Developer Handoff Format
+
+After completing a design, hand off to the Mobile Feature Agent with this structure:
+
+```
+## Developer Handoff: [Feature Name]
+
+### Screens
+- [List all screens designed]
+
+### Design Tokens Used
+- Colors: [list all UiColors tokens]
+- Typography: [list all UiTypography tokens]
+- Spacing: [list all UiConstants tokens]
+- Icons: [list all UiIcons used with sizes]
+
+### Component Specifications
+[Detailed specs per component]
+
+### Edge Cases Designed
+- Empty state: [description]
+- Loading state: [description]
+- Error state: [description]
+
+### Responsive Notes
+- Mobile (375dp): [behavior]
+- Tablet (600dp+): [behavior]
+
+### Accessibility Notes
+- [Semantic labels, focus order, contrast notes]
+```
+
+## Agent Memory
+
+**Update your agent memory** as you discover design patterns, component usage, design system gaps, compliance issues, and architectural decisions in the KROW platform. This builds institutional knowledge across conversations.
+
+Examples of what to record:
+- Recurring design system violations and their locations in the codebase
+- Component patterns that have been established for specific feature types
+- Design tokens that are frequently needed but missing from the system
+- Accessibility patterns and solutions applied to specific UI challenges
+- Screen layouts and navigation patterns established for different user personas
+- Developer handoff preferences and implementation notes that proved useful
+- Dark theme edge cases and solutions discovered during design work
+
+# Persistent Agent Memory
+
+You have a persistent Persistent Agent Memory directory at `/Users/achinthaisuru/Documents/GitHub/krow-workforce/.claude/agent-memory/ui-ux-design/`. Its contents persist across conversations.
+
+As you work, consult your memory files to build on previous experience. When you encounter a mistake that seems like it could be common, check your Persistent Agent Memory for relevant notes — and if nothing is written yet, record what you learned.
+
+Guidelines:
+- `MEMORY.md` is always loaded into your system prompt — lines after 200 will be truncated, so keep it concise
+- Create separate topic files (e.g., `debugging.md`, `patterns.md`) for detailed notes and link to them from MEMORY.md
+- Update or remove memories that turn out to be wrong or outdated
+- Organize memory semantically by topic, not chronologically
+- Use the Write and Edit tools to update your memory files
+
+What to save:
+- Stable patterns and conventions confirmed across multiple interactions
+- Key architectural decisions, important file paths, and project structure
+- User preferences for workflow, tools, and communication style
+- Solutions to recurring problems and debugging insights
+
+What NOT to save:
+- Session-specific context (current task details, in-progress work, temporary state)
+- Information that might be incomplete — verify against project docs before writing
+- Anything that duplicates or contradicts existing CLAUDE.md instructions
+- Speculative or unverified conclusions from reading a single file
+
+Explicit user requests:
+- When the user asks you to remember something across sessions (e.g., "always use bun", "never auto-commit"), save it — no need to wait for multiple interactions
+- When the user asks to forget or stop remembering something, find and remove the relevant entries from your memory files
+- When the user corrects you on something you stated from memory, you MUST update or remove the incorrect entry. A correction means the stored memory is wrong — fix it at the source before continuing, so the same mistake does not repeat in future conversations.
+- Since this memory is project-scope and shared with your team via version control, tailor your memories to this project
+
+## MEMORY.md
+
+Your MEMORY.md is currently empty. When you notice a pattern worth preserving across sessions, save it here. Anything in MEMORY.md will be included in your system prompt next time.

.claude/skills/krow-mobile-architecture/SKILL.md

@@ -0,0 +1,923 @@
+---
+name: krow-mobile-architecture
+description: KROW mobile app Clean Architecture implementation including package structure, dependency rules, feature isolation, BLoC lifecycle management, session handling, and Data Connect connectors pattern. Use this when architecting new mobile features, debugging state management issues, preventing prop drilling, managing BLoC disposal, implementing session stores, or setting up connector repositories. Essential for maintaining architectural integrity across staff and client apps.
+---
+
+# KROW Mobile Architecture
+
+This skill defines the authoritative mobile architecture for the KROW platform. All code must strictly adhere to these principles to prevent architectural degradation.
+
+## When to Use This Skill
+
+- Architecting new mobile features
+- Debugging state management or BLoC lifecycle issues
+- Preventing prop drilling in UI code
+- Managing session state and authentication
+- Implementing Data Connect connector repositories
+- Setting up feature modules and dependency injection
+- Understanding package boundaries and dependencies
+- Refactoring legacy code to Clean Architecture
+
+## 1. High-Level Architecture
+
+KROW follows **Clean Architecture** in a **Melos Monorepo**. Dependencies flow **inward** toward the Domain.
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    Apps (Entry Points)                  │
+│  • apps/mobile/apps/client                              │
+│  • apps/mobile/apps/staff                               │
+│  Role: DI roots, navigation assembly, env config        │
+└─────────────────┬───────────────────────────────────────┘
+                  │ depends on
+┌─────────────────▼───────────────────────────────────────┐
+│                   Features (Vertical Slices)            │
+│  • apps/mobile/packages/features/client/*               │
+│  • apps/mobile/packages/features/staff/*                │
+│  Role: Pages, BLoCs, Use Cases, Feature Repositories    │
+└─────┬───────────────────────────────────────┬───────────┘
+      │ depends on                            │ depends on
+┌─────▼────────────────┐              ┌───────▼───────────┐
+│   Design System      │              │  Core Localization│
+│  • UI components     │              │  • LocaleBloc     │
+│  • Theme/colors      │              │  • Translations   │
+│  • Typography        │              │  • ErrorTranslator│
+└──────────────────────┘              └───────────────────┘
+                  │ both depend on
+┌─────────────────▼───────────────────────────────────────┐
+│               Services (Interface Adapters)             │
+│  • data_connect: Backend integration, session mgmt      │
+│  • core: Extensions, base classes, utilities            │
+└─────────────────┬───────────────────────────────────────┘
+                  │ both depend on
+┌─────────────────▼───────────────────────────────────────┐
+│                Domain (Stable Core)                     │
+│  • Entities (immutable data models)                     │
+│  • Failures (domain-specific errors)                    │
+│  • Pure Dart only, zero Flutter dependencies            │
+└─────────────────────────────────────────────────────────┘
+```
+
+**Critical Rule:** Dependencies point INWARD only. Domain knows nothing about the outer layers.
+
+## 2. Package Structure & Responsibilities
+
+### 2.1 Apps (`apps/mobile/apps/`)
+
+**Role:** Application entry points and DI roots
+
+**Responsibilities:**
+- Initialize Flutter Modular
+- Assemble features into navigation tree
+- Inject concrete implementations (from `data_connect`) into features
+- Configure environment-specific settings (dev/stage/prod)
+- Initialize session management
+
+**Structure:**
+```
+apps/mobile/apps/staff/
+├── lib/
+│   ├── main.dart              # Entry point, session initialization
+│   ├── app_module.dart        # Root module, imports features
+│   ├── app_widget.dart        # MaterialApp setup
+│   └── src/
+│       ├── navigation/        # Typed navigators
+│       └── widgets/           # SessionListener wrapper
+└── pubspec.yaml
+```
+
+**RESTRICTION:** NO business logic. NO UI widgets (except App and Main).
+
+### 2.2 Features (`apps/mobile/packages/features/<APP>/<FEATURE>`)
+
+**Role:** Vertical slices of user-facing functionality
+
+**Internal Structure:**
+```
+features/staff/profile/
+├── lib/
+│   ├── src/
+│   │   ├── domain/
+│   │   │   ├── repositories/        # Repository interfaces
+│   │   │   │   └── profile_repository_interface.dart
+│   │   │   └── usecases/           # Application logic
+│   │   │       └── get_profile_usecase.dart
+│   │   ├── data/
+│   │   │   └── repositories_impl/   # Repository concrete classes
+│   │   │       └── profile_repository_impl.dart
+│   │   └── presentation/
+│   │       ├── blocs/              # State management
+│   │       │   └── profile_cubit.dart
+│   │       ├── pages/              # Screens (StatelessWidget preferred)
+│   │       │   └── profile_page.dart
+│   │       └── widgets/            # Reusable UI components
+│   │           └── profile_header.dart
+│   └── profile_feature.dart        # Barrel file (public API only)
+└── pubspec.yaml
+```
+
+**Key Principles:**
+- **Presentation:** UI Pages and Widgets, BLoCs/Cubits for state
+- **Application:** Use Cases (business logic orchestration)
+- **Data:** Repository implementations (backend integration)
+- **Pages as StatelessWidget:** Move state to BLoCs for better performance and testability
+
+**RESTRICTION:** Features MUST NOT import other features. Communication happens via:
+- Shared domain entities
+- Session stores (`StaffSessionStore`, `ClientSessionStore`)
+- Navigation via Modular
+- Data Connect connector repositories
+
+### 2.3 Domain (`apps/mobile/packages/domain`)
+
+**Role:** The stable, pure heart of the system
+
+**Responsibilities:**
+- Define **Entities** (immutable data models using Data Classes or Freezed)
+- Define **Failures** (domain-specific error types)
+
+**Structure:**
+```
+domain/
+├── lib/
+│   └── src/
+│       ├── entities/
+│       │   ├── user.dart
+│       │   ├── staff.dart
+│       │   └── shift.dart
+│       └── failures/
+│           ├── failure.dart        # Base class
+│           ├── auth_failure.dart
+│           └── network_failure.dart
+└── pubspec.yaml
+```
+
+**Example Entity:**
+```dart
+import 'package:equatable/equatable.dart';
+
+class Staff extends Equatable {
+  final String id;
+  final String name;
+  final String email;
+  final StaffStatus status;
+  
+  const Staff({
+    required this.id,
+    required this.name,
+    required this.email,
+    required this.status,
+  });
+  
+  @override
+  List<Object?> get props => [id, name, email, status];
+}
+```
+
+**RESTRICTION:** 
+- NO Flutter dependencies (no `import 'package:flutter/material.dart'`)
+- NO `json_annotation` or serialization code
+- Only `equatable` for value equality
+- Pure Dart only
+
+### 2.4 Data Connect (`apps/mobile/packages/data_connect`)
+
+**Role:** Interface Adapter for Backend Access
+
+**Responsibilities:**
+- Centralized connector repositories (see Data Connect Connectors Pattern section)
+- Implement Firebase Data Connect service layer
+- Map Domain Entities ↔ Data Connect generated code
+- Handle Firebase exceptions → domain failures
+- Provide `DataConnectService` with session management
+
+**Structure:**
+```
+data_connect/
+├── lib/
+│   ├── src/
+│   │   ├── services/
+│   │   │   ├── data_connect_service.dart     # Core service
+│   │   │   └── mixins/
+│   │   │       └── session_handler_mixin.dart
+│   │   ├── connectors/                        # Connector pattern (see below)
+│   │   │   ├── staff/
+│   │   │   │   ├── domain/
+│   │   │   │   │   ├── repositories/
+│   │   │   │   │   │   └── staff_connector_repository.dart
+│   │   │   │   │   └── usecases/
+│   │   │   │   │       └── get_profile_completion_usecase.dart
+│   │   │   │   └── data/
+│   │   │   │       └── repositories/
+│   │   │   │           └── staff_connector_repository_impl.dart
+│   │   │   ├── order/
+│   │   │   └── shifts/
+│   │   └── session/
+│   │       ├── staff_session_store.dart
+│   │       └── client_session_store.dart
+│   └── krow_data_connect.dart               # Exports
+└── pubspec.yaml
+```
+
+**RESTRICTION:**
+- NO feature-specific logic
+- Connectors are domain-neutral and reusable
+- All queries follow Clean Architecture (domain interfaces → data implementations)
+
+### 2.5 Design System (`apps/mobile/packages/design_system`)
+
+**Role:** Visual language and component library
+
+**Responsibilities:**
+- Theme definitions (`UiColors`, `UiTypography`)
+- UI constants (`spacingL`, `radiusM`, etc.)
+- Shared widgets (if reused across multiple features)
+- Assets (icons, images, fonts)
+
+**Structure:**
+```
+design_system/
+├── lib/
+│   └── src/
+│       ├── ui_colors.dart
+│       ├── ui_typography.dart
+│       ├── ui_icons.dart
+│       ├── ui_constants.dart
+│       ├── ui_theme.dart          # ThemeData factory
+│       └── widgets/               # Shared UI components
+│           └── custom_button.dart
+└── assets/
+    ├── icons/
+    └── images/
+```
+
+**RESTRICTION:**
+- Dumb widgets ONLY (no state management)
+- NO business logic
+- Colors and typography are IMMUTABLE (no feature can override)
+
+### 2.6 Core Localization (`apps/mobile/packages/core_localization`)
+
+**Role:** Centralized i18n management
+
+**Responsibilities:**
+- Define all user-facing strings in `l10n/`
+- Provide `LocaleBloc` for locale state management
+- Export `TranslationProvider` for `context.strings` access
+- Map domain failures to localized error messages via `ErrorTranslator`
+
+**String Definition:**
+- Strings are defined in `packages/core_localization/lib/src/l10n/en.i18n.json` (English) and `es.i18n.json` (Spanish)
+- Both files MUST be updated together when adding/modifying strings
+- Generated output: `strings.g.dart`, `strings_en.g.dart`, `strings_es.g.dart`
+- Regenerate with: `cd packages/core_localization && dart run slang`
+
+**Feature Integration:**
+```dart
+// ✅ CORRECT: Access via Slang's global `t` accessor
+import 'package:core_localization/core_localization.dart';
+
+Text(t.client_create_order.review.invalid_arguments)
+Text(t.errors.order.creation_failed)
+
+// ❌ FORBIDDEN: Hardcoded user-facing strings
+Text('Invalid review arguments')  // Must use localized key
+Text('Order created!')            // Must use localized key
+```
+
+**RESTRICTION:** ALL user-facing strings in the presentation layer (Text widgets, SnackBars, AppBar titles, hints, labels, error messages, dialogs) MUST use localized keys via `t.<section>.<key>`. No hardcoded English or Spanish strings.
+
+**BLoC Error Flow:**
+```dart
+// BLoCs emit domain failures (not strings)
+emit(AuthError(InvalidCredentialsFailure()));
+
+// UI translates failures to localized messages
+final message = ErrorTranslator.translate(failure, context.strings);
+```
+
+**App Setup:**
+```dart
+// App imports LocalizationModule
+class AppModule extends Module {
+  @override
+  List<Module> get imports => [LocalizationModule()];
+}
+
+// Wrap app with providers
+BlocProvider<LocaleBloc>(
+  create: (_) => Modular.get<LocaleBloc>(),
+  child: TranslationProvider(
+    child: MaterialApp.router(...),
+  ),
+)
+```
+
+### 2.7 Core (`apps/mobile/packages/core`)
+
+**Role:** Cross-cutting concerns
+
+**Responsibilities:**
+- Extension methods (NavigationExtensions, ListExtensions, etc.)
+- Base classes (UseCase, Failure, BlocErrorHandler)
+- Logger configuration
+- Result types for functional error handling
+
+## 3. Dependency Direction Rules
+
+1. **Domain Independence:** `domain` knows NOTHING about outer layers
+   - Defines *what* needs to be done, not *how*
+   - Pure Dart, zero Flutter dependencies
+   - Stable contracts that rarely change
+
+2. **UI Agnosticism:** Features depend on `design_system` for UI and `domain` for logic
+   - Features do NOT know about Firebase or backend details
+   - Backend changes don't affect feature implementation
+
+3. **Data Isolation:** `data_connect` depends on `domain` to know interfaces
+   - Implements domain repository interfaces
+   - Maps backend models to domain entities
+   - Does NOT know about UI
+
+**Dependency Flow:**
+```
+Apps → Features → Design System
+                → Core Localization
+                → Data Connect → Domain
+                              → Core
+```
+
+## 4. Data Connect Service & Session Management
+
+### 4.1 Session Handler Mixin
+
+**Location:** `apps/mobile/packages/data_connect/lib/src/services/mixins/session_handler_mixin.dart`
+
+**Responsibilities:**
+- Automatic token refresh (triggered when <5 minutes to expiry)
+- Firebase auth state listening
+- Role-based access validation
+- Session state stream emissions
+- 3-attempt retry with exponential backoff (1s → 2s → 4s)
+
+**Key Method:**
+```dart
+// Call once on app startup
+DataConnectService.instance.initializeAuthListener(
+  allowedRoles: ['STAFF', 'BOTH'],  // or ['CLIENT', 'BUSINESS', 'BOTH']
+);
+```
+
+### 4.2 Session Listener Widget
+
+**Location:** `apps/mobile/apps/<app>/lib/src/widgets/session_listener.dart`
+
+**Responsibilities:**
+- Wraps entire app to listen to session state changes
+- Shows user-friendly dialogs for session expiration/errors
+- Handles navigation on auth state changes
+
+**Usage:**
+```dart
+// main.dart
+runApp(
+  SessionListener(  // ← Critical wrapper
+    child: ModularApp(module: AppModule(), child: AppWidget()),
+  ),
+);
+```
+
+### 4.3 Repository Pattern with Data Connect
+
+**Step 1:** Define interface in feature domain:
+```dart
+// features/staff/profile/lib/src/domain/repositories/
+abstract interface class ProfileRepositoryInterface {
+  Future<Staff> getProfile(String id);
+}
+```
+
+**Step 2:** Implement using `DataConnectService.run()`:
+```dart
+// features/staff/profile/lib/src/data/repositories_impl/
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**Benefits of `_service.run()`:**
+- ✅ Auto validates user is authenticated
+- ✅ Refreshes token if <5 min to expiry
+- ✅ Executes the query
+- ✅ 3-attempt retry with exponential backoff
+- ✅ Maps exceptions to domain failures
+
+### 4.4 Session Store Pattern
+
+After successful auth, populate session stores:
+
+**Staff App:**
+```dart
+StaffSessionStore.instance.setSession(
+  StaffSession(
+    user: user,
+    staff: staff,
+    ownerId: ownerId,
+  ),
+);
+```
+
+**Client App:**
+```dart
+ClientSessionStore.instance.setSession(
+  ClientSession(
+    user: user,
+    business: business,
+  ),
+);
+```
+
+**Lazy Loading:** If session is null, fetch from backend and update:
+```dart
+final session = StaffSessionStore.instance.session;
+if (session?.staff == null) {
+  final staff = await getStaffById(session!.user.uid);
+  StaffSessionStore.instance.setSession(
+    session.copyWith(staff: staff),
+  );
+}
+```
+
+## 5. Feature Isolation & Communication
+
+### Zero Direct Imports
+
+```dart
+// ❌ FORBIDDEN
+import 'package:staff_profile/staff_profile.dart';  // in another feature
+
+// ✅ ALLOWED
+import 'package:krow_domain/krow_domain.dart';      // shared domain
+import 'package:krow_core/krow_core.dart';          // shared utilities
+import 'package:design_system/design_system.dart';  // shared UI
+```
+
+### Navigation: Typed Navigators with Safe Extensions
+
+**Safe Navigation Extensions** (from `core` package):
+```dart
+extension NavigationExtensions on IModularNavigator {
+  /// Safely navigate with fallback to home
+  Future<void> safeNavigate(String route) async {
+    try {
+      await navigate(route);
+    } catch (e) {
+      await navigate('/home');  // Fallback
+    }
+  }
+  
+  /// Safely push with fallback to home
+  Future<T?> safePush<T>(String route) async {
+    try {
+      return await pushNamed<T>(route);
+    } catch (e) {
+      await navigate('/home');
+      return null;
+    }
+  }
+  
+  /// Safely pop with guard against empty stack
+  void popSafe() {
+    if (canPop()) {
+      pop();
+    } else {
+      navigate('/home');
+    }
+  }
+}
+```
+
+**Typed Navigators:**
+```dart
+// apps/mobile/apps/staff/lib/src/navigation/staff_navigator.dart
+extension StaffNavigator on IModularNavigator {
+  Future<void> toStaffHome() => safeNavigate(StaffPaths.home);
+  
+  Future<void> toShiftDetails(String shiftId) => 
+      safePush('${StaffPaths.shifts}/$shiftId');
+  
+  Future<void> toProfileEdit() => safePush(StaffPaths.profileEdit);
+}
+```
+
+**Usage in Features:**
+```dart
+// ✅ CORRECT
+Modular.to.toStaffHome();
+Modular.to.toShiftDetails(shiftId: '123');
+Modular.to.popSafe();
+
+// ❌ AVOID
+Modular.to.navigate('/home');  // No safety
+Navigator.push(...);            // No Modular integration
+```
+
+### Data Sharing Patterns
+
+Features don't share state directly. Use:
+
+1. **Domain Repositories:** Centralized data sources
+2. **Session Stores:** `StaffSessionStore`, `ClientSessionStore` for app-wide context
+3. **Event Streams:** If needed, via `DataConnectService` streams
+4. **Navigation Arguments:** Pass IDs, not full objects
+
+## 6. App-Specific Session Management
+
+### Staff App
+
+```dart
+// main.dart
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['STAFF', 'BOTH'],
+  );
+  
+  runApp(
+    SessionListener(
+      child: ModularApp(module: StaffAppModule(), child: StaffApp()),
+    ),
+  );
+}
+```
+
+**Session Store:** `StaffSessionStore`
+- Fields: `user`, `staff`, `ownerId`
+- Lazy load: `getStaffById()` if staff is null
+
+**Navigation:**
+- Authenticated → `Modular.to.toStaffHome()`
+- Unauthenticated → `Modular.to.toInitialPage()`
+
+### Client App
+
+```dart
+// main.dart
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['CLIENT', 'BUSINESS', 'BOTH'],
+  );
+  
+  runApp(
+    SessionListener(
+      child: ModularApp(module: ClientAppModule(), child: ClientApp()),
+    ),
+  );
+}
+```
+
+**Session Store:** `ClientSessionStore`
+- Fields: `user`, `business`
+- Lazy load: `getBusinessById()` if business is null
+
+**Navigation:**
+- Authenticated → `Modular.to.toClientHome()`
+- Unauthenticated → `Modular.to.toInitialPage()`
+
+## 7. Data Connect Connectors Pattern
+
+**Problem:** Without connectors, each feature duplicates backend queries.
+
+**Solution:** Centralize all backend queries in `data_connect/connectors/`.
+
+### Structure
+
+Mirror backend connector structure:
+
+```
+data_connect/lib/src/connectors/
+├── staff/
+│   ├── domain/
+│   │   ├── repositories/
+│   │   │   └── staff_connector_repository.dart      # Interface
+│   │   └── usecases/
+│   │       └── get_profile_completion_usecase.dart
+│   └── data/
+│       └── repositories/
+│           └── staff_connector_repository_impl.dart # Implementation
+├── order/
+├── shifts/
+└── user/
+```
+
+**Maps to backend:**
+```
+backend/dataconnect/connector/
+├── staff/
+├── order/
+├── shifts/
+└── user/
+```
+
+### Clean Architecture in Connectors
+
+**Domain Interface:**
+```dart
+// staff_connector_repository.dart
+abstract interface class StaffConnectorRepository {
+  Future<bool> getProfileCompletion();
+  Future<Staff> getStaffById(String id);
+}
+```
+
+**Use Case:**
+```dart
+// get_profile_completion_usecase.dart
+class GetProfileCompletionUseCase {
+  final StaffConnectorRepository _repository;
+  
+  GetProfileCompletionUseCase({required StaffConnectorRepository repository})
+      : _repository = repository;
+  
+  Future<bool> call() => _repository.getProfileCompletion();
+}
+```
+
+**Data Implementation:**
+```dart
+// staff_connector_repository_impl.dart
+class StaffConnectorRepositoryImpl implements StaffConnectorRepository {
+  final DataConnectService _service;
+  
+  @override
+  Future<bool> getProfileCompletion() async {
+    return _service.run(() async {
+      final staffId = await _service.getStaffId();
+      final response = await _service.connector
+          .getStaffProfileCompletion(id: staffId)
+          .execute();
+      
+      return _isProfileComplete(response);
+    });
+  }
+}
+```
+
+### Feature Integration
+
+**Step 1:** Feature registers connector repository:
+```dart
+// staff_main_module.dart
+class StaffMainModule extends Module {
+  @override
+  void binds(Injector i) {
+    i.addLazySingleton<StaffConnectorRepository>(
+      StaffConnectorRepositoryImpl.new,
+    );
+    
+    i.addLazySingleton(
+      () => GetProfileCompletionUseCase(
+        repository: i.get<StaffConnectorRepository>(),
+      ),
+    );
+    
+    i.addLazySingleton(
+      () => StaffMainCubit(
+        getProfileCompletionUsecase: i.get(),
+      ),
+    );
+  }
+}
+```
+
+**Step 2:** BLoC uses it:
+```dart
+class StaffMainCubit extends Cubit<StaffMainState> {
+  final GetProfileCompletionUseCase _getProfileCompletionUsecase;
+  
+  Future<void> loadProfileCompletion() async {
+    final isComplete = await _getProfileCompletionUsecase();
+    emit(state.copyWith(isProfileComplete: isComplete));
+  }
+}
+```
+
+### Benefits
+
+✅ **No Duplication** - Query implemented once, used by many features  
+✅ **Single Source of Truth** - Backend change → update one place  
+✅ **Reusability** - Any feature can use any connector  
+✅ **Testability** - Mock connector repo to test features  
+✅ **Scalability** - Easy to add connectors as backend grows  
+
+## 8. Avoiding Prop Drilling: Direct BLoC Access
+
+### The Problem
+
+Passing data through intermediate widgets creates maintenance burden:
+
+```dart
+// ❌ BAD: Prop drilling
+ProfilePage(status: status)
+  → ProfileHeader(status: status)
+    → ProfileLevelBadge(status: status)  // Only widget that needs it
+```
+
+### The Solution: BlocBuilder in Leaf Widgets
+
+```dart
+// ✅ GOOD: Direct BLoC access
+class ProfileLevelBadge extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<ProfileCubit, ProfileState>(
+      builder: (context, state) {
+        if (state.profile == null) return const SizedBox.shrink();
+        
+        final level = _mapStatusToLevel(state.profile!.status);
+        return LevelBadgeUI(level: level);
+      },
+    );
+  }
+}
+```
+
+### Guidelines
+
+1. **Leaf Widgets Access BLoC:** Widgets needing specific data should use `BlocBuilder`
+2. **Container Widgets Stay Simple:** Parent widgets only manage layout
+3. **No Unnecessary Props:** Don't pass data to intermediate widgets
+4. **Single Responsibility:** Each widget has one reason to exist
+
+**Decision Tree:**
+```
+Does this widget need data?
+├─ YES, leaf widget → Use BlocBuilder
+├─ YES, container → Use BlocBuilder in child
+└─ NO → Don't add prop
+```
+
+## 9. BLoC Lifecycle & State Emission Safety
+
+### The Problem: StateError After Dispose
+
+When async operations complete after BLoC is closed:
+```
+StateError: Cannot emit new states after calling close
+```
+
+**Root Causes:**
+1. Transient BLoCs created with `BlocProvider(create:)` → disposed prematurely
+2. Multiple BlocProviders disposing same singleton
+3. User navigates away during async operation
+
+### The Solution: Singleton BLoCs + Safe Emit
+
+#### Step 1: Register as Singleton
+
+```dart
+// ✅ GOOD: Singleton registration
+i.addLazySingleton<ProfileCubit>(
+  () => ProfileCubit(useCase1, useCase2),
+);
+
+// ❌ BAD: Creates new instance each time
+i.add(ProfileCubit.new);
+```
+
+#### Step 2: Use BlocProvider.value()
+
+```dart
+// ✅ GOOD: Reuse singleton
+final cubit = Modular.get<ProfileCubit>();
+BlocProvider<ProfileCubit>.value(
+  value: cubit,
+  child: MyWidget(),
+)
+
+// ❌ BAD: Creates duplicate
+BlocProvider<ProfileCubit>(
+  create: (_) => Modular.get<ProfileCubit>(),
+  child: MyWidget(),
+)
+```
+
+#### Step 3: Safe Emit with BlocErrorHandler
+
+**Location:** `apps/mobile/packages/core/lib/src/presentation/mixins/bloc_error_handler.dart`
+
+```dart
+mixin BlocErrorHandler<S> on Cubit<S> {
+  void _safeEmit(void Function(S) emit, S state) {
+    try {
+      emit(state);
+    } on StateError catch (e) {
+      developer.log(
+        'Could not emit state: ${e.message}. Bloc may have been disposed.',
+        name: runtimeType.toString(),
+      );
+    }
+  }
+}
+```
+
+**Usage:**
+```dart
+class ProfileCubit extends Cubit<ProfileState> with BlocErrorHandler<ProfileState> {
+  Future<void> loadProfile() async {
+    emit(state.copyWith(status: ProfileStatus.loading));
+    
+    await handleError(
+      emit: emit,
+      action: () async {
+        final profile = await getProfile();
+        emit(state.copyWith(status: ProfileStatus.loaded, profile: profile));
+        // ✅ Safe even if BLoC disposed
+      },
+      onError: (errorKey) => state.copyWith(status: ProfileStatus.error),
+    );
+  }
+}
+```
+
+### Pattern Summary
+
+| Pattern | When to Use | Risk |
+|---------|------------|------|
+| Singleton + BlocProvider.value() | Long-lived features | Low |
+| Transient + BlocProvider(create:) | Temporary widgets | Medium |
+| Direct BlocBuilder | Leaf widgets | Low |
+
+## 10. Anti-Patterns to Avoid
+
+❌ **Feature imports feature**
+```dart
+import 'package:staff_profile/staff_profile.dart';  // in another feature
+```
+
+❌ **Business logic in BLoC**
+```dart
+on<LoginRequested>((event, emit) {
+  if (event.email.isEmpty) {  // ← Use case responsibility
+    emit(AuthError('Email required'));
+  }
+});
+```
+
+❌ **Direct Data Connect in features**
+```dart
+final response = await FirebaseDataConnect.instance.query();  // ← Use repository
+```
+
+❌ **Global state variables**
+```dart
+User? currentUser;  // ← Use SessionStore
+```
+
+❌ **Direct Navigator.push**
+```dart
+Navigator.push(context, MaterialPageRoute(...));  // ← Use Modular
+```
+
+❌ **Hardcoded navigation**
+```dart
+Modular.to.navigate('/profile');  // ← Use safe extensions
+```
+
+❌ **Hardcoded user-facing strings**
+```dart
+Text('Order created successfully!');  // ← Use t.section.key from core_localization
+```
+
+## Summary
+
+The architecture enforces:
+- **Clean Architecture** with strict layer boundaries
+- **Feature Isolation** via zero cross-feature imports
+- **Session Management** via DataConnectService and SessionListener
+- **Connector Pattern** for reusable backend queries
+- **BLoC Lifecycle** safety with singletons and safe emit
+- **Navigation Safety** with typed navigators and fallbacks
+
+When implementing features:
+1. Follow package structure strictly
+2. Use connector repositories for backend access
+3. Register BLoCs as singletons with `.value()`
+4. Use safe navigation extensions
+5. Avoid prop drilling with direct BLoC access
+6. Keep domain pure and stable
+
+Architecture is not negotiable. When in doubt, refer to existing well-structured features or ask for clarification.

.claude/skills/krow-mobile-design-system/SKILL.md

@@ -0,0 +1,717 @@
+---
+name: krow-mobile-design-system
+description: KROW mobile design system usage rules covering colors, typography, icons, spacing, and UI component patterns. Use this when implementing UI in KROW mobile features, matching POC designs to production, creating themed widgets, enforcing visual consistency, or reviewing UI code compliance. Prevents hardcoded values and ensures brand consistency across staff and client apps. Critical for maintaining immutable design tokens.
+---
+
+# KROW Mobile Design System Usage
+
+This skill defines mandatory standards for UI implementation using the shared `apps/mobile/packages/design_system`. All UI must consume design system tokens exclusively.
+
+## When to Use This Skill
+
+- Implementing any UI in mobile features
+- Migrating POC/prototype designs to production
+- Creating new themed widgets or components
+- Reviewing UI code for design system compliance
+- Matching colors and typography from designs
+- Adding icons, spacing, or layout elements
+- Setting up theme configuration in apps
+- Refactoring UI code with hardcoded values
+
+## Core Principle
+
+**Design tokens (colors, typography, spacing) are IMMUTABLE and defined centrally.**
+
+Features consume tokens but NEVER modify them. The design system maintains visual coherence across all apps.
+
+## 1. Design System Ownership
+
+### Centralized Authority
+
+- `apps/mobile/packages/design_system` owns:
+  - All brand assets
+  - Colors and semantic color mappings
+  - Typography and font configurations
+  - Core UI components
+  - Icons and images
+  - Spacing, radius, elevation constants
+
+### No Local Overrides
+
+**✅ CORRECT:**
+```dart
+// Feature uses design system
+import 'package:design_system/design_system.dart';
+
+Container(
+  color: UiColors.background,
+  padding: EdgeInsets.all(UiConstants.spacingL),
+  child: Text(
+    'Hello',
+    style: UiTypography.display1m,
+  ),
+)
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Custom colors in feature
+const myBlue = Color(0xFF1A2234);
+
+// ❌ Custom text styles in feature
+const myStyle = TextStyle(fontSize: 24, fontWeight: FontWeight.bold);
+
+// ❌ Theme overrides in feature
+Theme(
+  data: ThemeData(primaryColor: Colors.blue),
+  child: MyWidget(),
+)
+```
+
+### Extension Policy
+
+If a required style is missing:
+1. **FIRST:** Add it to `design_system` following existing patterns
+2. **THEN:** Use it in your feature
+
+**DO NOT** create temporary workarounds with hardcoded values.
+
+## 2. Package Structure
+
+```
+apps/mobile/packages/design_system/
+├── lib/
+│   ├── src/
+│   │   ├── ui_colors.dart          # Color tokens
+│   │   ├── ui_typography.dart      # Text styles
+│   │   ├── ui_icons.dart           # Icon exports
+│   │   ├── ui_constants.dart       # Spacing, radius, elevation
+│   │   ├── ui_theme.dart           # ThemeData factory
+│   │   └── widgets/                # Shared UI components
+│   │       ├── custom_button.dart
+│   │       └── custom_app_bar.dart
+│   └── design_system.dart          # Public exports
+├── assets/
+│   ├── icons/
+│   ├── images/
+│   └── fonts/
+└── pubspec.yaml
+```
+
+## 3. Colors Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiColors for all color needs
+Container(color: UiColors.background)
+Text('Hello', style: TextStyle(color: UiColors.foreground))
+Icon(Icons.home, color: UiColors.primary)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Hardcoded hex colors
+Container(color: Color(0xFF1A2234))
+
+// ❌ Material color constants
+Container(color: Colors.blue)
+
+// ❌ Opacity on hardcoded colors
+Container(color: Color(0xFF1A2234).withOpacity(0.5))
+```
+
+### Available Color Categories
+
+**Brand Colors:**
+- `UiColors.primary` - Main brand color
+- `UiColors.secondary` - Secondary brand color
+- `UiColors.accent` - Accent highlights
+
+**Semantic Colors:**
+- `UiColors.background` - Page background
+- `UiColors.foreground` - Primary text color
+- `UiColors.card` - Card/container background
+- `UiColors.border` - Border colors
+- `UiColors.mutedForeground` - Secondary text
+
+**Status Colors:**
+- `UiColors.success` - Success states
+- `UiColors.warning` - Warning states
+- `UiColors.error` - Error states
+- `UiColors.info` - Information states
+
+### Color Matching from POCs
+
+When migrating POC designs:
+
+1. **Find closest match** in `UiColors`
+2. **Use existing color** even if slightly different
+3. **DO NOT add new colors** without design team approval
+
+**Example Process:**
+```dart
+// POC has: Color(0xFF2C3E50)
+// Find closest: UiColors.background or UiColors.card
+// Use: UiColors.card
+
+// POC has: Color(0xFF27AE60)
+// Find closest: UiColors.success
+// Use: UiColors.success
+```
+
+### Theme Access
+
+Colors can also be accessed via theme:
+```dart
+// Both are valid:
+Container(color: UiColors.primary)
+Container(color: Theme.of(context).colorScheme.primary)
+```
+
+## 4. Typography Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiTypography for all text
+Text('Title', style: UiTypography.display1m)
+Text('Body', style: UiTypography.body1r)
+Text('Label', style: UiTypography.caption1m)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Custom TextStyle
+Text('Title', style: TextStyle(
+  fontSize: 24,
+  fontWeight: FontWeight.bold,
+))
+
+// ❌ Manual font configuration
+Text('Body', style: TextStyle(
+  fontFamily: 'Inter',
+  fontSize: 16,
+))
+
+// ❌ Modifying existing styles inline
+Text('Title', style: UiTypography.display1m.copyWith(
+  fontSize: 28,  // ← Don't override size
+))
+```
+
+### Available Typography Styles
+
+**Display Styles (Large Headers):**
+- `UiTypography.display1m` - Display Medium
+- `UiTypography.display1sb` - Display Semi-Bold
+- `UiTypography.display1b` - Display Bold
+
+**Heading Styles:**
+- `UiTypography.heading1m` - H1 Medium
+- `UiTypography.heading1sb` - H1 Semi-Bold
+- `UiTypography.heading1b` - H1 Bold
+- `UiTypography.heading2m` - H2 Medium
+- `UiTypography.heading2sb` - H2 Semi-Bold
+
+**Body Styles:**
+- `UiTypography.body1r` - Body Regular
+- `UiTypography.body1m` - Body Medium
+- `UiTypography.body1sb` - Body Semi-Bold
+- `UiTypography.body2r` - Body 2 Regular
+
+**Caption/Label Styles:**
+- `UiTypography.caption1m` - Caption Medium
+- `UiTypography.caption1sb` - Caption Semi-Bold
+- `UiTypography.label1m` - Label Medium
+
+### Allowed Customizations
+
+**✅ ALLOWED (Color Only):**
+```dart
+// You MAY change color
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(
+    color: UiColors.error,  // ← OK
+  ),
+)
+```
+
+**❌ FORBIDDEN (Size, Weight, Family):**
+```dart
+// ❌ Don't change size
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontSize: 28),
+)
+
+// ❌ Don't change weight
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontWeight: FontWeight.w900),
+)
+
+// ❌ Don't change family
+Text(
+  'Title',
+  style: UiTypography.display1m.copyWith(fontFamily: 'Roboto'),
+)
+```
+
+### Typography Matching from POCs
+
+When migrating:
+1. Identify text role (heading, body, caption)
+2. Find closest matching style in `UiTypography`
+3. Use existing style even if size/weight differs slightly
+
+## 5. Icons Usage Rules
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiIcons
+Icon(UiIcons.home)
+Icon(UiIcons.profile)
+Icon(UiIcons.chevronLeft)
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Direct icon library imports
+import 'package:lucide_icons/lucide_icons.dart';
+Icon(LucideIcons.home)
+
+// ❌ Font Awesome direct
+import 'package:font_awesome_flutter/font_awesome_flutter.dart';
+FaIcon(FontAwesomeIcons.house)
+```
+
+### Why Centralize Icons?
+
+1. **Consistency:** Same icon for same action everywhere
+2. **Branding:** Unified icon set with consistent stroke weight
+3. **Swappability:** Change icon library in one place
+
+### Icon Libraries
+
+Design system uses:
+- `typedef _IconLib = LucideIcons;` (primary)
+- `typedef _IconLib2 = FontAwesomeIcons;` (secondary)
+
+**Features MUST NOT import these directly.**
+
+### Adding New Icons
+
+If icon missing:
+1. Add to `ui_icons.dart`:
+```dart
+class UiIcons {
+  static const home = _IconLib.home;
+  static const newIcon = _IconLib.newIcon;  // Add here
+}
+```
+2. Use in feature:
+```dart
+Icon(UiIcons.newIcon)
+```
+
+## 6. Spacing & Layout Constants
+
+### Strict Protocol
+
+**✅ DO:**
+```dart
+// Use UiConstants for spacing
+Padding(padding: EdgeInsets.all(UiConstants.spacingL))
+SizedBox(height: UiConstants.spacingM)
+Container(
+  padding: EdgeInsets.symmetric(
+    horizontal: UiConstants.spacingL,
+    vertical: UiConstants.spacingM,
+  ),
+)
+
+// Use UiConstants for radius
+Container(
+  decoration: BoxDecoration(
+    borderRadius: BorderRadius.circular(UiConstants.radiusM),
+  ),
+)
+
+// Use UiConstants for elevation
+elevation: UiConstants.elevationLow
+```
+
+**❌ DON'T:**
+```dart
+// ❌ Magic numbers
+Padding(padding: EdgeInsets.all(16.0))
+SizedBox(height: 24.0)
+BorderRadius.circular(8.0)
+elevation: 2.0
+```
+
+### Available Constants
+
+**Spacing:**
+```dart
+UiConstants.spacingXs   // Extra small
+UiConstants.spacingS    // Small
+UiConstants.spacingM    // Medium
+UiConstants.spacingL    // Large
+UiConstants.spacingXl   // Extra large
+UiConstants.spacing2xl  // 2x Extra large
+```
+
+**Border Radius:**
+```dart
+UiConstants.radiusS     // Small
+UiConstants.radiusM     // Medium
+UiConstants.radiusL     // Large
+UiConstants.radiusXl    // Extra large
+UiConstants.radiusFull  // Fully rounded
+```
+
+**Elevation:**
+```dart
+UiConstants.elevationNone
+UiConstants.elevationLow
+UiConstants.elevationMedium
+UiConstants.elevationHigh
+```
+
+## 7. Smart Widgets Usage
+
+### When to Use
+
+- **Prefer standard Flutter Material widgets** styled via theme
+- **Use design system widgets** for non-standard patterns
+- **Create new widgets** in design system if reused >3 features
+
+### Navigation in Widgets
+
+Widgets with navigation MUST use safe methods:
+
+**✅ CORRECT:**
+```dart
+// In UiAppBar back button:
+import 'package:flutter_modular/flutter_modular.dart';
+import 'package:krow_core/krow_core.dart';
+
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Modular.to.popSafe(),  // ← Safe pop
+)
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Direct Navigator
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Navigator.pop(context),
+)
+
+// ❌ Unsafe Modular
+IconButton(
+  icon: Icon(UiIcons.chevronLeft),
+  onPressed: () => Modular.to.pop(),  // Can crash
+)
+```
+
+### Composition Over Inheritance
+
+**✅ CORRECT:**
+```dart
+// Compose standard widgets
+Container(
+  padding: EdgeInsets.all(UiConstants.spacingL),
+  decoration: BoxDecoration(
+    color: UiColors.card,
+    borderRadius: BorderRadius.circular(UiConstants.radiusM),
+  ),
+  child: Column(
+    children: [
+      Text('Title', style: UiTypography.heading1sb),
+      SizedBox(height: UiConstants.spacingM),
+      Text('Body', style: UiTypography.body1r),
+    ],
+  ),
+)
+```
+
+**❌ AVOID:**
+```dart
+// ❌ Deep custom widget hierarchies
+class CustomCard extends StatelessWidget {
+  // Complex custom implementation
+}
+```
+
+## 8. Theme Configuration
+
+### App Setup
+
+Apps initialize theme ONCE in root MaterialApp:
+
+**✅ CORRECT:**
+```dart
+// apps/mobile/apps/staff/lib/app_widget.dart
+import 'package:design_system/design_system.dart';
+
+class StaffApp extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp.router(
+      theme: StaffTheme.light,  // ← Design system theme
+      darkTheme: StaffTheme.dark,  // ← Optional dark mode
+      themeMode: ThemeMode.system,
+      // ...
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Custom theme in app
+MaterialApp.router(
+  theme: ThemeData(
+    primaryColor: Colors.blue,  // ← NO!
+  ),
+)
+
+// ❌ Theme override in feature
+Theme(
+  data: ThemeData(...),
+  child: MyFeatureWidget(),
+)
+```
+
+### Accessing Theme
+
+**Both methods valid:**
+```dart
+// Method 1: Direct design system import
+import 'package:design_system/design_system.dart';
+Text('Hello', style: UiTypography.body1r)
+
+// Method 2: Via theme context
+Text('Hello', style: Theme.of(context).textTheme.bodyMedium)
+```
+
+**Prefer Method 1** for explicit type safety.
+
+## 9. POC → Production Workflow
+
+### Step 1: Implement Structure (POC Matching)
+
+Implement UI layout exactly matching POC:
+```dart
+// Temporary: Match POC visually
+Container(
+  color: Color(0xFF1A2234),  // ← POC color
+  padding: EdgeInsets.all(16.0),  // ← POC spacing
+  child: Text(
+    'Title',
+    style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),  // ← POC style
+  ),
+)
+```
+
+**Purpose:** Ensure visual parity with POC before refactoring.
+
+### Step 2: Architecture Refactor
+
+Move to Clean Architecture:
+- Extract business logic to use cases
+- Move state management to BLoCs
+- Implement repository pattern
+- Use dependency injection
+
+### Step 3: Design System Integration
+
+Replace hardcoded values:
+```dart
+// Production: Design system tokens
+Container(
+  color: UiColors.background,  // ← Found closest match
+  padding: EdgeInsets.all(UiConstants.spacingL),  // ← Used constant
+  child: Text(
+    'Title',
+    style: UiTypography.heading1sb,  // ← Matched typography
+  ),
+)
+```
+
+**Color Matching:**
+- POC `#1A2234` → `UiColors.background`
+- POC `#3498DB` → `UiColors.primary`
+- POC `#27AE60` → `UiColors.success`
+
+**Typography Matching:**
+- POC `24px bold` → `UiTypography.heading1sb`
+- POC `16px regular` → `UiTypography.body1r`
+- POC `14px medium` → `UiTypography.caption1m`
+
+**Spacing Matching:**
+- POC `16px` → `UiConstants.spacingL`
+- POC `8px` → `UiConstants.spacingM`
+- POC `4px` → `UiConstants.spacingS`
+
+## 10. Anti-Patterns & Common Mistakes
+
+### ❌ Magic Numbers
+```dart
+// BAD
+EdgeInsets.all(12.0)
+SizedBox(height: 24.0)
+BorderRadius.circular(8.0)
+
+// GOOD
+EdgeInsets.all(UiConstants.spacingM)
+SizedBox(height: UiConstants.spacingL)
+BorderRadius.circular(UiConstants.radiusM)
+```
+
+### ❌ Local Themes
+```dart
+// BAD
+Theme(
+  data: ThemeData(primaryColor: Colors.blue),
+  child: MyWidget(),
+)
+
+// GOOD
+// Use global theme defined in app
+```
+
+### ❌ Hex Hunting
+```dart
+// BAD: Copy-paste from Figma
+Container(color: Color(0xFF3498DB))
+
+// GOOD: Find matching design system color
+Container(color: UiColors.primary)
+```
+
+### ❌ Direct Icon Library
+```dart
+// BAD
+import 'package:lucide_icons/lucide_icons.dart';
+Icon(LucideIcons.home)
+
+// GOOD
+Icon(UiIcons.home)
+```
+
+### ❌ Custom Text Styles
+```dart
+// BAD
+Text('Title', style: TextStyle(
+  fontSize: 24,
+  fontWeight: FontWeight.bold,
+  fontFamily: 'Inter',
+))
+
+// GOOD
+Text('Title', style: UiTypography.heading1sb)
+```
+
+## 11. Design System Review Checklist
+
+Before merging UI code:
+
+### ✅ Design System Compliance
+- [ ] No hardcoded `Color(...)` or `0xFF...` hex values
+- [ ] No custom `TextStyle(...)` definitions
+- [ ] All spacing uses `UiConstants.spacing*`
+- [ ] All radius uses `UiConstants.radius*`
+- [ ] All elevation uses `UiConstants.elevation*`
+- [ ] All icons from `UiIcons`, not direct library imports
+- [ ] Theme consumed from design system, no local overrides
+- [ ] Layout matches POC intent using design system primitives
+
+### ✅ Architecture Compliance
+- [ ] No business logic in widgets
+- [ ] State managed by BLoCs
+- [ ] Navigation uses Modular safe extensions
+- [ ] Localization used for all text (no hardcoded strings)
+- [ ] No direct Data Connect queries in widgets
+
+### ✅ Code Quality
+- [ ] Widget build methods concise (<50 lines)
+- [ ] Complex widgets extracted to separate files
+- [ ] Meaningful widget names
+- [ ] Doc comments on reusable widgets
+
+## 12. When to Extend Design System
+
+### Add New Color
+**When:** New brand color approved by design team
+
+**Process:**
+1. Add to `ui_colors.dart`:
+```dart
+class UiColors {
+  static const myNewColor = Color(0xFF123456);
+}
+```
+2. Update theme if needed
+3. Use in features
+
+### Add New Typography Style
+**When:** New text style pattern emerges across multiple features
+
+**Process:**
+1. Add to `ui_typography.dart`:
+```dart
+class UiTypography {
+  static const myNewStyle = TextStyle(
+    fontSize: 20,
+    fontWeight: FontWeight.w600,
+    fontFamily: _fontFamily,
+  );
+}
+```
+2. Use in features
+
+### Add Shared Widget
+**When:** Widget reused in 3+ features
+
+**Process:**
+1. Create in `lib/src/widgets/`:
+```dart
+// my_widget.dart
+class MyWidget extends StatelessWidget {
+  // Implementation using design system tokens
+}
+```
+2. Export from `design_system.dart`
+3. Use across features
+
+## Summary
+
+**Core Rules:**
+1. **All colors from `UiColors`** - Zero hex codes in features
+2. **All typography from `UiTypography`** - Zero custom TextStyle
+3. **All spacing/radius/elevation from `UiConstants`** - Zero magic numbers
+4. **All icons from `UiIcons`** - Zero direct library imports
+5. **Theme defined once** in app entry point
+6. **POC → Production** requires design system integration step
+
+**The Golden Rule:** Design system is immutable. Features adapt to the system, not the other way around.
+
+When implementing UI:
+1. Import `package:design_system/design_system.dart`
+2. Use design system tokens exclusively
+3. Match POC intent with available tokens
+4. Request new tokens only when truly necessary
+5. Never create temporary hardcoded workarounds
+
+Visual consistency is non-negotiable. Every pixel must come from the design system.

.claude/skills/krow-mobile-development-rules/SKILL.md

@@ -0,0 +1,646 @@
+---
+name: krow-mobile-development-rules
+description: Enforce KROW mobile app development standards including file structure, naming conventions, logic placement boundaries, localization, Data Connect integration, and prototype migration rules. Use this skill whenever working on KROW Flutter mobile features, creating new packages, implementing BLoCs, integrating with backend, or migrating from prototypes. Critical for maintaining clean architecture and preventing architectural degradation.
+---
+
+# KROW Mobile Development Rules
+
+These rules are **NON-NEGOTIABLE** enforcement guidelines for the KROW mobile application. They prevent architectural degradation and ensure consistency across the codebase.
+
+## When to Use This Skill
+
+- Creating new mobile features or packages
+- Implementing BLoCs, Use Cases, or Repositories
+- Integrating with Firebase Data Connect backend
+- Migrating code from prototypes
+- Reviewing mobile code for compliance
+- Setting up new feature modules
+- Handling user sessions and authentication
+- Implementing navigation flows
+
+## 1. File Creation & Package Structure
+
+### Feature-First Packaging
+
+**✅ DO:**
+- Create new features as independent packages:
+  ```
+  apps/mobile/packages/features/<app_name>/<feature_name>/
+  ├── lib/
+  │   ├── src/
+  │   │   ├── domain/
+  │   │   │   ├── repositories/
+  │   │   │   └── usecases/
+  │   │   ├── data/
+  │   │   │   └── repositories_impl/
+  │   │   └── presentation/
+  │   │       ├── blocs/
+  │   │       ├── pages/
+  │   │       └── widgets/
+  │   └── <feature_name>.dart  # Barrel file
+  └── pubspec.yaml
+  ```
+
+**❌ DON'T:**
+- Add features to `apps/mobile/packages/core` directly
+- Create files in app directories (`apps/mobile/apps/client/` or `apps/mobile/apps/staff/`)
+- Create cross-feature or cross-app dependencies (features must not import other features)
+
+### Path Conventions (Strict)
+
+Follow these exact paths:
+
+| Layer | Path Pattern | Example |
+|-------|-------------|---------|
+| **Entities** | `apps/mobile/packages/domain/lib/src/entities/<entity>.dart` | `user.dart`, `shift.dart` |
+| **Repository Interface** | `.../features/<app>/<feature>/lib/src/domain/repositories/<name>_repository_interface.dart` | `auth_repository_interface.dart` |
+| **Repository Impl** | `.../features/<app>/<feature>/lib/src/data/repositories_impl/<name>_repository_impl.dart` | `auth_repository_impl.dart` |
+| **Use Cases** | `.../features/<app>/<feature>/lib/src/application/<name>_usecase.dart` | `login_usecase.dart` |
+| **BLoCs** | `.../features/<app>/<feature>/lib/src/presentation/blocs/<name>_bloc.dart` | `auth_bloc.dart` |
+| **Pages** | `.../features/<app>/<feature>/lib/src/presentation/pages/<name>_page.dart` | `login_page.dart` |
+| **Widgets** | `.../features/<app>/<feature>/lib/src/presentation/widgets/<name>_widget.dart` | `password_field.dart` |
+
+### Barrel Files
+
+**✅ DO:**
+```dart
+// lib/auth_feature.dart
+export 'src/presentation/pages/login_page.dart';
+export 'src/domain/repositories/auth_repository_interface.dart';
+// Only export PUBLIC API
+```
+
+**❌ DON'T:**
+```dart
+// Don't export internal implementation details
+export 'src/data/repositories_impl/auth_repository_impl.dart';
+export 'src/presentation/blocs/auth_bloc.dart';
+```
+
+## 2. Naming Conventions (Dart Standard)
+
+| Type | Convention | Example | File Name |
+|------|-----------|---------|-----------|
+| **Files** | `snake_case` | `user_profile_page.dart` | - |
+| **Classes** | `PascalCase` | `UserProfilePage` | - |
+| **Variables** | `camelCase` | `userProfile` | - |
+| **Interfaces** | End with `Interface` | `AuthRepositoryInterface` | `auth_repository_interface.dart` |
+| **Implementations** | End with `Impl` | `AuthRepositoryImpl` | `auth_repository_impl.dart` |
+| **BLoCs** | End with `Bloc` or `Cubit` | `AuthBloc`, `ProfileCubit` | `auth_bloc.dart` |
+| **Use Cases** | End with `UseCase` | `LoginUseCase` | `login_usecase.dart` |
+
+## 3. Logic Placement (Zero Tolerance Boundaries)
+
+### Business Rules → Use Cases ONLY
+
+**✅ CORRECT:**
+```dart
+// login_usecase.dart
+class LoginUseCase extends UseCase<User, LoginParams> {
+  @override
+  Future<Either<Failure, User>> call(LoginParams params) async {
+    // Business logic here: validation, transformation, orchestration
+    if (params.email.isEmpty) {
+      return Left(ValidationFailure('Email required'));
+    }
+    return await repository.login(params);
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Business logic in BLoC
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) {
+    if (event.email.isEmpty) {  // ← NO! This is business logic
+      emit(AuthError('Email required'));
+    }
+  });
+}
+
+// ❌ Business logic in Widget
+class LoginPage extends StatelessWidget {
+  void _login() {
+    if (_emailController.text.isEmpty) {  // ← NO! This is business logic
+      showSnackbar('Email required');
+    }
+  }
+}
+```
+
+### State Logic → BLoCs ONLY
+
+**✅ CORRECT:**
+```dart
+// auth_bloc.dart
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) async {
+    emit(AuthLoading());
+    final result = await loginUseCase(LoginParams(email: event.email));
+    result.fold(
+      (failure) => emit(AuthError(failure)),
+      (user) => emit(AuthAuthenticated(user)),
+    );
+  });
+}
+
+// login_page.dart (StatelessWidget)
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<AuthBloc, AuthState>(
+      builder: (context, state) {
+        if (state is AuthLoading) return LoadingIndicator();
+        if (state is AuthError) return ErrorWidget(state.message);
+        return LoginForm();
+      },
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ setState in Pages for complex state
+class LoginPage extends StatefulWidget {
+  @override
+  State<LoginPage> createState() => _LoginPageState();
+}
+
+class _LoginPageState extends State<LoginPage> {
+  bool _isLoading = false;  // ← NO! Use BLoC
+  String? _error;          // ← NO! Use BLoC
+  
+  void _login() {
+    setState(() => _isLoading = true);  // ← NO! Use BLoC
+  }
+}
+```
+
+**RECOMMENDATION:** Pages should be `StatelessWidget` with state delegated to BLoCs.
+
+### Data Transformation → Repositories
+
+**✅ CORRECT:**
+```dart
+// profile_repository_impl.dart
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  @override
+  Future<Staff> getProfile(String id) async {
+    final response = await dataConnect.getStaffById(id: id).execute();
+    // Data transformation happens here
+    return Staff(
+      id: response.data.staff.id,
+      name: response.data.staff.name,
+      // Map Data Connect model to Domain entity
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ JSON parsing in UI
+class ProfilePage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    final json = jsonDecode(response.body);  // ← NO!
+    final name = json['name'];
+  }
+}
+
+// ❌ JSON parsing in Domain Use Case
+class GetProfileUseCase extends UseCase<Staff, String> {
+  @override
+  Future<Either<Failure, Staff>> call(String id) async {
+    final response = await http.get('/staff/$id');
+    final json = jsonDecode(response.body);  // ← NO!
+  }
+}
+```
+
+### Navigation → Flutter Modular + Safe Extensions
+
+**✅ CORRECT:**
+```dart
+// Use Safe Navigation Extensions
+import 'package:krow_core/krow_core.dart';
+
+// In widget/BLoC:
+Modular.to.safePush('/profile');
+Modular.to.safeNavigate('/home');
+Modular.to.popSafe();
+
+// Even better: Use Typed Navigators
+Modular.to.toStaffHome();  // Defined in StaffNavigator
+Modular.to.toShiftDetails(shiftId: '123');
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Direct Navigator.push
+Navigator.push(
+  context,
+  MaterialPageRoute(builder: (_) => ProfilePage()),
+);
+
+// ❌ Direct Modular navigation without safety
+Modular.to.navigate('/profile');  // ← Can cause blank screens
+Modular.to.pop();  // ← Can crash if stack is empty
+```
+
+**PATTERN:** All navigation MUST have fallback to Home page. Safe extensions automatically handle this.
+
+### Session Management → DataConnectService + SessionHandlerMixin
+
+**✅ CORRECT:**
+```dart
+// In main.dart:
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  
+  // Initialize session listener (pick allowed roles for app)
+  DataConnectService.instance.initializeAuthListener(
+    allowedRoles: ['STAFF', 'BOTH'],  // for staff app
+  );
+  
+  runApp(
+    SessionListener(  // Wraps entire app
+      child: ModularApp(module: AppModule(), child: AppWidget()),
+    ),
+  );
+}
+
+// In repository:
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    // _service.run() handles:
+    // - Auth validation
+    // - Token refresh (if <5 min to expiry)
+    // - Error handling with 3 retries
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**PATTERN:**
+- **SessionListener** widget wraps app and shows dialogs for session errors
+- **SessionHandlerMixin** in `DataConnectService` provides automatic token refresh
+- **3-attempt retry logic** with exponential backoff (1s → 2s → 4s)
+- **Role validation** configurable per app
+
+## 4. Localization Integration (core_localization)
+
+All user-facing text MUST be localized.
+
+### String Management
+
+**✅ CORRECT:**
+```dart
+// In presentation layer:
+import 'package:core_localization/core_localization.dart';
+
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Text(context.strings.loginButton);  // ← From localization
+    return ElevatedButton(
+      onPressed: _login,
+      child: Text(context.strings.submit),
+    );
+  }
+}
+```
+
+**❌ FORBIDDEN:**
+```dart
+// ❌ Hardcoded English strings
+Text('Login')
+Text('Submit')
+ElevatedButton(child: Text('Click here'))
+```
+
+### BLoC Integration
+
+**✅ CORRECT:**
+```dart
+// BLoCs emit domain failures (not localized strings)
+class AuthBloc extends Bloc<AuthEvent, AuthState> {
+  on<LoginRequested>((event, emit) async {
+    final result = await loginUseCase(params);
+    result.fold(
+      (failure) => emit(AuthError(failure)),  // ← Domain failure
+      (user) => emit(AuthAuthenticated(user)),
+    );
+  });
+}
+
+// UI translates failures to user-friendly messages
+class LoginPage extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return BlocBuilder<AuthBloc, AuthState>(
+      builder: (context, state) {
+        if (state is AuthError) {
+          final message = ErrorTranslator.translate(
+            state.failure,
+            context.strings,
+          );
+          return ErrorWidget(message);  // ← Localized
+        }
+      },
+    );
+  }
+}
+```
+
+### App Setup
+
+Apps must import `LocalizationModule()`:
+```dart
+// app_module.dart
+class AppModule extends Module {
+  @override
+  List<Module> get imports => [
+    LocalizationModule(),  // ← Required
+    DataConnectModule(),
+  ];
+}
+
+// main.dart
+runApp(
+  BlocProvider<LocaleBloc>(  // ← Expose locale state
+    create: (_) => Modular.get<LocaleBloc>(),
+    child: TranslationProvider(  // ← Enable context.strings
+      child: MaterialApp.router(...),
+    ),
+  ),
+);
+```
+
+## 5. Data Connect Integration
+
+All backend access goes through `DataConnectService`.
+
+### Repository Pattern
+
+**Step 1:** Define interface in feature domain:
+```dart
+// domain/repositories/profile_repository_interface.dart
+abstract interface class ProfileRepositoryInterface {
+  Future<Staff> getProfile(String id);
+  Future<bool> updateProfile(Staff profile);
+}
+```
+
+**Step 2:** Implement using `DataConnectService.run()`:
+```dart
+// data/repositories_impl/profile_repository_impl.dart
+class ProfileRepositoryImpl implements ProfileRepositoryInterface {
+  final DataConnectService _service = DataConnectService.instance;
+  
+  @override
+  Future<Staff> getProfile(String id) async {
+    return await _service.run(() async {
+      final response = await _service.connector
+          .getStaffById(id: id)
+          .execute();
+      return _mapToStaff(response.data.staff);
+    });
+  }
+}
+```
+
+**Benefits of `_service.run()`:**
+- ✅ Automatic auth validation
+- ✅ Token refresh if needed
+- ✅ 3-attempt retry with exponential backoff
+- ✅ Consistent error handling
+
+### Session Store Pattern
+
+After successful auth, populate session stores:
+```dart
+// For Staff App:
+StaffSessionStore.instance.setSession(
+  StaffSession(
+    user: user,
+    staff: staff,
+    ownerId: ownerId,
+  ),
+);
+
+// For Client App:
+ClientSessionStore.instance.setSession(
+  ClientSession(
+    user: user,
+    business: business,
+  ),
+);
+```
+
+**Lazy Loading:** If session is null, fetch via `getStaffById()` or `getBusinessById()` and update store.
+
+## 6. Prototype Migration Rules
+
+When migrating from `prototypes/`:
+
+### ✅ MAY Copy
+- Icons, images, assets (but match to design system)
+- `build` methods for UI layout structure
+- Screen flow and navigation patterns
+
+### ❌ MUST REJECT & REFACTOR
+- `GetX`, `Provider`, or `MVC` patterns
+- Any state management not using BLoC
+- Direct HTTP calls (must use Data Connect)
+- Hardcoded colors/typography (must use design system)
+- Global state variables
+- Navigation without Modular
+
+### Colors & Typography Migration
+**When matching POC to production:**
+1. Find closest color in `UiColors` (don't add new colors without approval)
+2. Find closest text style in `UiTypography`
+3. Use design system constants, NOT POC hardcoded values
+
+**DO NOT change the design system itself.** Colors and typography are FINAL. Match your feature to the system, not the other way around.
+
+## 7. Handling Ambiguity
+
+If requirements are unclear:
+
+1. **STOP** - Don't guess domain fields or workflows
+2. **ANALYZE** - Refer to:
+   - Architecture: `apps/mobile/docs/01-architecture-principles.md`
+   - Design System: `apps/mobile/docs/02-design-system-usage.md`
+   - Existing features for patterns
+3. **DOCUMENT** - Add `// ASSUMPTION: <explanation>` if you must proceed
+4. **ASK** - Prefer asking user for clarification on business rules
+
+## 8. Dependencies
+
+### DO NOT
+- Add 3rd party packages without checking `apps/mobile/packages/core` first
+- Add `firebase_auth` or `firebase_data_connect` to Feature packages (they belong in `data_connect` only)
+- Use `addSingleton` for BLoCs (always use `add` method in Modular)
+
+### DO
+- Use `DataConnectService.instance` for backend operations
+- Use Flutter Modular for dependency injection
+- Register BLoCs with `i.addSingleton<CubitType>(() => CubitType(...))`
+- Register Use Cases as factories or singletons as needed
+
+## 9. Error Handling Pattern
+
+### Domain Failures
+```dart
+// domain/failures/auth_failure.dart
+abstract class AuthFailure extends Failure {
+  const AuthFailure(String message) : super(message);
+}
+
+class InvalidCredentialsFailure extends AuthFailure {
+  const InvalidCredentialsFailure() : super('Invalid credentials');
+}
+```
+
+### Repository Error Mapping
+```dart
+// Map Data Connect exceptions to Domain failures
+try {
+  final response = await dataConnect.query();
+  return Right(response);
+} on DataConnectException catch (e) {
+  if (e.message.contains('unauthorized')) {
+    return Left(InvalidCredentialsFailure());
+  }
+  return Left(ServerFailure(e.message));
+}
+```
+
+### UI Feedback
+```dart
+// BLoC emits error state
+emit(AuthError(failure));
+
+// UI shows user-friendly message
+if (state is AuthError) {
+  final message = ErrorTranslator.translate(state.failure, context.strings);
+  ScaffoldMessenger.of(context).showSnackBar(
+    SnackBar(content: Text(message)),
+  );
+}
+```
+
+### Session Errors
+`SessionListener` automatically shows dialogs for:
+- Session expiration
+- Token refresh failures
+- Network errors during auth
+
+## 10. Testing Requirements
+
+### Unit Tests
+```dart
+// Test use cases with real repository implementations
+test('login with valid credentials returns user', () async {
+  final useCase = LoginUseCase(repository: mockRepository);
+  final result = await useCase(LoginParams(email: 'test@test.com'));
+  expect(result.isRight(), true);
+});
+```
+
+### Widget Tests
+```dart
+// Test UI widgets and BLoC interactions
+testWidgets('shows loading indicator when logging in', (tester) async {
+  await tester.pumpWidget(
+    BlocProvider<AuthBloc>(
+      create: (_) => authBloc,
+      child: LoginPage(),
+    ),
+  );
+  
+  authBloc.add(LoginRequested(email: 'test@test.com'));
+  await tester.pump();
+  
+  expect(find.byType(LoadingIndicator), findsOneWidget);
+});
+```
+
+### Integration Tests
+- Test full feature flows end-to-end with Data Connect
+- Use dependency injection to swap implementations if needed
+
+## 11. Clean Code Principles
+
+### Documentation
+- ✅ Add human readable doc comments for `dartdoc`  for all classes and methods.
+```dart
+/// Authenticates user with email and password.
+/// 
+/// Returns [User] on success or [AuthFailure] on failure.
+/// Throws [NetworkException] if connection fails.
+class LoginUseCase extends UseCase<User, LoginParams> {
+  // ...
+}
+```
+
+### Single Responsibility
+- Keep methods focused on one task
+- Extract complex logic to separate methods
+- Keep widget build methods concise
+- Extract complex widgets to separate files
+
+### Meaningful Names
+```dart
+// ✅ GOOD
+final isProfileComplete = await checkProfileCompletion();
+final userShifts = await fetchUserShifts();
+
+// ❌ BAD
+final flag = await check();
+final data = await fetch();
+```
+
+## Enforcement Checklist
+
+Before merging any mobile feature code:
+
+### Architecture Compliance
+- [ ] Feature follows package structure (domain/data/presentation)
+- [ ] No business logic in BLoCs or Widgets
+- [ ] All state management via BLoCs
+- [ ] All backend access via repositories
+- [ ] Session accessed via SessionStore, not global state
+- [ ] Navigation uses Flutter Modular safe extensions
+- [ ] No feature-to-feature imports
+
+### Code Quality
+- [ ] No hardcoded strings (use localization)
+- [ ] No hardcoded colors/typography (use design system)
+- [ ] All spacing uses UiConstants
+- [ ] Doc comments on public APIs
+- [ ] Meaningful variable names
+- [ ] Zero analyzer warnings
+
+### Integration
+- [ ] Data Connect queries via `_service.run()`
+- [ ] Error handling with domain failures
+- [ ] Proper dependency injection in modules
+
+## Summary
+
+The key principle: **Clean Architecture with zero tolerance for violations.** Business logic in Use Cases, state in BLoCs, data access in Repositories, UI in Widgets. Features are isolated, backend is centralized, localization is mandatory, and design system is immutable.
+
+When in doubt, refer to existing features following these patterns or ask for clarification. It's better to ask than to introduce architectural debt.

.claude/skills/krow-mobile-release/SKILL.md

@@ -0,0 +1,778 @@
+---
+name: krow-mobile-release
+description: KROW mobile app release process including versioning strategy, CHANGELOG management, GitHub Actions workflows, APK signing, Git tagging, and hotfix procedures. Use this when preparing mobile releases, updating CHANGELOGs, triggering release workflows, creating hotfix branches, troubleshooting release issues, or documenting release features. Covers both staff (worker) and client mobile products across dev/stage/prod environments.
+---
+
+# KROW Mobile Release Process
+
+This skill defines the comprehensive release process for KROW mobile applications (staff and client). It covers versioning, changelog management, GitHub Actions automation, and hotfix procedures.
+
+## When to Use This Skill
+
+- Preparing for a mobile app release
+- Updating CHANGELOG files with new features
+- Triggering GitHub Actions release workflows
+- Creating hotfix branches for production issues
+- Understanding version numbering strategy
+- Setting up APK signing secrets
+- Troubleshooting release workflow failures
+- Documenting release notes
+- Managing release cadence (dev → stage → prod)
+
+## Quick Reference
+
+### Release Workflows
+- **Product Release:** [GitHub Actions - Product Release](https://github.com/Oloodi/krow-workforce/actions/workflows/product-release.yml)
+- **Hotfix Creation:** [GitHub Actions - Product Hotfix](https://github.com/Oloodi/krow-workforce/actions/workflows/hotfix-branch-creation.yml)
+
+### Key Files
+- **Staff CHANGELOG:** `apps/mobile/apps/staff/CHANGELOG.md`
+- **Client CHANGELOG:** `apps/mobile/apps/client/CHANGELOG.md`
+- **Staff Version:** `apps/mobile/apps/staff/pubspec.yaml`
+- **Client Version:** `apps/mobile/apps/client/pubspec.yaml`
+
+### Comprehensive Documentation
+For complete details, see: [`docs/RELEASE/mobile-releases.md`](docs/RELEASE/mobile-releases.md) (900+ lines)
+
+## 1. Versioning Strategy
+
+### Format
+
+```
+v{major}.{minor}.{patch}-{milestone}
+```
+
+**Examples:**
+- `v0.0.1-m4` - Milestone 4 release
+- `v0.1.0-m5` - Minor version bump for Milestone 5
+- `v1.0.0` - First production release (no milestone suffix)
+
+### Semantic Versioning Rules
+
+**Major (X.0.0):**
+- Breaking changes
+- Complete architecture overhaul
+- Incompatible API changes
+
+**Minor (0.X.0):**
+- New features
+- Backwards-compatible additions
+- Milestone completions
+
+**Patch (0.0.X):**
+- Bug fixes
+- Security patches
+- Performance improvements
+
+**Milestone Suffix:**
+- `-m1`, `-m2`, `-m3`, `-m4`, etc.
+- Indicates pre-production milestone phase
+- Removed for production releases
+
+### Version Location
+
+Versions are defined in `pubspec.yaml`:
+
+**Staff App:**
+```yaml
+# apps/mobile/apps/staff/pubspec.yaml
+name: krow_staff_app
+version: 0.0.1-m4+1  # version+build_number
+```
+
+**Client App:**
+```yaml
+# apps/mobile/apps/client/pubspec.yaml
+name: krow_client_app
+version: 0.0.1-m4+1
+```
+
+**Format:** `version+build`
+- `version`: Semantic version with milestone (e.g., `0.0.1-m4`)
+- `build`: Build number (increments with each build, e.g., `+1`, `+2`)
+
+## 2. CHANGELOG Management
+
+### Format
+
+Each app maintains a separate CHANGELOG following [Keep a Changelog](https://keepachangelog.com/) format.
+
+**Structure:**
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+### Added
+- New feature descriptions
+
+### Changed
+- Modified feature descriptions
+
+### Fixed
+- Bug fix descriptions
+
+### Removed
+- Removed feature descriptions
+
+## [0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added
+- Profile management with 13 subsections
+- Documents & certificates management
+- Benefits overview section
+- Camera/gallery support for attire verification
+
+### Changed
+- Enhanced session management with auto token refresh
+
+### Fixed
+- Navigation fallback to home on invalid routes
+```
+
+### Section Guidelines
+
+**[Unreleased]**
+- Work in progress
+- Features merged to dev but not released
+- Updated continuously during development
+
+**[Version] - Milestone X - Date**
+- Released version
+- Format: `[X.Y.Z-mN] - Milestone N - YYYY-MM-DD`
+- Organized by change type (Added/Changed/Fixed/Removed)
+
+### Change Type Definitions
+
+**Added:**
+- New features
+- New UI screens
+- New API integrations
+- New user-facing capabilities
+
+**Changed:**
+- Modifications to existing features
+- UI/UX improvements
+- Performance enhancements
+- Refactored code (if user-facing impact)
+
+**Fixed:**
+- Bug fixes
+- Error handling improvements
+- Crash fixes
+- UI/UX issues resolved
+
+**Removed:**
+- Deprecated features
+- Removed screens or capabilities
+- Discontinued integrations
+
+### Writing Guidelines
+
+**✅ GOOD:**
+```markdown
+### Added
+- Profile management with 13 subsections organized into onboarding, compliance, finances, and support categories
+- Documents & certificates management with upload, status tracking, and expiry dates
+- Camera and gallery support for attire verification with photo capture
+- Benefits overview section displaying perks and company information
+```
+
+**❌ BAD:**
+```markdown
+### Added
+- New stuff
+- Fixed things
+- Updated code
+```
+
+**Key Principles:**
+- Be specific and descriptive
+- Focus on user-facing changes
+- Mention UI screens, features, or capabilities
+- Avoid technical jargon users won't understand
+- Group related changes together
+
+### Updating CHANGELOG Workflow
+
+**Step 1:** During development, add to `[Unreleased]`:
+```markdown
+## [Unreleased]
+
+### Added
+- New shift calendar view with month/week toggle
+- Shift acceptance confirmation dialog
+
+### Fixed
+- Navigation crash when popping empty stack
+```
+
+**Step 2:** Before release, move to version section:
+```markdown
+## [0.1.0-m5] - Milestone 5 - 2026-03-15
+
+### Added
+- New shift calendar view with month/week toggle
+- Shift acceptance confirmation dialog
+
+### Fixed
+- Navigation crash when popping empty stack
+
+## [Unreleased]
+<!-- Empty for next development cycle -->
+```
+
+**Step 3:** Update version in `pubspec.yaml`:
+```yaml
+version: 0.1.0-m5+1
+```
+
+## 3. Git Tagging Strategy
+
+### Tag Format
+
+```
+krow-withus-<app>-mobile/<env>-vX.Y.Z
+```
+
+**Components:**
+- `<app>`: `worker` (staff) or `client`
+- `<env>`: `dev`, `stage`, or `prod`
+- `vX.Y.Z`: Semantic version (from pubspec.yaml)
+
+**Examples:**
+```
+krow-withus-worker-mobile/dev-v0.0.1-m4
+krow-withus-worker-mobile/stage-v0.0.1-m4
+krow-withus-worker-mobile/prod-v0.0.1-m4
+krow-withus-client-mobile/dev-v0.0.1-m4
+```
+
+### Tag Creation
+
+Tags are created automatically by GitHub Actions workflows. Manual tagging:
+
+```bash
+# Staff app - dev environment
+git tag krow-withus-worker-mobile/dev-v0.0.1-m4
+git push origin krow-withus-worker-mobile/dev-v0.0.1-m4
+
+# Client app - prod environment
+git tag krow-withus-client-mobile/prod-v1.0.0
+git push origin krow-withus-client-mobile/prod-v1.0.0
+```
+
+### Tag Listing
+
+```bash
+# List all mobile tags
+git tag -l "krow-withus-*-mobile/*"
+
+# List staff app tags
+git tag -l "krow-withus-worker-mobile/*"
+
+# List production tags
+git tag -l "krow-withus-*-mobile/prod-*"
+```
+
+## 4. GitHub Actions Workflows
+
+### 4.1 Product Release Workflow
+
+**File:** `.github/workflows/product-release.yml`
+
+**Purpose:** Automated production releases with APK signing
+
+**Trigger:** Manual dispatch via GitHub UI
+
+**Inputs:**
+- `app`: Select `worker` (staff) or `client`
+- `environment`: Select `dev`, `stage`, or `prod`
+
+**Process:**
+1. ✅ Extracts version from `pubspec.yaml` automatically
+2. ✅ Builds signed APKs for selected app
+3. ✅ Creates GitHub release with CHANGELOG notes
+4. ✅ Tags release (e.g., `krow-withus-worker-mobile/dev-v0.0.1-m4`)
+5. ✅ Uploads APKs as release assets
+6. ✅ Generates step summary with emojis
+
+**Key Features:**
+- **No manual version input** - reads from pubspec.yaml
+- **APK signing** - uses GitHub Secrets for keystore
+- **CHANGELOG extraction** - pulls release notes automatically
+- **Visual feedback** - emojis in all steps
+
+**Usage:**
+```
+1. Go to: GitHub Actions → "📦 Product Release"
+2. Click "Run workflow"
+3. Select app (worker/client)
+4. Select environment (dev/stage/prod)
+5. Click "Run workflow"
+6. Wait for completion (~5-10 minutes)
+```
+
+**Release Naming:**
+```
+Krow With Us - Worker Product - DEV - v0.0.1-m4
+Krow With Us - Client Product - PROD - v1.0.0
+```
+
+### 4.2 Product Hotfix Workflow
+
+**File:** `.github/workflows/hotfix-branch-creation.yml`
+
+**Purpose:** Emergency production fix automation
+
+**Trigger:** Manual dispatch with version input
+
+**Inputs:**
+- `current_version`: Current production version (e.g., `0.0.1-m4`)
+- `issue_description`: Brief description of the hotfix
+
+**Process:**
+1. ✅ Creates `hotfix/<version>` branch from latest production tag
+2. ✅ Auto-increments PATCH version (e.g., `0.0.1-m4` → `0.0.2-m4`)
+3. ✅ Updates `pubspec.yaml` with new version
+4. ✅ Updates `CHANGELOG.md` with hotfix section
+5. ✅ Creates PR back to main branch
+6. ✅ Includes hotfix instructions in PR description
+
+**Usage:**
+```
+1. Go to: GitHub Actions → "🚨 Product Hotfix - Create Branch"
+2. Click "Run workflow"
+3. Enter current production version (e.g., 0.0.1-m4)
+4. Enter issue description (e.g., "critical crash on login")
+5. Click "Run workflow"
+6. Workflow creates branch and PR
+7. Fix bug on hotfix branch
+8. Merge PR to main
+9. Use Product Release workflow to deploy
+```
+
+**Hotfix Branch Naming:**
+```
+hotfix/0.0.2-m4-critical-crash-on-login
+```
+
+### 4.3 Helper Scripts
+
+**Location:** `.github/scripts/`
+
+**Available Scripts:**
+1. **extract-version.sh** - Extract version from pubspec.yaml
+2. **generate-tag-name.sh** - Generate standardized tag names
+3. **extract-release-notes.sh** - Extract CHANGELOG sections
+4. **create-release-summary.sh** - Generate GitHub Step Summary with emojis
+
+**Script Permissions:**
+```bash
+chmod +x .github/scripts/*.sh
+```
+
+**Usage Example:**
+```bash
+# Extract version from staff app
+.github/scripts/extract-version.sh apps/mobile/apps/staff/pubspec.yaml
+
+# Generate tag name
+.github/scripts/generate-tag-name.sh worker dev 0.0.1-m4
+
+# Extract release notes for version
+.github/scripts/extract-release-notes.sh apps/mobile/apps/staff/CHANGELOG.md 0.0.1-m4
+```
+
+## 5. APK Signing Setup
+
+### Required GitHub Secrets (24 Total)
+
+**Per App (12 secrets each):**
+
+**Staff (Worker) App:**
+```
+STAFF_UPLOAD_KEYSTORE_BASE64       # Base64-encoded keystore file
+STAFF_UPLOAD_STORE_PASSWORD        # Keystore password
+STAFF_UPLOAD_KEY_ALIAS             # Key alias
+STAFF_UPLOAD_KEY_PASSWORD          # Key password
+STAFF_KEYSTORE_PROPERTIES_BASE64   # Base64-encoded key.properties file
+```
+
+**Client App:**
+```
+CLIENT_UPLOAD_KEYSTORE_BASE64
+CLIENT_UPLOAD_STORE_PASSWORD
+CLIENT_UPLOAD_KEY_ALIAS
+CLIENT_UPLOAD_KEY_PASSWORD
+CLIENT_KEYSTORE_PROPERTIES_BASE64
+```
+
+### Generating Secrets
+
+**Step 1: Create Keystore**
+
+```bash
+# For staff app
+keytool -genkey -v \
+  -keystore staff-upload-keystore.jks \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 10000 \
+  -alias staff-upload
+
+# For client app
+keytool -genkey -v \
+  -keystore client-upload-keystore.jks \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 10000 \
+  -alias client-upload
+```
+
+**Step 2: Base64 Encode**
+
+```bash
+# Encode keystore
+base64 -i staff-upload-keystore.jks | tr -d '\n' > staff-keystore.txt
+
+# Encode key.properties
+base64 -i key.properties | tr -d '\n' > key-props.txt
+```
+
+**Step 3: Add to GitHub Secrets**
+
+```
+Repository → Settings → Secrets and variables → Actions → New repository secret
+```
+
+Add each secret:
+- Name: `STAFF_UPLOAD_KEYSTORE_BASE64`
+- Value: Contents of `staff-keystore.txt`
+
+Repeat for all 24 secrets.
+
+### key.properties Format
+
+```properties
+storePassword=your_store_password
+keyPassword=your_key_password
+keyAlias=staff-upload
+storeFile=../staff-upload-keystore.jks
+```
+
+## 6. Release Process (Step-by-Step)
+
+### Standard Release (Dev/Stage/Prod)
+
+**Step 1: Prepare CHANGELOG**
+
+Update `CHANGELOG.md` with all changes since last release:
+```markdown
+## [0.1.0-m5] - Milestone 5 - 2026-03-15
+
+### Added
+- Shift calendar with month/week views
+- Enhanced navigation with typed routes
+- Profile completion wizard
+
+### Fixed
+- Session token refresh timing
+- Navigation fallback logic
+```
+
+**Step 2: Update Version**
+
+Edit `pubspec.yaml`:
+```yaml
+version: 0.1.0-m5+1  # Changed from 0.0.1-m4+1
+```
+
+**Step 3: Commit and Push**
+
+```bash
+git add apps/mobile/apps/staff/CHANGELOG.md
+git add apps/mobile/apps/staff/pubspec.yaml
+git commit -m "chore(staff): prepare v0.1.0-m5 release"
+git push origin dev
+```
+
+**Step 4: Trigger Workflow**
+
+1. Go to GitHub Actions → "📦 Product Release"
+2. Click "Run workflow"
+3. Select branch: `dev`
+4. Select app: `worker` (or `client`)
+5. Select environment: `dev` (or `stage`, `prod`)
+6. Click "Run workflow"
+
+**Step 5: Monitor Progress**
+
+Watch workflow execution:
+- ⏳ Version extraction
+- ⏳ APK building
+- ⏳ APK signing
+- ⏳ GitHub Release creation
+- ⏳ Tag creation
+- ⏳ Asset upload
+
+**Step 6: Verify Release**
+
+1. Check GitHub Releases page
+2. Download APK to verify
+3. Install on test device
+4. Verify version in app
+
+### Hotfix Release
+
+**Step 1: Identify Production Issue**
+
+- Critical bug in production
+- User-reported crash
+- Security vulnerability
+
+**Step 2: Trigger Hotfix Workflow**
+
+1. Go to GitHub Actions → "🚨 Product Hotfix - Create Branch"
+2. Click "Run workflow"
+3. Enter current version: `0.0.1-m4`
+4. Enter description: `Critical crash on login screen`
+5. Click "Run workflow"
+
+**Step 3: Review Created Branch**
+
+Workflow creates:
+- Branch: `hotfix/0.0.2-m4-critical-crash-on-login`
+- PR to `main` branch
+- Updated `pubspec.yaml`: `0.0.2-m4+1`
+- Updated `CHANGELOG.md` with hotfix section
+
+**Step 4: Fix Bug**
+
+```bash
+git checkout hotfix/0.0.2-m4-critical-crash-on-login
+
+# Make fixes
+# ... code changes ...
+
+git add .
+git commit -m "fix(auth): resolve crash on login screen"
+git push origin hotfix/0.0.2-m4-critical-crash-on-login
+```
+
+**Step 5: Merge PR**
+
+1. Review PR on GitHub
+2. Approve and merge to `main`
+3. Delete hotfix branch
+
+**Step 6: Release to Production**
+
+1. Use Product Release workflow
+2. Select `main` branch
+3. Select `prod` environment
+4. Deploy hotfix
+
+## 7. Release Cadence
+
+### Development (dev)
+
+- **Frequency:** Multiple times per day
+- **Purpose:** Testing features in dev environment
+- **Branch:** `dev`
+- **Audience:** Internal development team
+- **Approval:** Not required
+
+### Staging (stage)
+
+- **Frequency:** 1-2 times per week
+- **Purpose:** QA testing, stakeholder demos
+- **Branch:** `main`
+- **Audience:** QA team, stakeholders
+- **Approval:** Tech lead approval
+
+### Production (prod)
+
+- **Frequency:** Every 2-3 weeks (milestone completion)
+- **Purpose:** End-user releases
+- **Branch:** `main`
+- **Audience:** All users
+- **Approval:** Product owner + tech lead approval
+
+### Milestone Releases
+
+- **Frequency:** Every 2-4 weeks
+- **Version Bump:** Minor version (e.g., `0.1.0-m5` → `0.2.0-m6`)
+- **Process:**
+  1. Complete all milestone features
+  2. Update CHANGELOG with comprehensive release notes
+  3. Deploy to stage for final QA
+  4. After approval, deploy to prod
+  5. Create GitHub release with milestone summary
+
+## 8. Troubleshooting
+
+### Workflow Fails: Version Extraction
+
+**Error:** "Could not extract version from pubspec.yaml"
+
+**Solutions:**
+1. Verify `pubspec.yaml` exists at expected path
+2. Check version format: `version: X.Y.Z-mN+B`
+3. Ensure no extra spaces or tabs
+4. Verify file is committed and pushed
+
+### Workflow Fails: APK Signing
+
+**Error:** "Keystore password incorrect"
+
+**Solutions:**
+1. Verify GitHub Secrets are set correctly
+2. Re-generate and re-encode keystore
+3. Check key.properties format
+4. Ensure passwords don't contain special characters that need escaping
+
+### Workflow Fails: CHANGELOG Extraction
+
+**Error:** "Could not find version in CHANGELOG"
+
+**Solutions:**
+1. Verify CHANGELOG format matches: `## [X.Y.Z-mN] - Milestone N - YYYY-MM-DD`
+2. Check square brackets are present
+3. Ensure version matches pubspec.yaml
+4. Add version section if missing
+
+### Tag Already Exists
+
+**Error:** "tag already exists"
+
+**Solutions:**
+1. Delete existing tag locally and remotely:
+```bash
+git tag -d krow-withus-worker-mobile/dev-v0.0.1-m4
+git push origin :refs/tags/krow-withus-worker-mobile/dev-v0.0.1-m4
+```
+2. Re-run workflow
+
+### Build Fails: Flutter Errors
+
+**Error:** "flutter build failed"
+
+**Solutions:**
+1. Test build locally first:
+```bash
+cd apps/mobile/apps/staff
+flutter build apk --release
+```
+2. Fix any analyzer errors
+3. Ensure all dependencies are compatible
+4. Clear build cache:
+```bash
+flutter clean
+flutter pub get
+```
+
+## 9. Local Testing
+
+Before triggering workflows, test builds locally:
+
+### Building APKs Locally
+
+**Staff App:**
+```bash
+cd apps/mobile/apps/staff
+flutter clean
+flutter pub get
+flutter build apk --release
+```
+
+**Client App:**
+```bash
+cd apps/mobile/apps/client
+flutter clean
+flutter pub get
+flutter build apk --release
+```
+
+### Testing Release Notes
+
+Extract CHANGELOG section:
+```bash
+.github/scripts/extract-release-notes.sh \
+  apps/mobile/apps/staff/CHANGELOG.md \
+  0.0.1-m4
+```
+
+### Verifying Version
+
+Extract version from pubspec:
+```bash
+.github/scripts/extract-version.sh \
+  apps/mobile/apps/staff/pubspec.yaml
+```
+
+## 10. Best Practices
+
+### CHANGELOG
+- ✅ Update continuously during development
+- ✅ Be specific and user-focused
+- ✅ Group related changes
+- ✅ Include UI/UX changes
+- ❌ Don't include technical debt or refactoring (unless user-facing)
+- ❌ Don't use vague descriptions
+
+### Versioning
+- ✅ Use semantic versioning strictly
+- ✅ Increment patch for bug fixes
+- ✅ Increment minor for new features
+- ✅ Keep milestone suffix until production
+- ❌ Don't skip versions
+- ❌ Don't use arbitrary version numbers
+
+### Git Tags
+- ✅ Follow standard format
+- ✅ Let workflow create tags automatically
+- ✅ Keep tags synced with releases
+- ❌ Don't create tags manually unless necessary
+- ❌ Don't reuse deleted tags
+
+### Workflows
+- ✅ Test builds locally first
+- ✅ Monitor workflow execution
+- ✅ Verify release assets
+- ✅ Test APK on device before announcing
+- ❌ Don't trigger multiple workflows simultaneously
+- ❌ Don't bypass approval process
+
+## Summary
+
+**Release Process Overview:**
+1. Update CHANGELOG with changes
+2. Update version in pubspec.yaml
+3. Commit and push to appropriate branch
+4. Trigger Product Release workflow
+5. Monitor execution and verify release
+6. Test APK on device
+7. Announce to team/users
+
+**Key Files:**
+- `apps/mobile/apps/staff/CHANGELOG.md`
+- `apps/mobile/apps/client/CHANGELOG.md`
+- `apps/mobile/apps/staff/pubspec.yaml`
+- `apps/mobile/apps/client/pubspec.yaml`
+
+**Key Workflows:**
+- Product Release (standard releases)
+- Product Hotfix (emergency fixes)
+
+**For Complete Details:**
+See [`docs/RELEASE/mobile-releases.md`](docs/RELEASE/mobile-releases.md) - 900+ line comprehensive guide with:
+- Detailed APK signing setup
+- Complete troubleshooting guide
+- All helper scripts documentation
+- Release checklist
+- Security best practices
+
+When in doubt, refer to the comprehensive documentation or ask for clarification before releasing to production.

.claude/skills/krow-paper-design/SKILL.md

@@ -0,0 +1,413 @@
+---
+name: krow-paper-design
+description: KROW Paper design file conventions covering design tokens, component patterns, screen structure, and naming rules. Use this when creating or updating screens in the Paper design tool, auditing designs for token compliance, building new flows, or restructuring existing frames. Ensures visual consistency across all Paper design files for the KROW staff and client apps.
+---
+
+# KROW Paper Design Conventions
+
+This skill defines the design token system, component patterns, screen structure conventions, and workflow rules established for the KROW Design Revamp Paper file. All design work in Paper must follow these conventions.
+
+## When to Use This Skill
+
+- Creating new screens or flows in Paper
+- Updating existing frames to match the design system
+- Auditing designs for token compliance
+- Adding components (buttons, chips, inputs, badges, cards)
+- Structuring shift detail pages, onboarding flows, or list screens
+- Setting up navigation patterns (back buttons, bottom nav, CTAs)
+- Reviewing Paper designs before handoff to development
+
+## 1. Design Tokens
+
+### Color Palette
+
+| Token | Hex | Usage |
+|-------|-----|-------|
+| Primary | `#0A39DF` | CTAs, active states, links, selected chips, nav active icons, pay rates |
+| Foreground | `#121826` | Headings, primary text, dark UI elements |
+| Text Secondary | `#6A7382` | Labels, captions, inactive nav, section headers, placeholder text, back chevrons |
+| Secondary BG | `#F1F3F5` | Subtle backgrounds, dividers, map placeholders |
+| Border | `#D1D5DB` | Card borders, unselected chip borders, outline button borders |
+| Input Border | `#E2E8F0` | Text input borders (lighter than general border) |
+| Destructive | `#F04444` | Error states, destructive actions (e.g., Request Swap) |
+| Background | `#FAFBFC` | Page/artboard background |
+| Card BG | `#FFFFFF` | Card surfaces, input backgrounds |
+| Success | `#059669` | Active status dot, checkmark icons, requirement met |
+| Warning Amber | `#D97706` | Urgent/Pending badge text |
+
+### Semantic Badge Colors
+
+| Badge | Background | Text Color |
+|-------|-----------|------------|
+| Active | `#ECFDF5` | `#059669` |
+| Confirmed | `#EBF0FF` | `#0A39DF` |
+| Pending | `#FEF9EE` | `#D97706` |
+| Urgent | `#FEF9EE` | `#D97706` |
+| One-Time | `#ECFDF5` | `#059669` |
+| Recurring | `#EBF0FF` | `#0A39DF` (use `#EFF6FF` bg on detail pages) |
+
+### Typography
+
+| Style | Font | Size | Weight | Line Height | Usage |
+|-------|------|------|--------|-------------|-------|
+| Display | Inter Tight | 28px | 700 | 34px | Page titles (Find Shifts, My Shifts) |
+| H1 | Inter Tight | 24px | 700 | 30px | Detail page titles (venue names) |
+| H2 | Inter Tight | 20px | 700 | 26px | Section headings |
+| H3 | Inter Tight | 18px | 700 | 22px | Card titles, schedule values |
+| Body Large | Manrope | 16px | 600 | 20px | Button text, CTA labels |
+| Body Default | Manrope | 14px | 400-500 | 18px | Body text, descriptions |
+| Body Small | Manrope | 13px | 400-500 | 16px | Card metadata, time/pay info |
+| Caption | Manrope | 12px | 500-600 | 16px | Small chip text, tab labels |
+| Section Label | Manrope | 11px | 700 | 14px | Uppercase section headers (letter-spacing: 0.06em) |
+| Badge Text | Manrope | 11px | 600-700 | 14px | Status badge labels (letter-spacing: 0.04em) |
+| Nav Label | Manrope | 10px | 600 | 12px | Bottom nav labels |
+
+### Spacing
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| Page padding | 24px | Horizontal padding from screen edge |
+| Section gap | 16-24px | Between major content sections |
+| Group gap | 8-12px | Within a section (e.g., label to input) |
+| Element gap | 4px | Tight spacing (e.g., subtitle under title) |
+| Bottom safe area | 40px | Padding below last element / CTA |
+
+### Border Radii
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| sm | 8px | Small chips, badges, status pills, map placeholder |
+| md | 12px | Cards, inputs, location cards, contact cards, search fields |
+| lg | 14px | Buttons, CTA containers, shift cards (Find Shifts) |
+| xl | 24px | Not commonly used |
+| pill | 999px | Progress bar segments only |
+
+## 2. Component Patterns
+
+### Buttons
+
+**Primary CTA:**
+- Background: `#0A39DF`, radius: 14px, height: 52px
+- Text: Manrope 16px/600, color: `#FFFFFF`
+- Padding: 16px vertical, 16px horizontal
+
+**Secondary/Outline Button:**
+- Background: `#FFFFFF`, border: 1.5px `#D1D5DB`, radius: 14px, height: 52px
+- Text: Manrope 16px/600, color: `#121826`
+
+**Destructive Outline Button:**
+- Background: `#FFFFFF`, border: 1.5px `#F04444`, radius: 14px
+- Text: Manrope 14px/600, color: `#F04444`
+
+**Back Icon Button (Bottom CTA):**
+- 52x52px square, border: 1.5px `#D1D5DB`, radius: 14px, background: `#FFFFFF`
+- Contains chevron-left SVG (20x20, viewBox 0 0 24 24, stroke `#121826`, strokeWidth 2)
+- Path: `M15 18L9 12L15 6`
+
+### Chips
+
+**Default (Large) - for role/skill selection:**
+- Selected: bg `#EFF6FF`, border 1.5px `#0A39DF`, radius 10px, padding 12px/16px
+  - Checkmark icon (14x14, stroke `#0A39DF`), text Manrope 14px/600 `#0A39DF`
+- Unselected: bg `#FFFFFF`, border 1.5px `#6A7382`, radius 10px, padding 12px/16px
+  - Text Manrope 14px/500 `#6A7382`
+
+**Small - for tabs, filters:**
+- Selected: bg `#EFF6FF`, border 1.5px `#0A39DF`, radius 8px, padding 6px/12px
+  - Checkmark icon (12x12), text Manrope 12px/600 `#0A39DF`
+- Unselected: bg `#FFFFFF`, border 1.5px `#D1D5DB`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/500 `#6A7382`
+- Active (filled): bg `#0A39DF`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/600 `#FFFFFF`
+- Dark (filters button): bg `#121826`, radius 8px, padding 6px/12px
+  - Text Manrope 12px/600 `#FFFFFF`, with leading icon
+
+**Status Badges:**
+- Radius: 8px, padding: 4px/8px
+- Text: Manrope 11px/600-700, uppercase, letter-spacing 0.04em
+- Colors follow semantic badge table above
+
+### Text Inputs
+
+- Border: 1.5px `#E2E8F0`, radius: 12px, padding: 12px/14px
+- Background: `#FFFFFF`
+- Placeholder: Manrope 14px/400, color `#6A7382`
+- Filled: Manrope 14px/500, color `#121826`
+- Label above: Manrope 14px/500, color `#121826`
+- Focused: border color `#0A39DF`, border-width 2px
+- Error: border color `#F04444`, helper text `#F04444`
+
+### Cards (Shift List Items)
+
+- Background: `#FFFFFF`, border: 1px `#D1D5DB`, radius: 12-14px
+- Padding: 16px
+- Content: venue name (Manrope 15px/600 `#121826`), subtitle (Manrope 13px/400 `#6A7382`)
+- Metadata row: icon (14px, `#6A7382`) + text (Manrope 13px/500 `#6A7382`)
+- Pay rate: Inter Tight 18px/700 `#0A39DF`
+
+### Schedule/Pay Info Cards
+
+- Two-column layout with 12px gap
+- Background: `#FFFFFF`, border: 1px `#D1D5DB`, radius: 12px, padding: 16px
+- Label: Manrope 11px/500-700 uppercase `#6A7382` (letter-spacing 0.05em)
+- Value: Inter Tight 18px/700 `#121826` (schedule) or `#121826` (pay)
+- Sub-text: Manrope 13px/400 `#6A7382`
+
+### Contact/Info Rows
+
+- Container: radius 12px, border 1px `#D1D5DB`, background `#FFFFFF`, overflow clip
+- Row: padding 13px/16px, gap 10px, border-bottom 1px `#F1F3F5` (except last)
+- Icon: 16px, stroke `#6A7382`
+- Label: Manrope 13px/500 `#6A7382`, width 72px fixed
+- Value: Manrope 13px/500 `#121826` (or `#0A39DF` for phone/links)
+
+### Section Headers
+
+- Text: Manrope 11px/700, uppercase, letter-spacing 0.06em, color `#6A7382`
+- Gap to content below: 10px
+
+## 3. Screen Structure
+
+### Artboard Setup
+
+- Width: 390px (iPhone standard)
+- Height: 844px (default), or `fit-content` for scrollable detail pages
+- Background: `#FAFBFC`
+- Flex column layout, overflow: clip
+
+### Frame Naming Convention
+
+```
+<app>-<section>-<screen_number>-<screen_name>
+```
+
+Examples:
+- `staff-1-1-splash`
+- `staff-2-3-personal-information`
+- `staff-4-1-my-shifts`
+- `staff-5-2-shift-details`
+- `shift-5-3-confirmation`
+
+Section headers use: `<number> - <Section Name>` (e.g., `4 - My Shifts`)
+
+### Status Bar
+
+- Height: 44px, full width (390px)
+- Left: "9:41" text (system font)
+- Right: Signal, WiFi, Battery SVG icons (68px wide)
+
+### Header Back Button
+
+- Placed below status bar in a combined "Status Bar + Back" frame (390x72px)
+- Chevron SVG: 20x20, viewBox 0 0 24 24, stroke `#6A7382`, strokeWidth 2
+- Path: `M15 18L9 12L15 6`
+- Back button frame: 390x28px, padding-left: 24px
+
+### Progress Bar (Onboarding)
+
+- Container: 342px wide (24px margins), 3px height segments
+- Segments: pill radius (999px), gap between
+- Filled: `#0A39DF`, Unfilled: `#F1F3F5`
+
+### Bottom CTA Convention
+
+- Pinned to bottom using `marginTop: auto` on the CTA container
+- Layout: flex row, gap 12px, padding 0 24px
+- Back button: 52x52px icon-only button with chevron-left (stroke `#121826`)
+- Primary CTA: flex 1, height 52px, radius 14px, bg `#0A39DF`
+- Bottom safe padding: 40px (on artboard paddingBottom)
+
+### Bottom Navigation Bar
+
+- Full width, padding: 10px top, 28px bottom
+- Border-top: 1px `#F1F3F5`, background: `#FFFFFF`
+- 5 items: Home, Shifts, Find, Payments, Profile
+- Active: icon stroke `#0A39DF`, label Manrope 10px/600 `#0A39DF`
+- Inactive: icon stroke `#6A7382`, label Manrope 10px/600 `#6A7382`
+- Active icon may have light fill (e.g., `#EBF0FF` on calendar/search)
+
+## 4. Screen Templates
+
+### List Screen (My Shifts, Find Shifts)
+
+```
+Artboard (390x844, bg #FAFBFC)
+  Status Bar (390x44)
+  Header Section
+    Page Title (Display: Inter Tight 28px/700)
+    Tab/Filter Chips (Small chip variant)
+  Content
+    Date Header (Section label style, uppercase)
+    Shift Cards (12px radius, 1px border #D1D5DB)
+  Bottom Nav Bar
+```
+
+### Detail Screen (Shift Details)
+
+```
+Artboard (390x fit-content, bg #FAFBFC)
+  Status Bar (390x44)
+  Header Bar (Back chevron + "Shift Details" title + share icon)
+  Badges Row (status chips)
+  Role Title (H1) + Venue (with avatar)
+  Schedule/Pay Cards (two-column)
+  Job Description (section label + body text)
+  Location (card with map + address)
+  Requirements (section label + checkmark list)
+  Shift Contact (section label + contact card with rows)
+  [Optional] Note from Manager (warm bg card)
+  Bottom CTA (pinned)
+```
+
+### Onboarding Screen
+
+```
+Artboard (390x844, bg #FAFBFC, justify: flex-start, paddingBottom: 40px)
+  Status Bar + Back (390x72)
+  Progress Bar (342px, 3px segments)
+  Step Counter ("Step X of Y" - Body Small)
+  Page Title (H1: Inter Tight 24px/700)
+  [Optional] Subtitle (Body Default)
+  Form Content (inputs, chips, sliders)
+  Bottom CTA (marginTop: auto - back icon + Continue)
+```
+
+### Confirmation Screen
+
+```
+Artboard (390x844, bg #FAFBFC)
+  Status Bar
+  Centered Content
+    Success Icon (green circle + checkmark)
+    Title (Display: Inter Tight 26px/700, centered)
+    Subtitle (Body Default, centered, #6A7382)
+    Details Card (border #D1D5DB, rows with label/value pairs)
+  Bottom CTAs (primary + outline)
+```
+
+## 5. Workflow Rules
+
+### Write Incrementally
+
+Each `write_html` call should produce ONE visual group:
+- A header, a card, a single list row, a button bar, a section
+- Never batch an entire screen in one call
+
+### Review Checkpoints
+
+After every 2-3 modifications, take a screenshot and evaluate:
+- **Spacing**: Uneven gaps, cramped groups
+- **Typography**: Hierarchy, readability, correct font/weight
+- **Contrast**: Text legibility, element distinction
+- **Alignment**: Vertical lanes, horizontal alignment
+- **Clipping**: Content cut off at edges
+- **Token compliance**: All values match design system tokens
+
+### Color Audit Process
+
+When updating frames to match the design system:
+1. Get computed styles for all text, background, border elements
+2. Map old colors to design system tokens:
+   - Dark navy (`#0F4C81`, `#1A3A5C`) -> Primary `#0A39DF`
+   - Near-black (`#111827`, `#0F172A`) -> Foreground `#121826`
+   - Gray variants (`#94A3B8`, `#64748B`, `#475569`) -> Text Secondary `#6A7382`
+   - Green accents (`#20B486`) -> Primary `#0A39DF` (for pay) or `#059669` (for status)
+3. Batch update using `update_styles` with multiple nodeIds per style change
+4. Verify with screenshots
+
+### Structural Consistency
+
+When creating matching screens (e.g., two shift detail views):
+- Use identical section ordering
+- Match section header styles (11px/700 uppercase `#6A7382`)
+- Use same card/row component patterns
+- Maintain consistent padding and gap values
+
+## 6. SVG Icon Patterns
+
+### Chevron Left (Back)
+```html
+<svg width="20" height="20" viewBox="0 0 24 24" fill="none">
+  <path d="M15 18L9 12L15 6" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Map Pin
+```html
+<svg width="18" height="18" viewBox="0 0 24 24" fill="none">
+  <path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="12" cy="10" r="3" stroke="#6A7382" stroke-width="2"/>
+</svg>
+```
+
+### User (Supervisor)
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="12" cy="7" r="4" stroke="#6A7382" stroke-width="2"/>
+</svg>
+```
+
+### Phone
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72c.127.96.361 1.903.7 2.81a2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45c.907.339 1.85.573 2.81.7A2 2 0 0 1 22 16.92z" stroke="#6A7382" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Checkmark (Requirement Met)
+```html
+<svg width="16" height="16" viewBox="0 0 24 24" fill="none">
+  <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M22 4L12 14.01l-3-3" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+### Chip Checkmark
+```html
+<!-- Large chip (14x14) -->
+<svg width="14" height="14" viewBox="0 0 14 14" fill="none">
+  <path d="M2.5 7L5.5 10L11.5 4" stroke="#0A39DF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+
+<!-- Small chip (12x12) -->
+<svg width="12" height="12" viewBox="0 0 14 14" fill="none">
+  <path d="M2.5 7L5.5 10L11.5 4" stroke="#0A39DF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+```
+
+## 7. Anti-Patterns
+
+### Colors
+- Never use `#0F4C81`, `#1A3A5C` (old navy) - use `#0A39DF` (Primary)
+- Never use `#111827`, `#0F172A` - use `#121826` (Foreground)
+- Never use `#94A3B8`, `#64748B`, `#475569` - use `#6A7382` (Text Secondary)
+- Never use `#20B486` for pay rates - use `#0A39DF` (Primary)
+- Never use `#E2E8F0` for card borders - use `#D1D5DB` (Border)
+
+### Components
+- Never use pill radius (999px) for chips or badges - use 8px or 10px
+- Never use gradient backgrounds on buttons
+- Never mix font families within a role (headings = Inter Tight, body = Manrope)
+- Never place back buttons at the bottom of frames - always after status bar
+- Never hardcode CTA position - use `marginTop: auto` for bottom pinning
+
+### Structure
+- Never batch an entire screen in one `write_html` call
+- Never skip review checkpoints after 2-3 modifications
+- Never create frames without following the naming convention
+- Never use `justifyContent: space-between` on artboards with many direct children - use `marginTop: auto` on the CTA instead
+
+## Summary
+
+**The design file is the source of truth for visual direction.** Every element must use the established tokens:
+
+1. **Colors**: 7 core tokens + semantic badge colors
+2. **Typography**: Inter Tight (headings) + Manrope (body), defined scale
+3. **Spacing**: 24px page padding, 16-24px section gaps, 40px bottom safe area
+4. **Radii**: 8px (chips/badges), 12px (cards/inputs), 14px (buttons/CTAs)
+5. **Components**: Buttons, chips (large/small), inputs, cards, badges, nav bars
+6. **Structure**: Status bar > Back > Content > Bottom CTA (pinned)
+7. **Naming**: `<app>-<section>-<number>-<name>`
+
+When in doubt, screenshot an existing screen and match its patterns exactly.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,99 @@
+## 📋 Description
+
+<!-- Provide a clear and concise description of your changes -->
+
+---
+
+## 🔗 Related Issues
+
+<!-- Link any related issues using #issue_number -->
+
+Closes #
+Related to #
+
+---
+
+## 🎯 Type of Change
+
+<!-- Mark the relevant option with an "x" -->
+
+- [ ] 🐛 **Bug fix** (non-breaking change that fixes an issue)
+- [ ] ✨ **Feature** (non-breaking change that adds functionality)
+- [ ] 📝 **Documentation** (changes to docs, comments, or README)
+- [ ] 🔧 **Refactor** (code change that doesn't affect functionality)
+- [ ] ⚡ **Performance** (improvement in performance or optimization)
+- [ ] 🔐 **Security** (security fix or improvement)
+- [ ] 🎨 **Style** (formatting, linting, or minor code style changes)
+- [ ] 🏗️ **Architecture** (significant structural changes)
+
+---
+
+## 📦 Affected Areas
+
+<!-- Mark the relevant areas that were modified -->
+
+- [ ] 📱 **Mobile** (Flutter - Client/Worker app)
+- [ ] 🌐 **Web** (React Dashboard)
+- [ ] 🔌 **Backend** (APIs, Data Connect, Cloud Functions)
+- [ ] 🗄️ **Database** (Schema changes, migrations)
+- [ ] 🚀 **CI/CD** (GitHub Actions, deployment configs)
+- [ ] 📚 **Documentation** (Docs, onboarding guides)
+
+---
+
+## ✅ Testing
+
+<!-- Describe how you tested these changes -->
+
+**Test Details:**
+<!-- Provide specific test cases or scenarios -->
+
+
+---
+
+## 🔄 Breaking Changes
+
+<!-- Are there any breaking changes? If yes, describe them -->
+
+- [ ] No breaking changes
+- [ ] Yes, breaking changes:
+
+**Details:**
+<!-- Describe migration path or deprecation period if applicable -->
+
+
+---
+
+## 🎯 Checklist
+
+<!-- Complete this before requesting review -->
+
+- [ ] Code follows project style guidelines
+- [ ] Self-review completed
+- [ ] Comments added for complex logic
+- [ ] Documentation updated (if applicable)
+- [ ] No new console warnings/errors
+- [ ] Tests pass locally
+- [ ] Branch is up-to-date with `dev`
+- [ ] Commit messages are clear and descriptive
+- [ ] Sensitive data is not committed
+- [ ] Environment variables documented (if added)
+
+---
+
+## 📝 Additional Notes
+
+<!-- Any additional context, decisions, or considerations -->
+
+
+---
+
+## 🔍 Review Checklist for Maintainers
+
+- [ ] Code quality and readability
+- [ ] Design patterns follow project conventions
+- [ ] Performance implications reviewed
+- [ ] Security concerns addressed
+- [ ] Documentation is complete
+- [ ] Breaking changes properly communicated
+- [ ] Cross-platform compatibility (if applicable)

.github/scripts/attach-apk-to-release.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+
+# =============================================================================
+# Attach APK to GitHub Release
+# =============================================================================
+# This script attaches a built APK to a GitHub Release with proper naming
+#
+# Usage:
+#   ./attach-apk-to-release.sh <tag_name> <app> <app_name> <version> <environment>
+#
+# Arguments:
+#   tag_name    - Git tag name (e.g., krow-withus-worker-mobile/dev-v0.1.0)
+#   app         - worker-mobile-app or client-mobile-app
+#   app_name    - staff or client (internal build folder name)
+#   version     - Version number (e.g., 0.1.0)
+#   environment - dev, stage, or prod
+#
+# Environment Variables:
+#   GH_TOKEN - GitHub token for gh CLI authentication
+# =============================================================================
+
+set -e
+
+TAG_NAME="$1"
+APP="$2"
+APP_NAME="$3"
+VERSION="$4"
+ENV="$5"
+
+if [ -z "$TAG_NAME" ] || [ -z "$APP" ] || [ -z "$APP_NAME" ] || [ -z "$VERSION" ] || [ -z "$ENV" ]; then
+    echo "❌ Error: Missing required arguments" >&2
+    echo "Usage: $0 <tag_name> <app> <app_name> <version> <environment>" >&2
+    exit 1
+fi
+
+# Find APK in build output
+APK_PATH="apps/mobile/apps/${APP_NAME}/build/app/outputs/flutter-apk/app-release.apk"
+
+if [ ! -f "$APK_PATH" ]; then
+    echo "❌ Error: APK not found at $APK_PATH" >&2
+    echo "Searching for APK files..." >&2
+    find apps/mobile/apps/${APP_NAME} -name "*.apk"
+    exit 1
+fi
+
+# Create proper APK name based on app type
+if [ "$APP" = "worker-mobile-app" ]; then
+    APK_NAME="krow-withus-worker-mobile-${ENV}-v${VERSION}.apk"
+else
+    APK_NAME="krow-withus-client-mobile-${ENV}-v${VERSION}.apk"
+fi
+
+# Copy APK with proper name
+cp "$APK_PATH" "/tmp/$APK_NAME"
+
+# Upload to GitHub Release
+echo "📤 Uploading $APK_NAME to release $TAG_NAME..." >&2
+gh release upload "$TAG_NAME" "/tmp/$APK_NAME" --clobber
+
+echo "✅ APK attached to release: $APK_NAME" >&2

.github/scripts/create-release-summary.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# Generate release summary for GitHub Actions
+# Usage: ./create-release-summary.sh <app> <environment> <version> <tag_name>
+
+set -e
+
+APP=$1
+ENV=$2
+VERSION=$3
+TAG_NAME=$4
+
+if [ -z "$APP" ] || [ -z "$ENV" ] || [ -z "$VERSION" ] || [ -z "$TAG_NAME" ]; then
+  echo "❌ Error: Missing required parameters"
+  echo "Usage: ./create-release-summary.sh <app> <environment> <version> <tag_name>"
+  exit 1
+fi
+
+# Determine display names
+if [ "$APP" = "worker-mobile-app" ]; then
+  APP_DISPLAY="Worker Product"
+  APP_EMOJI="👷"
+else
+  APP_DISPLAY="Client Product"
+  APP_EMOJI="💼"
+fi
+
+ENV_UPPER=$(echo "$ENV" | tr '[:lower:]' '[:upper:]')
+RELEASE_NAME="Krow With Us - ${APP_DISPLAY} - ${ENV_UPPER} - v${VERSION}"
+
+# Environment emoji
+case "$ENV" in
+  dev)
+    ENV_EMOJI="🔧"
+    ;;
+  stage)
+    ENV_EMOJI="🎭"
+    ;;
+  prod)
+    ENV_EMOJI="🚀"
+    ;;
+  *)
+    ENV_EMOJI="📦"
+    ;;
+esac
+
+# Generate summary
+cat << EOF >> $GITHUB_STEP_SUMMARY
+## 🎉 Release Created Successfully
+
+### ${APP_EMOJI} Application Details
+- **App:** ${APP_DISPLAY}
+- **Environment:** ${ENV_EMOJI} ${ENV_UPPER}
+- **Version:** \`${VERSION}\`
+- **Tag:** \`${TAG_NAME}\`
+
+### 📦 Release Information
+**Release Name:** ${RELEASE_NAME}
+
+### ✅ Next Steps
+
+1. 🔍 **Verify** the tag and release on GitHub
+2. 🏗️ **Trigger** CodeMagic build (if configured)
+3. 📱 **Monitor** app store deployment
+4. 📚 **Update** project documentation if needed
+5. 🎯 **Communicate** release to stakeholders
+
+### 🔗 Quick Links
+- [View Tag](../../releases/tag/${TAG_NAME})
+- [Release Documentation](../../docs/release/MOBILE_RELEASE_PLAN.md)
+- [CHANGELOG](../../apps/mobile/apps/${APP}/CHANGELOG.md)
+EOF
+
+echo "✅ Summary generated successfully"

.github/scripts/extract-release-notes.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# Extract release notes from CHANGELOG for a specific version
+# Usage: ./extract-release-notes.sh <app> <version> <environment> <tag_name> <output_file>
+
+set -e
+
+APP=$1
+VERSION=$2
+ENV=$3
+TAG_NAME=$4
+OUTPUT_FILE=$5
+
+if [ -z "$APP" ] || [ -z "$VERSION" ] || [ -z "$ENV" ] || [ -z "$TAG_NAME" ] || [ -z "$OUTPUT_FILE" ]; then
+  echo "❌ Error: Missing required parameters" >&2
+  echo "Usage: ./extract-release-notes.sh <app> <version> <environment> <tag_name> <output_file>" >&2
+  exit 1
+fi
+
+# Determine CHANGELOG path and app name
+if [ "$APP" = "worker-mobile-app" ]; then
+  CHANGELOG_PATH="apps/mobile/apps/staff/CHANGELOG.md"
+  APP_NAME="Staff Product (Worker)"
+else
+  CHANGELOG_PATH="apps/mobile/apps/client/CHANGELOG.md"
+  APP_NAME="Client Product"
+fi
+
+# Try to extract release notes for this version
+if [ -f "$CHANGELOG_PATH" ]; then
+  echo "📝 Found CHANGELOG at $CHANGELOG_PATH" >&2
+  
+  # Extract section for this version
+  # Look for ## [vVERSION] or ## [VERSION] and collect content until next ## [ header
+  # Try with 'v' prefix first (common format), then without
+  CHANGELOG_CONTENT=$(awk "/^## \[v${VERSION}\]/{flag=1; next} /^## \[/{flag=0} flag" "$CHANGELOG_PATH")
+  
+  # If still empty, try without 'v' prefix
+  if [ -z "$CHANGELOG_CONTENT" ]; then
+    CHANGELOG_CONTENT=$(awk "/^## \[${VERSION}\]/{flag=1; next} /^## \[/{flag=0} flag" "$CHANGELOG_PATH")
+  fi
+  
+  if [ -z "$CHANGELOG_CONTENT" ]; then
+    echo "⚠️ Warning: No CHANGELOG entry found for version $VERSION" >&2
+    NOTES="**Environment:** $ENV
+**Tag:** $TAG_NAME
+
+## What is new in this release
+
+⚠️ No CHANGELOG entry found for this version. Please update the CHANGELOG manually."
+  else
+    echo "✅ Extracted release notes for version $VERSION" >&2
+    NOTES="**Environment:** $ENV
+**Tag:** $TAG_NAME
+
+## What is new in this release
+
+$CHANGELOG_CONTENT"
+  fi
+else
+  echo "⚠️ Warning: CHANGELOG not found at $CHANGELOG_PATH" >&2
+  NOTES="**Environment:** $ENV
+**Tag:** $TAG_NAME
+
+## What is new in this release
+
+⚠️ CHANGELOG file not found at $CHANGELOG_PATH"
+fi
+
+# Save to output file
+echo "$NOTES" > "$OUTPUT_FILE"
+echo "✅ Release notes saved to $OUTPUT_FILE" >&2

.github/scripts/extract-version.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# Extract version from version file for products
+# Usage: ./extract-version.sh <app>
+# app: worker-mobile-app or client-mobile-app
+
+set -e
+
+APP=$1
+
+if [ -z "$APP" ]; then
+  echo "❌ Error: App parameter required (worker-mobile-app or client-mobile-app)" >&2
+  exit 1
+fi
+
+# Determine pubspec path
+if [ "$APP" = "worker-mobile-app" ]; then
+  PUBSPEC_PATH="apps/mobile/apps/staff/pubspec.yaml"
+  APP_NAME="Staff Product (Worker)"
+else
+  PUBSPEC_PATH="apps/mobile/apps/client/pubspec.yaml"
+  APP_NAME="Client Product"
+fi
+
+# Check if pubspec exists
+if [ ! -f "$PUBSPEC_PATH" ]; then
+  echo "❌ Error: pubspec.yaml not found at $PUBSPEC_PATH" >&2
+  echo "📁 Current directory: $(pwd)" >&2
+  echo "📂 Directory contents:" >&2
+  ls -la apps/mobile/apps/ 2>&1 | head -20 >&2
+  exit 1
+fi
+
+# Extract version (format: X.Y.Z+buildNumber or X.Y.Z-suffix)
+VERSION_LINE=$(grep "^version:" "$PUBSPEC_PATH")
+if [ -z "$VERSION_LINE" ]; then
+  echo "❌ Error: Could not find version in $PUBSPEC_PATH" >&2
+  exit 1
+fi
+
+# Extract full version including suffix/build number
+VERSION=$(echo "$VERSION_LINE" | sed 's/version: *//' | tr -d ' ')
+
+# Validate version format (X.Y.Z with optional +build or -suffix)
+# Use grep for better portability across different bash versions
+if ! echo "$VERSION" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+(\+[a-zA-Z0-9]+|-[a-zA-Z0-9]+)?$'; then
+  echo "❌ Error: Invalid version format in pubspec.yaml: $VERSION" >&2
+  echo "Expected format: X.Y.Z, X.Y.Z+build, or X.Y.Z-suffix (e.g., 0.1.0, 0.1.0+12, 0.1.0-m3)" >&2
+  exit 1
+fi
+
+echo "✅ Extracted version from $PUBSPEC_PATH: $VERSION" >&2
+echo "$VERSION"

.github/scripts/generate-tag-name.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Generate tag name for product release
+# Usage: ./generate-tag-name.sh <app> <environment> <version>
+
+set -e
+
+APP=$1
+ENV=$2
+VERSION=$3
+
+if [ -z "$APP" ] || [ -z "$ENV" ] || [ -z "$VERSION" ]; then
+  echo "❌ Error: Missing required parameters" >&2
+  echo "Usage: ./generate-tag-name.sh <app> <environment> <version>" >&2
+  exit 1
+fi
+
+# Strip -mobile-app suffix from app name for cleaner tag names
+# worker-mobile-app -> worker, client-mobile-app -> client
+APP_TAG=$(echo "$APP" | sed 's/-mobile-app$//')
+
+TAG_NAME="krow-withus-${APP_TAG}-mobile/${ENV}-v${VERSION}"
+echo "$TAG_NAME"

.github/scripts/setup-apk-signing.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+
+# =============================================================================
+# Setup APK Signing for GitHub Actions
+# =============================================================================
+# This script configures Android APK signing by decoding keystores from
+# GitHub Secrets and setting up environment variables for build.gradle.kts
+#
+# Usage:
+#   ./setup-apk-signing.sh <app> <environment> <temp_dir>
+#
+# Arguments:
+#   app         - worker-mobile-app or client-mobile-app
+#   environment - dev, stage, or prod
+#   temp_dir    - Temporary directory for keystore files (e.g., ${{ runner.temp }})
+#
+# Environment Variables (must be set):
+#   WORKER_KEYSTORE_DEV_BASE64, WORKER_KEYSTORE_STAGING_BASE64, WORKER_KEYSTORE_PROD_BASE64
+#   WORKER_KEYSTORE_PASSWORD_DEV, WORKER_KEYSTORE_PASSWORD_STAGING, WORKER_KEYSTORE_PASSWORD_PROD
+#   WORKER_KEY_ALIAS_DEV, WORKER_KEY_ALIAS_STAGING, WORKER_KEY_ALIAS_PROD
+#   WORKER_KEY_PASSWORD_DEV, WORKER_KEY_PASSWORD_STAGING, WORKER_KEY_PASSWORD_PROD
+#   CLIENT_KEYSTORE_DEV_BASE64, CLIENT_KEYSTORE_STAGING_BASE64, CLIENT_KEYSTORE_PROD_BASE64
+#   CLIENT_KEYSTORE_PASSWORD_DEV, CLIENT_KEYSTORE_PASSWORD_STAGING, CLIENT_KEYSTORE_PASSWORD_PROD
+#   CLIENT_KEY_ALIAS_DEV, CLIENT_KEY_ALIAS_STAGING, CLIENT_KEY_ALIAS_PROD
+#   CLIENT_KEY_PASSWORD_DEV, CLIENT_KEY_PASSWORD_STAGING, CLIENT_KEY_PASSWORD_PROD
+# =============================================================================
+
+set -e
+
+APP="$1"
+ENV="$2"
+TEMP_DIR="$3"
+
+if [ -z "$APP" ] || [ -z "$ENV" ] || [ -z "$TEMP_DIR" ]; then
+    echo "❌ Error: Missing required arguments" >&2
+    echo "Usage: $0 <app> <environment> <temp_dir>" >&2
+    exit 1
+fi
+
+echo "🔐 Setting up Android signing for $APP in $ENV environment..." >&2
+
+# Determine which keystore to use
+if [ "$APP" = "worker-mobile-app" ]; then
+    APP_TYPE="WORKER"
+    APP_NAME="STAFF"  # CodeMagic uses STAFF in env var names
+else
+    APP_TYPE="CLIENT"
+    APP_NAME="CLIENT"
+fi
+
+# Convert environment to uppercase for env var names
+ENV_UPPER=$(echo "$ENV" | tr '[:lower:]' '[:upper:]')
+if [ "$ENV_UPPER" = "STAGE" ]; then
+    ENV_UPPER="STAGING"  # CodeMagic uses STAGING instead of STAGE
+fi
+
+# Get the keystore secret name dynamically
+KEYSTORE_BASE64_VAR="${APP_TYPE}_KEYSTORE_${ENV_UPPER}_BASE64"
+KEYSTORE_PASSWORD_VAR="${APP_TYPE}_KEYSTORE_PASSWORD_${ENV_UPPER}"
+KEY_ALIAS_VAR="${APP_TYPE}_KEY_ALIAS_${ENV_UPPER}"
+KEY_PASSWORD_VAR="${APP_TYPE}_KEY_PASSWORD_${ENV_UPPER}"
+
+# Get values using indirect expansion
+KEYSTORE_BASE64="${!KEYSTORE_BASE64_VAR}"
+KEYSTORE_PASSWORD="${!KEYSTORE_PASSWORD_VAR}"
+KEY_ALIAS="${!KEY_ALIAS_VAR}"
+KEY_PASSWORD="${!KEY_PASSWORD_VAR}"
+
+# Check if secrets are configured
+if [ -z "$KEYSTORE_BASE64" ]; then
+    echo "⚠️  WARNING: Keystore secret $KEYSTORE_BASE64_VAR is not configured!" >&2
+    echo "⚠️  APK will be built UNSIGNED for $ENV environment." >&2
+    echo "⚠️  Please configure GitHub Secrets as documented in docs/RELEASE/APK_SIGNING_SETUP.md" >&2
+    exit 0
+fi
+
+# Create temporary directory for keystore
+KEYSTORE_DIR="${TEMP_DIR}/keystores"
+mkdir -p "$KEYSTORE_DIR"
+KEYSTORE_PATH="$KEYSTORE_DIR/release.jks"
+
+# Decode keystore from base64
+echo "$KEYSTORE_BASE64" | base64 -d > "$KEYSTORE_PATH"
+
+if [ ! -f "$KEYSTORE_PATH" ]; then
+    echo "❌ Failed to decode keystore!" >&2
+    exit 1
+fi
+
+echo "✅ Keystore decoded successfully" >&2
+echo "📦 Keystore size: $(ls -lh "$KEYSTORE_PATH" | awk '{print $5}')" >&2
+
+# Export environment variables for build.gradle.kts
+# Note: build.gradle.kts expects variables WITHOUT app suffix
+echo "CI=true" >> $GITHUB_ENV
+echo "CM_KEYSTORE_PATH=$KEYSTORE_PATH" >> $GITHUB_ENV
+echo "CM_KEYSTORE_PASSWORD=$KEYSTORE_PASSWORD" >> $GITHUB_ENV
+echo "CM_KEY_ALIAS=$KEY_ALIAS" >> $GITHUB_ENV
+echo "CM_KEY_PASSWORD=$KEY_PASSWORD" >> $GITHUB_ENV
+
+echo "✅ Signing environment configured for $APP_NAME ($ENV environment)" >&2
+echo "🔑 Using key alias: $KEY_ALIAS" >&2
+echo "📝 Environment variables exported:" >&2
+echo "   - CI=true" >&2
+echo "   - CM_KEYSTORE_PATH=$KEYSTORE_PATH" >&2
+echo "   - CM_KEY_ALIAS=$KEY_ALIAS" >&2

.github/scripts/setup-mobile-github-secrets.sh

@@ -0,0 +1,262 @@
+#!/bin/bash
+
+# =============================================================================
+# GitHub Secrets Setup Helper
+# =============================================================================
+# This script helps you configure GitHub Secrets for APK signing
+# 
+# Usage:
+#   ./setup-mobile-github-secrets.sh
+#
+# Reference: docs/RELEASE/APK_SIGNING_SETUP.md
+# =============================================================================
+
+set -e
+
+REPO_ROOT=$(git rev-parse --show-toplevel)
+cd "$REPO_ROOT"
+
+echo "🔐 GitHub Secrets Setup Helper for APK Signing"
+echo "================================================"
+echo ""
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# Track successful secret generations
+SECRETS_FOUND=0
+TOTAL_SECRETS=24
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+print_secret_config() {
+    local app=$1
+    local env=$2
+    local keystore_path=$3
+    local password=$4
+    local alias=$5
+    local key_password=$6
+    
+    local app_upper=$(echo "$app" | tr '[:lower:]' '[:upper:]')
+    local env_upper=$(echo "$env" | tr '[:lower:]' '[:upper:]')
+    
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "  ${app_upper} Mobile - ${env_upper} Environment"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    
+    if [ -f "$keystore_path" ]; then
+        echo -e "${GREEN}✅ Keystore found:${NC} $keystore_path"
+        
+        # Show keystore info
+        echo ""
+        echo "📋 Keystore Information:"
+        keytool -list -v -keystore "$keystore_path" -storepass "$password" 2>/dev/null | head -n 15 || echo "  (Use keytool to inspect)"
+        
+        # Generate base64
+        echo ""
+        echo "📦 Base64 Encoded Keystore:"
+        echo ""
+        BASE64_OUTPUT=$(base64 -i "$keystore_path")
+        echo "$BASE64_OUTPUT"
+        echo ""
+        
+        echo "GitHub Secrets to create:"
+        echo ""
+        echo "  ${app_upper}_KEYSTORE_${env_upper}_BASE64"
+        echo "  ${app_upper}_KEYSTORE_PASSWORD_${env_upper} = $password"
+        echo "  ${app_upper}_KEY_ALIAS_${env_upper}         = $alias"
+        echo "  ${app_upper}_KEY_PASSWORD_${env_upper}      = $key_password"
+        echo ""
+        
+        # Increment success counter (4 secrets per keystore)
+        SECRETS_FOUND=$((SECRETS_FOUND + 4))
+        
+    else
+        echo -e "${YELLOW}⚠️  Keystore not found:${NC} $keystore_path"
+        echo ""
+        echo "This keystore should be stored securely (CodeMagic or secure storage)."
+        echo ""
+    fi
+}
+
+# =============================================================================
+# Worker Mobile (Staff App)
+# =============================================================================
+
+echo ""
+echo "═══════════════════════════════════════════════════════"
+echo "  WORKER MOBILE (Staff App) Configuration"
+echo "═══════════════════════════════════════════════════════"
+
+# DEV Environment
+print_secret_config \
+    "worker" \
+    "dev" \
+    "$REPO_ROOT/apps/mobile/apps/staff/android/app/krow_with_us_staff_dev.jks" \
+    "krowwithus" \
+    "krow_staff_dev" \
+    "krowwithus"
+
+# STAGING Environment
+print_secret_config \
+    "worker" \
+    "staging" \
+    "$REPO_ROOT/keystores/krow_staff_staging.jks" \
+    "YOUR_STAGING_PASSWORD" \
+    "krow_staff_staging" \
+    "YOUR_STAGING_KEY_PASSWORD"
+
+# PROD Environment
+print_secret_config \
+    "worker" \
+    "prod" \
+    "$REPO_ROOT/keystores/krow_staff_prod.jks" \
+    "YOUR_PROD_PASSWORD" \
+    "krow_staff_prod" \
+    "YOUR_PROD_KEY_PASSWORD"
+
+# =============================================================================
+# Client Mobile
+# =============================================================================
+
+echo ""
+echo "═══════════════════════════════════════════════════════"
+echo "  CLIENT MOBILE Configuration"
+echo "═══════════════════════════════════════════════════════"
+
+# DEV Environment
+print_secret_config \
+    "client" \
+    "dev" \
+    "$REPO_ROOT/apps/mobile/apps/client/android/app/krow_with_us_client_dev.jks" \
+    "krowwithus" \
+    "krow_client_dev" \
+    "krowwithus"
+
+# STAGING Environment
+print_secret_config \
+    "client" \
+    "staging" \
+    "$REPO_ROOT/keystores/krow_client_staging.jks" \
+    "YOUR_STAGING_PASSWORD" \
+    "krow_client_staging" \
+    "YOUR_STAGING_KEY_PASSWORD"
+
+# PROD Environment
+print_secret_config \
+    "client" \
+    "prod" \
+    "$REPO_ROOT/keystores/krow_client_prod.jks" \
+    "YOUR_PROD_PASSWORD" \
+    "krow_client_prod" \
+    "YOUR_PROD_KEY_PASSWORD"
+
+# =============================================================================
+# Summary
+# =============================================================================
+
+echo ""
+echo "═══════════════════════════════════════════════════════"
+echo "  SUMMARY"
+echo "═══════════════════════════════════════════════════════"
+echo ""
+echo "Total secrets needed: ${TOTAL_SECRETS}"
+echo "Secrets successfully generated: ${SECRETS_FOUND}"
+echo ""
+echo "  • 6 keystores (base64 encoded)"
+echo "  • 6 keystore passwords"
+echo "  • 6 key aliases"
+echo "  • 6 key passwords"
+echo ""
+
+if [ $SECRETS_FOUND -gt 0 ]; then
+    echo "Generated secrets to add to GitHub:"
+    echo ""
+    
+    # Worker Dev Secrets
+    if [ -f "$REPO_ROOT/apps/mobile/apps/staff/android/app/krow_with_us_staff_dev.jks" ]; then
+        echo "  ✅ WORKER_KEYSTORE_DEV_BASE64"
+        echo "     $(base64 -i "$REPO_ROOT/apps/mobile/apps/staff/android/app/krow_with_us_staff_dev.jks")"
+        echo ""
+        echo "  ✅ WORKER_KEYSTORE_PASSWORD_DEV"
+        echo "     krowwithus"
+        echo ""
+        echo "  ✅ WORKER_KEY_ALIAS_DEV"
+        echo "     krow_staff_dev"
+        echo ""
+        echo "  ✅ WORKER_KEY_PASSWORD_DEV"
+        echo "     krowwithus"
+        echo ""
+    fi
+    
+    # Client Dev Secrets
+    if [ -f "$REPO_ROOT/apps/mobile/apps/client/android/app/krow_with_us_client_dev.jks" ]; then
+        echo "  ✅ CLIENT_KEYSTORE_DEV_BASE64"
+        echo "     $(base64 -i "$REPO_ROOT/apps/mobile/apps/client/android/app/krow_with_us_client_dev.jks")"
+        echo ""
+        echo "  ✅ CLIENT_KEYSTORE_PASSWORD_DEV"
+        echo "     krowwithus"
+        echo ""
+        echo "  ✅ CLIENT_KEY_ALIAS_DEV"
+        echo "     krow_client_dev"
+        echo ""
+        echo "  ✅ CLIENT_KEY_PASSWORD_DEV"
+        echo "     krowwithus"
+        echo ""
+    fi
+fi
+
+if [ $SECRETS_FOUND -lt $TOTAL_SECRETS ]; then
+    echo "Missing secrets (keystores not found):"
+    echo ""
+    
+    if [ ! -f "$REPO_ROOT/keystores/krow_staff_staging.jks" ]; then
+        echo "  ⚠️  WORKER_KEYSTORE_STAGING_BASE64"
+        echo "  ⚠️  WORKER_KEYSTORE_PASSWORD_STAGING"
+        echo "  ⚠️  WORKER_KEY_ALIAS_STAGING"
+        echo "  ⚠️  WORKER_KEY_PASSWORD_STAGING"
+    fi
+    
+    if [ ! -f "$REPO_ROOT/keystores/krow_staff_prod.jks" ]; then
+        echo "  ⚠️  WORKER_KEYSTORE_PROD_BASE64"
+        echo "  ⚠️  WORKER_KEYSTORE_PASSWORD_PROD"
+        echo "  ⚠️  WORKER_KEY_ALIAS_PROD"
+        echo "  ⚠️  WORKER_KEY_PASSWORD_PROD"
+    fi
+    
+    if [ ! -f "$REPO_ROOT/keystores/krow_client_staging.jks" ]; then
+        echo "  ⚠️  CLIENT_KEYSTORE_STAGING_BASE64"
+        echo "  ⚠️  CLIENT_KEYSTORE_PASSWORD_STAGING"
+        echo "  ⚠️  CLIENT_KEY_ALIAS_STAGING"
+        echo "  ⚠️  CLIENT_KEY_PASSWORD_STAGING"
+    fi
+    
+    if [ ! -f "$REPO_ROOT/keystores/krow_client_prod.jks" ]; then
+        echo "  ⚠️  CLIENT_KEYSTORE_PROD_BASE64"
+        echo "  ⚠️  CLIENT_KEYSTORE_PASSWORD_PROD"
+        echo "  ⚠️  CLIENT_KEY_ALIAS_PROD"
+        echo "  ⚠️  CLIENT_KEY_PASSWORD_PROD"
+    fi
+    
+    echo ""
+    echo "Retrieve missing keystores from CodeMagic Team Settings or secure storage."
+fi
+
+echo ""
+echo "To configure GitHub Secrets:"
+echo ""
+echo "  1. Go to: https://github.com/Oloodi/krow-workforce/settings/secrets/actions"
+echo "  2. Click 'New repository secret'"
+echo "  3. Add each secret listed above"
+echo ""
+echo "For complete documentation, see:"
+echo "  docs/RELEASE/APK_SIGNING_SETUP.md"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""

.github/scripts/verify-apk-signature.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+
+# =============================================================================
+# Verify APK Signature
+# =============================================================================
+# This script verifies that an APK is properly signed and displays
+# certificate information
+#
+# Usage:
+#   ./verify-apk-signature.sh <apk_path>
+#
+# Arguments:
+#   apk_path - Path to the APK file to verify
+# =============================================================================
+
+set -e
+
+APK_PATH="$1"
+
+if [ -z "$APK_PATH" ]; then
+    echo "❌ Error: Missing APK path" >&2
+    echo "Usage: $0 <apk_path>" >&2
+    exit 1
+fi
+
+if [ ! -f "$APK_PATH" ]; then
+    echo "❌ APK not found at: $APK_PATH" >&2
+    exit 1
+fi
+
+echo "🔍 Verifying APK signature..." >&2
+
+# Check if APK is signed
+if jarsigner -verify -verbose "$APK_PATH" 2>&1 | grep -q "jar verified"; then
+    echo "✅ APK is properly signed!" >&2
+    
+    # Extract certificate details
+    echo "" >&2
+    echo "📜 Certificate Details:" >&2
+    jarsigner -verify -verbose -certs "$APK_PATH" 2>&1 | grep -A 3 "X.509" || true
+    
+    # Get signer info
+    echo "" >&2
+    echo "🔑 Signer Information:" >&2
+    keytool -printcert -jarfile "$APK_PATH" | head -n 15
+    
+else
+    echo "⚠️  WARNING: APK signature verification failed or APK is unsigned!" >&2
+    echo "" >&2
+    echo "This may happen if:" >&2
+    echo "  1. GitHub Secrets are not configured for this environment" >&2
+    echo "  2. Keystore credentials are incorrect" >&2
+    echo "  3. Build configuration didn't apply signing" >&2
+    echo "" >&2
+    echo "See: docs/RELEASE/APK_SIGNING_SETUP.md for setup instructions" >&2
+    
+    # Don't fail the build, just warn
+    # exit 1
+fi

.github/workflows/backend-foundation.yml

@@ -2,6 +2,7 @@ name: Backend Foundation
 
 on:
   workflow_dispatch: # Manual trigger only — auto-triggers disabled (free plan)
+  workflow_dispatch:
 
 jobs:
   backend-foundation-makefile:

.github/workflows/hotfix-branch-creation.yml

@@ -0,0 +1,332 @@
+name: 🚨 Hotfix Branch Creation
+
+on:
+  workflow_dispatch:
+    inputs:
+      app:
+        description: '📦 Product'
+        required: true
+        type: choice
+        options:
+          - worker-mobile-app
+          - client-mobile-app
+      tag:
+        description: '🏷️ Current Tag (e.g., krow-withus-worker-mobile/prod-v0.1.0 or dev/stage)'
+        required: true
+        type: string
+      issue_description:
+        description: '📝 Brief issue description'
+        required: true
+        type: string
+
+jobs:
+  create-hotfix-branch:
+    name: 🚨 Create Hotfix Branch
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: 🔍 Validate tag exists
+        id: validate_tag
+        run: |
+          TAG="${{ github.event.inputs.tag }}"
+          
+          if ! git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "❌ Error: Tag '$TAG' does not exist"
+            echo "Available tags:"
+            git tag -l "krow-withus-*-mobile/*" | tail -20
+            exit 1
+          fi
+          
+          echo "✅ Tag exists: $TAG"
+          
+          # Extract version from tag
+          VERSION=$(echo "$TAG" | grep -oP 'v\K[0-9]+\.[0-9]+\.[0-9]+' || echo "")
+          if [ -z "$VERSION" ]; then
+            echo "❌ Error: Could not extract version from tag"
+            exit 1
+          fi
+          
+          echo "current_version=${VERSION}" >> $GITHUB_OUTPUT
+          echo "📌 Current version: $VERSION"
+          
+      - name: 🔢 Calculate hotfix version
+        id: hotfix_version
+        run: |
+          CURRENT="${{ steps.validate_tag.outputs.current_version }}"
+          
+          # Split version into parts
+          IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+          
+          # Increment PATCH version
+          NEW_PATCH=$((PATCH + 1))
+          HOTFIX_VERSION="${MAJOR}.${MINOR}.${NEW_PATCH}"
+          
+          echo "hotfix_version=${HOTFIX_VERSION}" >> $GITHUB_OUTPUT
+          echo "🆕 Hotfix version: $HOTFIX_VERSION"
+          
+      - name: 🌿 Generate branch name
+        id: branch
+        run: |
+          APP="${{ github.event.inputs.app }}"
+          VERSION="${{ steps.hotfix_version.outputs.hotfix_version }}"
+          
+          # Strip -mobile-app suffix for cleaner branch names
+          APP_CLEAN=$(echo "$APP" | sed 's/-mobile-app$//')
+          
+          BRANCH_NAME="hotfix/krow-withus-${APP_CLEAN}-mobile-v${VERSION}"
+          echo "branch_name=${BRANCH_NAME}" >> $GITHUB_OUTPUT
+          echo "🌿 Branch to create: $BRANCH_NAME"
+          
+      - name: 🔍 Check if hotfix branch already exists
+        run: |
+          BRANCH="${{ steps.branch.outputs.branch_name }}"
+          
+          if git ls-remote --heads origin "$BRANCH" | grep -q "$BRANCH"; then
+            echo "❌ Error: Branch $BRANCH already exists"
+            exit 1
+          fi
+          
+          echo "✅ Branch does not exist, proceeding..."
+          
+      - name: 🌿 Create hotfix branch from tag
+        run: |
+          TAG="${{ github.event.inputs.tag }}"
+          BRANCH="${{ steps.branch.outputs.branch_name }}"
+          
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          # Checkout the tag
+          git checkout "$TAG"
+          
+          # Create new branch
+          git checkout -b "$BRANCH"
+          
+          echo "✅ Created branch $BRANCH from tag $TAG"
+          
+      - name: 📝 Update version files
+        id: update_versions
+        run: |
+          APP="${{ github.event.inputs.app }}"
+          HOTFIX_VERSION="${{ steps.hotfix_version.outputs.hotfix_version }}"
+          
+          if [ "$APP" = "worker-mobile-app" ]; then
+            PUBSPEC_PATH="apps/mobile/apps/staff/pubspec.yaml"
+            CHANGELOG_PATH="apps/mobile/apps/staff/CHANGELOG.md"
+            APP_NAME="Staff Product"
+          else
+            PUBSPEC_PATH="apps/mobile/apps/client/pubspec.yaml"
+            CHANGELOG_PATH="apps/mobile/apps/client/CHANGELOG.md"
+            APP_NAME="Client Product"
+          fi
+          
+          # Update pubspec.yaml version
+          if [ -f "$PUBSPEC_PATH" ]; then
+            # Extract current version and build number
+            CURRENT_VERSION_LINE=$(grep "^version:" "$PUBSPEC_PATH")
+            CURRENT_BUILD=$(echo "$CURRENT_VERSION_LINE" | grep -oP '\+\K[0-9]+' || echo "1")
+            NEW_BUILD=$((CURRENT_BUILD + 1))
+            
+            # Update version line
+            sed -i "s/^version:.*/version: ${HOTFIX_VERSION}+${NEW_BUILD}/" "$PUBSPEC_PATH"
+            
+            echo "✅ Updated $PUBSPEC_PATH to ${HOTFIX_VERSION}+${NEW_BUILD}"
+            echo "updated_files=true" >> $GITHUB_OUTPUT
+          else
+            echo "⚠️ Warning: $PUBSPEC_PATH not found"
+            echo "updated_files=false" >> $GITHUB_OUTPUT
+          fi
+          
+      - name: 📋 Add CHANGELOG entry
+        run: |
+          APP="${{ github.event.inputs.app }}"
+          HOTFIX_VERSION="${{ steps.hotfix_version.outputs.hotfix_version }}"
+          ISSUE="${{ github.event.inputs.issue_description }}"
+          
+          if [ "$APP" = "worker-mobile-app" ]; then
+            CHANGELOG_PATH="apps/mobile/apps/staff/CHANGELOG.md"
+            APP_NAME="Staff Product"
+          else
+            CHANGELOG_PATH="apps/mobile/apps/client/CHANGELOG.md"
+            APP_NAME="Client Product"
+          fi
+          
+          if [ -f "$CHANGELOG_PATH" ]; then
+            DATE=$(date +%Y-%m-%d)
+            
+            # Extract title and body
+            TITLE=$(head -n 1 "$CHANGELOG_PATH")
+            BODY=$(tail -n +2 "$CHANGELOG_PATH")
+            
+            # Rebuild CHANGELOG with hotfix entry
+            echo "$TITLE" > "$CHANGELOG_PATH"
+            echo "" >> "$CHANGELOG_PATH"
+            echo "## [${HOTFIX_VERSION}] - ${DATE} - HOTFIX" >> "$CHANGELOG_PATH"
+            echo "" >> "$CHANGELOG_PATH"
+            echo "### Fixed" >> "$CHANGELOG_PATH"
+            echo "- ${ISSUE}" >> "$CHANGELOG_PATH"
+            echo "" >> "$CHANGELOG_PATH"
+            echo "---" >> "$CHANGELOG_PATH"
+            echo "" >> "$CHANGELOG_PATH"
+            echo "$BODY" >> "$CHANGELOG_PATH"
+            
+            echo "✅ Added CHANGELOG entry for hotfix $HOTFIX_VERSION"
+          else
+            echo "⚠️ Warning: $CHANGELOG_PATH not found"
+          fi
+          
+      - name: 💾 Commit version changes
+        run: |
+          HOTFIX_VERSION="${{ steps.hotfix_version.outputs.hotfix_version }}"
+          ISSUE="${{ github.event.inputs.issue_description }}"
+          
+          git add -A
+          git commit -m "chore: prepare hotfix v${HOTFIX_VERSION}
+
+HOTFIX: ${ISSUE}
+
+- Bump version to ${HOTFIX_VERSION}
+- Add CHANGELOG entry
+- Ready for bug fix commits
+
+From tag: ${{ github.event.inputs.tag }}"
+          
+          echo "✅ Committed version changes"
+          
+      - name: 🚀 Push hotfix branch
+        run: |
+          BRANCH="${{ steps.branch.outputs.branch_name }}"
+          
+          git push origin "$BRANCH"
+          
+          echo "✅ Pushed branch: $BRANCH"
+          
+      - name: 📄 Create Pull Request
+        id: create_pr
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          BRANCH="${{ steps.branch.outputs.branch_name }}"
+          HOTFIX_VERSION="${{ steps.hotfix_version.outputs.hotfix_version }}"
+          ISSUE="${{ github.event.inputs.issue_description }}"
+          APP="${{ github.event.inputs.app }}"
+          
+          # Strip -mobile-app suffix for cleaner tag names
+          APP_CLEAN=$(echo "$APP" | sed 's/-mobile-app$//')
+          
+          if [ "$APP" = "worker-mobile-app" ]; then
+            APP_DISPLAY="Worker Product"
+          else
+            APP_DISPLAY="Client Product"
+          fi
+          
+          PR_TITLE="🚨 HOTFIX: ${APP_DISPLAY} v${HOTFIX_VERSION} - ${ISSUE}"
+          
+          PR_BODY="## 🚨 HOTFIX - URGENT FIX
+
+**App:** ${APP_DISPLAY}
+**Version:** ${HOTFIX_VERSION}
+**From:** \`${{ github.event.inputs.tag }}\`
+
+### Issue
+${ISSUE}
+
+### Impact
+<!-- Describe how many users are affected and severity -->
+
+### Solution
+<!-- Describe the fix (will be added as you commit fixes) -->
+
+### Testing
+<!-- Describe local verification -->
+
+---
+
+## ⚠️ Hotfix Process
+
+1. ✅ Hotfix branch created
+2. ⏳ **NEXT:** Make your bug fix commits to this branch
+3. ⏳ Test the fix locally
+4. ⏳ Request expedited review (< 15 minutes)
+5. ⏳ Merge to main and create production tag
+
+### To add your fix:
+\`\`\`bash
+git checkout $BRANCH
+# Make your changes
+git commit -m \"fix: [description]\"
+git push origin $BRANCH
+\`\`\`
+
+### After merging:
+\`\`\`bash
+# Tag and release
+git checkout main
+git pull origin main
+git tag -a krow-withus-${APP_CLEAN}-mobile/prod-v${HOTFIX_VERSION} -m \"HOTFIX: ${ISSUE}\"
+git push origin krow-withus-${APP_CLEAN}-mobile/prod-v${HOTFIX_VERSION}
+\`\`\`
+
+---
+
+**Ref:** [Hotfix Process Documentation](../docs/release/HOTFIX_PROCESS.md)"
+          
+          # Create PR
+          PR_URL=$(gh pr create \
+            --base main \
+            --head "$BRANCH" \
+            --title "$PR_TITLE" \
+            --body "$PR_BODY" \
+            --label "hotfix,urgent,production")
+          
+          echo "pr_url=${PR_URL}" >> $GITHUB_OUTPUT
+          echo "✅ Pull Request created: $PR_URL"
+          
+      - name: 📊 Hotfix Summary
+        run: |
+          # Strip -mobile-app suffix for cleaner tag names
+          APP_CLEAN=$(echo "${{ github.event.inputs.app }}" | sed 's/-mobile-app$//')
+          
+          echo "## 🚨 Hotfix Branch Created" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**App:** ${{ github.event.inputs.app }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Issue:** ${{ github.event.inputs.issue_description }}" >> $GITHUB_STEP_SUMMARY
+          echo "**From Tag:** \`${{ github.event.inputs.tag }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "**Current Version:** ${{ steps.validate_tag.outputs.current_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Hotfix Version:** ${{ steps.hotfix_version.outputs.hotfix_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Branch:** \`${{ steps.branch.outputs.branch_name }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 🔧 Next Steps" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "1. **Checkout the hotfix branch:**" >> $GITHUB_STEP_SUMMARY
+          echo "   \`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "   git fetch origin" >> $GITHUB_STEP_SUMMARY
+          echo "   git checkout ${{ steps.branch.outputs.branch_name }}" >> $GITHUB_STEP_SUMMARY
+          echo "   \`\`\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "2. **Make your bug fix(es)** - Keep changes minimal!" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "3. **Test locally** - Verify the fix works" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "4. **Request expedited review** - Target < 15 minutes" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "5. **Merge PR and create production tag:**" >> $GITHUB_STEP_SUMMARY
+          echo "   \`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "   git checkout main" >> $GITHUB_STEP_SUMMARY
+          echo "   git pull origin main" >> $GITHUB_STEP_SUMMARY
+          echo "   git tag -a krow-withus-${APP_CLEAN}-mobile/prod-v${{ steps.hotfix_version.outputs.hotfix_version }} -m \"HOTFIX: ${{ github.event.inputs.issue_description }}\"" >> $GITHUB_STEP_SUMMARY
+          echo "   git push origin krow-withus-${APP_CLEAN}-mobile/prod-v${{ steps.hotfix_version.outputs.hotfix_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "   \`\`\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          if [ -n "${{ steps.create_pr.outputs.pr_url }}" ]; then
+            echo "**Pull Request:** ${{ steps.create_pr.outputs.pr_url }}" >> $GITHUB_STEP_SUMMARY
+          fi

.github/workflows/mobile-ci.yml

@@ -2,6 +2,7 @@ name: Mobile CI
 
 on:
   workflow_dispatch: # Manual trigger only — auto-triggers disabled (free plan)
+  workflow_dispatch:
 
 jobs:
   detect-changes:

.github/workflows/product-release.yml

@@ -0,0 +1,289 @@
+name: 📦 Product Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      app:
+        description: '📦 Product'
+        required: true
+        type: choice
+        options:
+          - worker-mobile-app
+          - client-mobile-app
+      environment:
+        description: '🌍 Environment'
+        required: true
+        type: choice
+        options:
+          - dev
+          - stage
+          - prod
+      create_github_release:
+        description: '📦 Create GitHub Release'
+        required: true
+        type: boolean
+        default: true
+      prerelease:
+        description: '🔖 Mark as Pre-release'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  validate-and-create-release:
+    name: 🚀 Create Product Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      tag_name: ${{ steps.tag.outputs.tag_name }}
+      
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: 🏃🏾‍♂️ Make scripts executable
+        run: |
+          chmod +x .github/scripts/*.sh
+          echo "✅ Scripts are now executable"
+          
+      - name: 📖 Extract version from version file
+        id: version
+        run: |
+          VERSION=$(.github/scripts/extract-version.sh "${{ github.event.inputs.app }}")
+          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+          echo "📌 Extracted version: ${VERSION}"
+          
+      - name: 🏷️ Generate tag name
+        id: tag
+        run: |
+          TAG_NAME=$(.github/scripts/generate-tag-name.sh \
+            "${{ github.event.inputs.app }}" \
+            "${{ github.event.inputs.environment }}" \
+            "${{ steps.version.outputs.version }}")
+          echo "tag_name=${TAG_NAME}" >> $GITHUB_OUTPUT
+          echo "🎯 Tag to create: ${TAG_NAME}"
+          
+      - name: 🔍 Check if tag already exists
+        run: |
+          TAG_NAME="${{ steps.tag.outputs.tag_name }}"
+          if git rev-parse "$TAG_NAME" >/dev/null 2>&1; then
+            echo "❌ Error: Tag $TAG_NAME already exists"
+            echo "💡 Tip: Update the version in the version file before creating a new release"
+            exit 1
+          fi
+          echo "✅ Tag does not exist, proceeding..."
+          
+      - name: 📋 Extract release notes from CHANGELOG
+        id: release_notes
+        run: |
+          .github/scripts/extract-release-notes.sh \
+            "${{ github.event.inputs.app }}" \
+            "${{ steps.version.outputs.version }}" \
+            "${{ github.event.inputs.environment }}" \
+            "${{ steps.tag.outputs.tag_name }}" \
+            "/tmp/release_notes.md"
+          echo "notes_file=/tmp/release_notes.md" >> $GITHUB_OUTPUT
+          
+      - name: 🏷️ Create Git Tag
+        run: |
+          TAG_NAME="${{ steps.tag.outputs.tag_name }}"
+          APP="${{ github.event.inputs.app }}"
+          ENV="${{ github.event.inputs.environment }}"
+          VERSION="${{ steps.version.outputs.version }}"
+          
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          git tag -a "$TAG_NAME" -m "🚀 Release ${APP} product ${VERSION} to ${ENV}"
+          git push origin "$TAG_NAME"
+          
+          echo "✅ Tag created and pushed: $TAG_NAME"
+          
+      - name: 📦 Create GitHub Release
+        if: ${{ github.event.inputs.create_github_release == 'true' }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG_NAME="${{ steps.tag.outputs.tag_name }}"
+          APP="${{ github.event.inputs.app }}"
+          ENV="${{ github.event.inputs.environment }}"
+          VERSION="${{ steps.version.outputs.version }}"
+          
+          # Generate release title
+          if [ "$APP" = "worker-mobile-app" ]; then
+            APP_DISPLAY="Worker Mobile Application"
+          else
+            APP_DISPLAY="Client Mobile Application"
+          fi
+          
+          ENV_UPPER=$(echo "$ENV" | tr '[:lower:]' '[:upper:]')
+          RELEASE_NAME="Krow With Us - ${APP_DISPLAY} - ${ENV_UPPER} - v${VERSION}"
+          
+          echo "📦 Creating GitHub Release: $RELEASE_NAME"
+          
+          # Create release
+          if [ "${{ github.event.inputs.prerelease }}" = "true" ]; then
+            gh release create "$TAG_NAME" \
+              --title "$RELEASE_NAME" \
+              --notes-file "${{ steps.release_notes.outputs.notes_file }}" \
+              --prerelease
+            echo "🔖 Pre-release created successfully"
+          else
+            gh release create "$TAG_NAME" \
+              --title "$RELEASE_NAME" \
+              --notes-file "${{ steps.release_notes.outputs.notes_file }}"
+            echo "✅ Release created successfully"
+          fi
+          
+      - name: 📊 Generate Release Summary
+        run: |
+          .github/scripts/create-release-summary.sh \
+            "${{ github.event.inputs.app }}" \
+            "${{ github.event.inputs.environment }}" \
+            "${{ steps.version.outputs.version }}" \
+            "${{ steps.tag.outputs.tag_name }}"
+  
+  build-mobile-artifacts:
+    name: 📱 Build Mobile APK
+    runs-on: ubuntu-latest
+    needs: validate-and-create-release
+    if: ${{ github.event.inputs.app == 'worker-mobile-app' || github.event.inputs.app == 'client-mobile-app' }}
+    permissions:
+      contents: write
+    
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          
+      - name: 🔥 Install Firebase CLI
+        run: |
+          npm install -g firebase-tools
+          firebase --version
+          echo "ℹ️ Note: Firebase CLI installed for Data Connect SDK generation"
+          echo "ℹ️ If SDK generation fails, ensure Data Connect SDK files are committed to repo"
+          
+      - name: ☕ Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: '17'
+          
+      - name: 🐦 Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.38.x'
+          channel: 'stable'
+          cache: true
+          
+      - name: 🔧 Install Melos
+        run: |
+          dart pub global activate melos
+          echo "$HOME/.pub-cache/bin" >> $GITHUB_PATH
+          
+      - name: 📦 Install Dependencies
+        run: |
+          make mobile-install
+          
+      - name: 🔐 Setup APK Signing
+        env:
+          # Worker Mobile (Staff App) Secrets
+          WORKER_KEYSTORE_DEV_BASE64: ${{ secrets.WORKER_KEYSTORE_DEV_BASE64 }}
+          WORKER_KEYSTORE_STAGING_BASE64: ${{ secrets.WORKER_KEYSTORE_STAGING_BASE64 }}
+          WORKER_KEYSTORE_PROD_BASE64: ${{ secrets.WORKER_KEYSTORE_PROD_BASE64 }}
+          WORKER_KEYSTORE_PASSWORD_DEV: ${{ secrets.WORKER_KEYSTORE_PASSWORD_DEV }}
+          WORKER_KEYSTORE_PASSWORD_STAGING: ${{ secrets.WORKER_KEYSTORE_PASSWORD_STAGING }}
+          WORKER_KEYSTORE_PASSWORD_PROD: ${{ secrets.WORKER_KEYSTORE_PASSWORD_PROD }}
+          WORKER_KEY_ALIAS_DEV: ${{ secrets.WORKER_KEY_ALIAS_DEV }}
+          WORKER_KEY_ALIAS_STAGING: ${{ secrets.WORKER_KEY_ALIAS_STAGING }}
+          WORKER_KEY_ALIAS_PROD: ${{ secrets.WORKER_KEY_ALIAS_PROD }}
+          WORKER_KEY_PASSWORD_DEV: ${{ secrets.WORKER_KEY_PASSWORD_DEV }}
+          WORKER_KEY_PASSWORD_STAGING: ${{ secrets.WORKER_KEY_PASSWORD_STAGING }}
+          WORKER_KEY_PASSWORD_PROD: ${{ secrets.WORKER_KEY_PASSWORD_PROD }}
+          
+          # Client Mobile Secrets
+          CLIENT_KEYSTORE_DEV_BASE64: ${{ secrets.CLIENT_KEYSTORE_DEV_BASE64 }}
+          CLIENT_KEYSTORE_STAGING_BASE64: ${{ secrets.CLIENT_KEYSTORE_STAGING_BASE64 }}
+          CLIENT_KEYSTORE_PROD_BASE64: ${{ secrets.CLIENT_KEYSTORE_PROD_BASE64 }}
+          CLIENT_KEYSTORE_PASSWORD_DEV: ${{ secrets.CLIENT_KEYSTORE_PASSWORD_DEV }}
+          CLIENT_KEYSTORE_PASSWORD_STAGING: ${{ secrets.CLIENT_KEYSTORE_PASSWORD_STAGING }}
+          CLIENT_KEYSTORE_PASSWORD_PROD: ${{ secrets.CLIENT_KEYSTORE_PASSWORD_PROD }}
+          CLIENT_KEY_ALIAS_DEV: ${{ secrets.CLIENT_KEY_ALIAS_DEV }}
+          CLIENT_KEY_ALIAS_STAGING: ${{ secrets.CLIENT_KEY_ALIAS_STAGING }}
+          CLIENT_KEY_ALIAS_PROD: ${{ secrets.CLIENT_KEY_ALIAS_PROD }}
+          CLIENT_KEY_PASSWORD_DEV: ${{ secrets.CLIENT_KEY_PASSWORD_DEV }}
+          CLIENT_KEY_PASSWORD_STAGING: ${{ secrets.CLIENT_KEY_PASSWORD_STAGING }}
+          CLIENT_KEY_PASSWORD_PROD: ${{ secrets.CLIENT_KEY_PASSWORD_PROD }}
+        run: |
+          .github/scripts/setup-apk-signing.sh \
+            "${{ github.event.inputs.app }}" \
+            "${{ github.event.inputs.environment }}" \
+            "${{ runner.temp }}"
+          
+      - name: 🏗️ Build APK
+        id: build_apk
+        run: |
+          APP="${{ github.event.inputs.app }}"
+          
+          if [ "$APP" = "worker-mobile-app" ]; then
+            echo "📱 Building Staff (Worker) APK..."
+            make mobile-staff-build PLATFORM=apk MODE=release
+            APP_NAME="staff"
+          else
+            echo "📱 Building Client APK..."
+            make mobile-client-build PLATFORM=apk MODE=release
+            APP_NAME="client"
+          fi
+          
+          # Find the generated APK (Flutter places it in build/app/outputs/flutter-apk/)
+          APK_PATH=$(find apps/mobile/apps/${APP_NAME}/build/app/outputs/flutter-apk -name "app-release.apk" 2>/dev/null | head -n 1)
+          
+          # Fallback to searching entire apps directory if not found
+          if [ -z "$APK_PATH" ]; then
+            APK_PATH=$(find apps/mobile/apps/${APP_NAME} -name "app-release.apk" | head -n 1)
+          fi
+          
+          if [ -z "$APK_PATH" ]; then
+            echo "❌ Error: APK not found!"
+            echo "Searched in apps/mobile/apps/${APP_NAME}/"
+            find apps/mobile/apps/${APP_NAME} -name "*.apk" || echo "No APK files found"
+            exit 1
+          fi
+          
+          echo "✅ APK built successfully: $APK_PATH"
+          echo "app_name=${APP_NAME}" >> $GITHUB_OUTPUT
+          echo "apk_path=${APK_PATH}" >> $GITHUB_OUTPUT
+          
+      - name: ✅ Verify APK Signature
+        run: |
+          .github/scripts/verify-apk-signature.sh "${{ steps.build_apk.outputs.apk_path }}"
+          
+      - name: 📤 Upload APK as Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ github.event.inputs.app }}-${{ needs.validate-and-create-release.outputs.version }}-${{ github.event.inputs.environment }}
+          path: apps/mobile/apps/${{ steps.build_apk.outputs.app_name }}/build/app/outputs/flutter-apk/app-release.apk
+          if-no-files-found: error
+          retention-days: 30
+          
+      - name: 📦 Attach APK to GitHub Release
+        if: ${{ github.event.inputs.create_github_release == 'true' }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          .github/scripts/attach-apk-to-release.sh \
+            "${{ needs.validate-and-create-release.outputs.tag_name }}" \
+            "${{ github.event.inputs.app }}" \
+            "${{ steps.build_apk.outputs.app_name }}" \
+            "${{ needs.validate-and-create-release.outputs.version }}" \
+            "${{ github.event.inputs.environment }}"

.gitignore

@@ -187,9 +187,11 @@ krow-workforce-export-latest/
 apps/mobile/packages/data_connect/lib/src/dataconnect_generated/
 apps/web/src/dataconnect-generated/
 
+# Legacy mobile applications
+apps/mobile/legacy/*
+
 
 AGENTS.md
-CLAUDE.md
-GEMINI.md
 TASKS.md
+CLAUDE.md
 \n# Android Signing (Secure)\n**.jks\n**key.properties

.vscode/launch.json

@@ -1,41 +1,127 @@
 {
     "version": "0.2.0",
     "configurations": [
+        // ===================== Client App =====================
         {
-            "name": "Client (Dev) - Android",
+            "name": "Client [DEV] - Android",
             "request": "launch",
             "type": "dart",
             "program": "apps/mobile/apps/client/lib/main.dart",
             "args": [
+                "--flavor", "dev",
                 "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.dev.json"
             ]
         },
         {
-            "name": "Client (Dev) - iOS",
+            "name": "Client [DEV] - iOS",
             "request": "launch",
             "type": "dart",
             "program": "apps/mobile/apps/client/lib/main.dart",
             "args": [
+                "--flavor", "dev",
                 "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.dev.json"
             ]
         },
         {
-            "name": "Staff (Dev) - Android",
+            "name": "Client [STG] - Android",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/client/lib/main.dart",
+            "args": [
+                "--flavor", "stage",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.stage.json"
+            ]
+        },
+        {
+            "name": "Client [STG] - iOS",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/client/lib/main.dart",
+            "args": [
+                "--flavor", "stage",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.stage.json"
+            ]
+        },
+        {
+            "name": "Client [PROD] - Android",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/client/lib/main.dart",
+            "args": [
+                "--flavor", "prod",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.prod.json"
+            ]
+        },
+        {
+            "name": "Client [PROD] - iOS",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/client/lib/main.dart",
+            "args": [
+                "--flavor", "prod",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.prod.json"
+            ]
+        },
+        // ===================== Staff App =====================
+        {
+            "name": "Staff [DEV] - Android",
             "request": "launch",
             "type": "dart",
             "program": "apps/mobile/apps/staff/lib/main.dart",
             "args": [
+                "--flavor", "dev",
                 "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.dev.json"
             ]
         },
         {
-            "name": "Staff (Dev) - iOS",
+            "name": "Staff [DEV] - iOS",
             "request": "launch",
             "type": "dart",
             "program": "apps/mobile/apps/staff/lib/main.dart",
             "args": [
+                "--flavor", "dev",
                 "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.dev.json"
             ]
+        },
+        {
+            "name": "Staff [STG] - Android",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/staff/lib/main.dart",
+            "args": [
+                "--flavor", "stage",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.stage.json"
+            ]
+        },
+        {
+            "name": "Staff [STG] - iOS",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/staff/lib/main.dart",
+            "args": [
+                "--flavor", "stage",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.stage.json"
+            ]
+        },
+        {
+            "name": "Staff [PROD] - Android",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/staff/lib/main.dart",
+            "args": [
+                "--flavor", "prod",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.prod.json"
+            ]
+        },
+        {
+            "name": "Staff [PROD] - iOS",
+            "request": "launch",
+            "type": "dart",
+            "program": "apps/mobile/apps/staff/lib/main.dart",
+            "args": [
+                "--flavor", "prod",
+                "--dart-define-from-file=${workspaceFolder}/apps/mobile/config.prod.json"
+            ]
         }
     ]
 }

BLOCKERS.md

@@ -1,57 +0,0 @@
-# Blockers
-
-## App
-- Client application
-
-### Github issue
-- https://github.com/Oloodi/krow-workforce/issues/210
-### Why this task is blocked:
-- This task is currently blocked, mainly because client registration via social logins is blocked. To create a business, we require a business name, and with social sign-up we don’t have a screen to capture that information. Because of this, the flow cannot be completed.
-- The best option, in my opinion, is to allow Google and Apple sign-in only for existing users, and not use them for new user registration.
-
-### Github issue
-- https://github.com/Oloodi/krow-workforce/issues/257
-### Why this task is blocked:
-- Although this page existed in the prototype, it was not connected to any other pages. In other words, there was no way to navigate to it from anywhere in the application. Therefore, this issue can be closed, as the page is not required in the main application.
-
-## App
-- Staff application
-
-### Github issue
-- https://github.com/Oloodi/krow-workforce/issues/249
-### Why this task is blocked:
-- Although this page existed in the prototype, it was not connected to any other pages. In other words, there was no way to navigate to it from anywhere in the application. Therefore, this issue can be closed, as the page is not required in the main application.
-
-### Github issue
-- https://github.com/Oloodi/krow-workforce/issues/262
-### Why this task is blocked:
-- Although this page existed in the prototype, it was not connected to any other pages. In other words, there was no way to navigate to it from anywhere in the application. Therefore, this issue can be closed, as the page is not required in the main application.
-
-# Deviations
-
-## App
-- Client Application
-
-### Github issue
-- https://github.com/Oloodi/krow-workforce/issues/240
-### Deveations:
-- In the web prototype, when creating an order, position role rates are displayed based on the selected vendor. This behavior was missing in the mobile prototype. Therefore, we added a dropdown to select the vendor and display the corresponding role rates based on that selection.
-
-# Points to considerate in the future
-- client APP:
-    - Billing need to download a pdf of their invoice.
-    - On app launch, check whether there is an active session. If a valid session exists, skip the auth flow and navigate directly to Home, loading business account.
-    - Add an expiration time (TTL) to the session (store expiresAt / expiryTimestamp) and invalidate/clear the session when it has expired.
-    - Rapid order need IA to work, I think we need also to add a form as the webpage.
-- Staff APP:
-    - On app launch, check whether there is an active session. If a valid session exists, skip the auth flow and navigate directly to Home, loading Staff account.
-    - Add an expiration time (TTL) to the session (store expiresAt / expiryTimestamp) and invalidate/clear the session when it has expired.
-    - For staffs Skills = Roles? thinking in the future for the smart assigned that need to know the roles of staff to assign.
-
-## App
-- Staff Application
-
-### Github issue
-- https://github.com/Oloodi/krow-workforce/issues/248
-### Deveations:
-- Assumed that a worker can only have one shift per day.

CLAUDE.md

@@ -0,0 +1,149 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+KROW Workforce is a workforce management platform monorepo containing Flutter mobile apps, a React web dashboard, and Firebase backend services.
+
+## Repository Structure
+
+```
+apps/mobile/          # Flutter monorepo (Melos workspace)
+  apps/staff/         # Staff mobile app
+  apps/client/        # Client (business) mobile app
+  packages/
+    design_system/    # Shared UI tokens & components
+    core/             # Cross-cutting concerns (mixins, extensions)
+    core_localization/# i18n via Slang
+    domain/           # Pure Dart entities & failures
+    data_connect/     # Firebase Data Connect adapter (connectors)
+    features/staff/   # Staff feature packages
+    features/client/  # Client feature packages
+apps/web/             # React/Vite web dashboard (TypeScript, Tailwind, Redux Toolkit)
+backend/
+  dataconnect/        # Firebase Data Connect GraphQL schemas
+  core-api/           # Core business logic service
+  cloud-functions/    # Serverless functions
+```
+
+## Common Commands
+
+All commands use the root `Makefile` (composed from `makefiles/*.mk`). Run `make help` for the full list.
+
+### Mobile (Flutter)
+```bash
+make mobile-install                          # Bootstrap Melos workspace + generate SDK
+make mobile-staff-dev-android                # Run staff app (add DEVICE=android)
+make mobile-client-dev-android               # Run client app
+make mobile-analyze                          # Lint (flutter analyze)
+make mobile-test                             # Run tests
+make test-e2e                                # Maestro E2E tests (both apps)
+```
+
+Single-package operations via Melos:
+```bash
+cd apps/mobile
+melos run gen:l10n                           # Generate localization (Slang)
+melos run gen:build                          # Run build_runner
+melos run analyze:all                        # Analyze all packages
+melos run test:all                           # Test all packages
+```
+
+### Web (React/Vite)
+```bash
+make web-install        # npm install
+make web-dev            # Start dev server
+make web-build          # Production build
+make web-lint           # ESLint
+make web-test           # Vitest
+```
+
+### Backend (Data Connect)
+```bash
+make dataconnect-generate-sdk [ENV=dev]      # Generate SDK
+make dataconnect-deploy [ENV=dev]            # Deploy schemas
+make dataconnect-sync-full [ENV=dev]         # Deploy + migrate + generate
+```
+
+## Mobile Architecture
+
+**Clean Architecture** with strict inward dependency flow:
+
+```
+Presentation (Pages, BLoCs, Widgets)
+  → Application (Use Cases)
+    → Domain (Entities, Repository Interfaces, Failures)
+      ← Data (Repository Implementations, Connectors)
+```
+
+### Key Patterns
+
+- **State management:** Flutter BLoC/Cubit. Register BLoCs with `i.add()` (transient), never `i.addSingleton()`. Use `BlocProvider.value()` for shared BLoCs.
+- **DI & Routing:** Flutter Modular. Safe navigation via `safeNavigate()`, `safePush()`, `popSafe()`. Never use `Navigator.push()` directly.
+- **Error handling in BLoCs:** Use `BlocErrorHandler` mixin with `_safeEmit()` to prevent StateError on disposed BLoCs.
+- **Backend access:** All Data Connect calls go through the `data_connect` package's Connectors. Use `_service.run(() => connector.<query>().execute())` for automatic auth/token management.
+- **Session management:** `SessionHandlerMixin` + `SessionListener` widget. Initialized in `main.dart` with role-based config.
+- **Localization:** All user-facing strings via `context.strings.<key>` from `core_localization`. Error messages via `ErrorTranslator`.
+- **Design system:** Use tokens from `UiColors`, `UiTypography`, `UiConstants`. Never hardcode colors, fonts, or spacing.
+
+### Feature Package Structure
+
+New features go in `apps/mobile/packages/features/<app>/<feature>/`:
+```
+lib/src/
+  domain/repositories/    # Abstract interface classes
+  data/repositories_impl/ # Implementations using data_connect
+  application/            # Use cases (business logic)
+  presentation/
+    blocs/                # BLoCs/Cubits
+    pages/                # Pages (prefer StatelessWidget)
+    widgets/              # Reusable widgets
+```
+
+### Critical Rules
+
+- Features must not import other features directly
+- Business logic belongs in Use Cases, never in BLoCs or widgets
+- Firebase packages (`firebase_auth`, `firebase_data_connect`) belong only in `data_connect`
+- Don't add 3rd-party packages without checking `packages/core` first
+- Generated code directories are excluded from analysis: `**/dataconnect_generated/**`, `**/*.g.dart`, `**/*.freezed.dart`
+
+## Code Generation
+
+- **Slang** (i18n): Input `lib/src/l10n/*.i18n.json` → Output `strings.g.dart`
+- **build_runner**: Various generated files (`.g.dart`, `.freezed.dart`)
+- **Firebase Data Connect**: Auto-generated SDK in `packages/data_connect/lib/src/dataconnect_generated/`
+
+## Naming Conventions (Dart)
+
+| Type | Convention | Example |
+|------|-----------|---------|
+| Files | `snake_case` | `user_profile_page.dart` |
+| Classes | `PascalCase` | `UserProfilePage` |
+| Interfaces | suffix `Interface` | `AuthRepositoryInterface` |
+| Implementations | suffix `Impl` | `AuthRepositoryImpl` |
+
+## Key Documentation
+
+- `docs/MOBILE/00-agent-development-rules.md` — Non-negotiable architecture rules
+- `docs/MOBILE/01-architecture-principles.md` — Clean architecture details
+- `docs/MOBILE/02-design-system-usage.md` — Design system token usage
+- `docs/MOBILE/03-data-connect-connectors-pattern.md` — Backend integration pattern
+- `docs/MOBILE/05-release-process.md` — Release quick reference
+- `docs/RELEASE/mobile-releases.md` — Complete release guide
+
+## Skills & Sub-Agents
+
+#### Skills
+- The project has 4 specialized skills in `.claude/skills/` that provide deep domain knowledge. Invoke them and other global skills that you have when working in their domains.
+
+#### Sub-Agents
+- The project has 4 sub-agents in `.claude/sub-agents/` that can be invoked for specific tasks. Invoke them and other global sub-agents that you have when working in their domains.
+
+
+## CI/CD
+
+- `.github/workflows/mobile-ci.yml` — Mobile build & test on PR
+- `.github/workflows/product-release.yml` — Automated versioning, tags, APK builds
+- `.github/workflows/web-quality.yml` — Web linting & tests

Makefile

@@ -95,6 +95,7 @@ help:
 	@echo "  make install-git-hooks         Install git pre-push hook (protect main/dev)"
 	@echo "  make sync-prototypes           Sync prototypes from client-krow-poc repo"
 	@echo "  make clean-branches            Delete local branches (keeps main/dev/demo/**/protected)"
+	@echo "  make setup-mobile-ci-secrets   Setup GitHub Secrets for mobile APK signing (CI/CD)"
 	@echo ""
 	@echo "  ℹ️  HELP"
 	@echo "  ────────────────────────────────────────────────────────────────────"

README.md

@@ -1,7 +1,17 @@
+<p align="center">
+  <img src="apps/mobile/packages/design_system/assets/logo-yellow.png" alt="KROW Logo" width="200"/>
+</p>
+
 # KROW Workforce Monorepo
 
 KROW is a comprehensive workforce management platform designed to streamline operations for events, hospitality, and enterprise staffing. This monorepo contains all components of the ecosystem, from the data layer to the user-facing applications.
 
+## 📍 Current Status
+
+**Latest Milestone:** M4 (Released: March 5, 2026)
+- ✅ Staff Mobile App: [v0.0.1-m4](https://github.com/Oloodi/krow-workforce/releases/tag/krow-withus-worker-mobile%2Fdev-v0.0.1-m4)
+- ✅ Client Mobile App: [v0.0.1-m4](https://github.com/Oloodi/krow-workforce/releases/tag/krow-withus-client-mobile%2Fdev-v0.0.1-m4)
+
 ## 🚀 Repository Structure
 
 ### 📦 Apps (`/apps`)
@@ -26,6 +36,7 @@ Tools and resources for the development and operations team:
 -   **`/makefiles`**: Modularized `Makefile` logic for project automation.
 -   **`/scripts`**: Automation scripts (security, hachage, environment setup).
 -   **`/firebase`**: Global Firebase configuration (Firestore/Storage rules).
+-   **`/.github`**: GitHub Actions workflows for CI/CD and release automation.
 
 ## 🛠️ Tech Stack
 -   **Frontend:** React (Vite)
@@ -58,17 +69,56 @@ This project uses a modular `Makefile` for all common tasks.
     make launchpad-dev
     ```
 
+5.  **Mobile app development:**
+    ```bash
+    make mobile-install
+    make mobile-client-dev-android [DEVICE=android]
+    make mobile-staff-dev-android [DEVICE=android]
+    ```
+
+## 🚀 Release Process
+
+### Mobile App Releases
+
+We use GitHub Actions for automated mobile releases:
+
+- **Standard Release**: Trigger [Product Release workflow](https://github.com/Oloodi/krow-workforce/actions/workflows/product-release.yml)
+  - Auto-extracts version from `pubspec.yaml`
+  - Creates Git tags: `krow-withus-<app>-mobile/<env>-vX.Y.Z`
+  - Generates GitHub Release with CHANGELOG
+  - Builds and signs APK (dev/stage/prod keystores)
+
+- **Hotfix Release**: Trigger [Hotfix Branch Creation workflow](https://github.com/Oloodi/krow-workforce/actions/workflows/hotfix-branch-creation.yml)
+  - Auto-increments PATCH version
+  - Updates `pubspec.yaml` and `CHANGELOG.md`
+  - Creates PR with fix instructions
+
+**See:** [Mobile Release Documentation](./docs/RELEASE/mobile-releases.md) for complete guide.
+
 ## 📚 Documentation
+
+### Core Documentation
 -   **[00-vision.md](./docs/00-vision.md)**: Project objectives and guiding principles.
 -   **[01-backend-api-specification.md](./docs/01-backend-api-specification.md)**: (Legacy) Reference for data schemas.
 -   **[02-codemagic-env-vars.md](./docs/02-codemagic-env-vars.md)**: Guide for CI/CD environment variables.
 -   **[03-contributing.md](./docs/03-contributing.md)**: Guidelines for new developers and setup checklist.
 -   **[04-sync-prototypes.md](./docs/04-sync-prototypes.md)**: How to sync prototypes for local dev and AI context.
+-   **[05-project-onboarding-master.md](./docs/05-project-onboarding-master.md)**: Comprehensive onboarding guide and project overview.
 
 ### Mobile Development Documentation
+-   **[MOBILE/00-agent-development-rules.md](./docs/MOBILE/00-agent-development-rules.md)**: Rules and best practices for mobile development.
 -   **[MOBILE/01-architecture-principles.md](./docs/MOBILE/01-architecture-principles.md)**: Flutter clean architecture, package roles, and dependency flow.
 -   **[MOBILE/02-design-system-usage.md](./docs/MOBILE/02-design-system-usage.md)**: Design system components and theming guidelines.
--   **[MOBILE/00-agent-development-rules.md](./docs/MOBILE/00-agent-development-rules.md)**: Rules and best practices for mobile development.
+-   **[MOBILE/03-data-connect-connectors-pattern.md](./docs/MOBILE/03-data-connect-connectors-pattern.md)**: Data Connect integration patterns.
+-   **[MOBILE/04-use-case-completion-audit.md](./docs/MOBILE/04-use-case-completion-audit.md)**: Feature implementation status and audit.
+-   **[MOBILE/05-release-process.md](./docs/MOBILE/05-release-process.md)**: Mobile app release process (quick reference).
+
+### Release Documentation
+-   **[RELEASE/mobile-releases.md](./docs/RELEASE/mobile-releases.md)**: Comprehensive mobile release guide with versioning, CHANGELOGs, GitHub Actions workflows, and APK signing.
+
+### CHANGELOGs
+-   **[Staff Mobile CHANGELOG](./apps/mobile/apps/staff/CHANGELOG.md)**: Staff app release history (M3, M4).
+-   **[Client Mobile CHANGELOG](./apps/mobile/apps/client/CHANGELOG.md)**: Client app release history (M3, M4).
 
 ## 🤝 Contributing
 New to the team? Please read our **[Contributing Guide](./docs/03-contributing.md)** to get your environment set up and understand our workflow.

apps/mobile/NEXT_SPRINT_TASKS.md

@@ -1,175 +0,0 @@
-## Recommended tasks for the next sprint
-
-
-* In the mobile applications, since the structure is now finalized (at least for the existing features), we need to **strictly follow best practices while coding**:
-  * Break down large widgets into **smaller, reusable widgets**
-  * Add **doc comments** where necessary to improve readability and maintainability
-  * **Remove overly complicated or unnecessary logic** introduced by AI and simplify where possible
-* Improvement points
-- apps/mobile/packages/features/client/client_coverage/lib/src/data/repositories_impl/coverage_repository_impl.dart
-  - Fix the location field in CoverageShiftRole to use the correct fallback logic.
-  - line 125 remove redundant location values.
-
-- Change the name of the dataconnect connector replacing the "ExampleConnecter" with "KrowConnecter" 
-
-- `  final String status;` in `OrderItem` make it an enum.
--  /// Date of the shift (ISO format).
-  final String date; make this in the DateTime format instead of string.
-
-- in `view_orders_cubit.dart` combine the logic of `_calculateUpNextCount ` and `_calculateTodayCount` into a single function that calculates both counts together to avoid redundant filtering of orders.
-- In places api call in the when the api's not working we need to show a proper error message instead of just an empty list.
-- pending should come first in the view order list.
-
-
-
-
-- How to check if the shift can be accepted by a worker?
-  - if a shift is already accepted in that time
-
-- track minimum shift hours in the staff profile and show a warning if they try to apply for shifts that are below their minimum hours.
-  - this need to be added in the BE and also a FE validation (5 hrs).
-
-- Cannot cancel before 24 hours of the shift start time. If do we should charge for 4 hours of work for each shifts.
-
-- verify the order creation process in the client app.
-  - Vendor don't need to verify the order, when the order is created it should be automatically published.
-  - rethink the order status, we need to simplify it.
-
-- Validation layer
-  - Profile info
-  - emergency contact
-  - experiences
-  - attires
-    - there should be manual verification by the client even if the ai verification is passed.
-    - to track false positives and false negatives.
-  - certifications
-    - there should be manual verification by the client even if the ai verification is passed.
-    - to track false positives and false negatives.
-  - documents
-  - tax forms
-
-- How do we handle the current bank account verifcaiton in the current legacy application.
-- We need have a show a list of clothing items in the staff app -> shift page.
-- Template models for the pdf reports in the client and web apps.
-- remove `any` type and replace it with the correct types in the codebase.
-
-
-- What is the worker signup process
-
-
-
-
-
-
-
-# Developement Tasks
-
-## BE
-- Shift acceptance validation by a worker
-  - How do we check if a shift can be accepted by a worker?
-    - if a shift is already accepted in that time
-    - we need to prevent accepting overlapping shifts.
-    - Make the alogrithm sclable which enables to add future rules for shift acceptance.
-    - This validation should be done in BE.
-- Shift creation validation by a client
-  - Implement validation logic to ensure that shifts created by clients meet certain criteria
-  - This validation should be done in BE.
-  - CURRENTLY only add a Soft check for minimum shift hours when creating an order by a client
-    - When a client is creating an order, we need to check if the shift hours are below the minimum hours set by the vendor.
-    - This validation should be done in BE and also a FE validation
-    - Current minimum hours is 5 hrs.
-  - Make the alogrithm sclable which enables to add future rules for shift acceptance.
-- Cancellation policy enforcement
-  - Implement logic to prevent cancellations within 24 hours of shift start time.
-  - If a cancellation is attempted within this window
-   - We need to finalise the penalty for this cancellation.
-- Documentation upload process
-    - Implement a secure and efficient process for workers to upload required documentation (e.g., certifications, tax forms).
-    - Ensure that the uploaded documents are properly stored and linked to the worker's profile.
-- Documentation parsing
-  - Implement a system to parse and extract relevant information from uploaded documents (e.g., certifications, tax forms) for verification purposes.
-  - there should be manual verification by the client even if the ai verification is passed.
-- Attire upload
-    - Implement a system for workers to upload images of their attire for verification purposes.
-- Attire verification
-    - Implement a system to verify the uploaded attire images against the required dress code for shifts.
-    - there should be manual verification by the client even if the ai verification is passed.
-- Shift that require "awaiting confirmation" status
-  - Implement logic to handle shifts that require "awaiting confirmation" status, where the worker needs to manually confirm the shift before it becomes active.
-- Enable NFC-based clock-in and clock-out functionality for staff members, allowing them to easily record their attendance using NFC technology (BE tasks).
-- Enable worker profile visibility, where the worker's can hide their profile from clients if they choose to, and implement the necessary logic to handle profile visibility settings (BE tasks).
-- Rapid order parsing (voice and text) using AI, allowing clients to quickly create orders by simply describing their needs, and implementing the necessary logic to parse and interpret the client's input to create accurate orders (BE tasks)
-  - This is always mapped similar to one time order creation.
-
-## FE
-
-### Staff mobile application
-- Show google maps location in the shift details page in the woker app.
-- Add a requirment section in the shift details page in the worker app which shows the requirements for that shift.
-- Attire screen
-  - Show the list of MUST HAVE attire items.
-  - Show the list of NICE TO HAVE attire items.
-  - Allow workers to upload images of their attire for verification purposes.
-  - Show the list of uploaded attire images in the worker profile.
-- FAQ screen in the worker app.
-- Privacy and Security screen in the worker app.
-  - Profile visbility setting
-  - Terms of services (For now use a generated one but we need to have a proper one for the launch)
-  - Privacy policy (For now use a generated one but we need to have a proper one for the launch)
-
-### Client mobile application
-- Implement the remaining order types
- - Rapid order creation using voicd and text input, allowing clients to quickly create orders by simply describing their needs, and implementing the necessary UI and logic to parse and interpret the client's input to create accurate orders (FE tasks).
-   - After parsing this should be populated in the screen similar to one time order creation screen where the client can make any necessary adjustments before finalising the order.
-   - This is always mapped similar to one time order creation as this only handles same day orders.
-
-# Research Tasks
-- How do we validate the SSN number of a worker in the US?
-  - Research third-party services or APIs that provide SSN validation.
-  - Evaluate the cost, reliability, and ease of integration of these services.
-  - Plan the integration process and identify any potential challenges.
-- How do we validate the bank account details of a worker in the US?
-  - Research third-party services or APIs that provide bank account validation.
-  - Evaluate the cost, reliability, and ease of integration of these services.
-  - Plan the integration process and identify any potential challenges.
-  - In the legacy application we are only using soft FE checks but we need to have a proper validation process.
-- What are the payment platforms we want to integrate for processing payments to workers?
-  - Research popular payment platforms (e.g., Stripe, PayPal, Square) that support payouts to workers.
-  - Evaluate the cost, reliability, and ease of integration of these platforms.
-  - Plan the integration process and identify any potential challenges.
-- Implement test cases for 2 features in the web dashboard to be run in the agent browser (https://agent-browser.dev/)
-  - Research how to implement test cases for web applications using the agent browser.
-
-
-# Business Tasks
-- Create a template models for the pdf reports in the client and web apps.
-- How do we handle situations like
-  - If a worker is a no-show for a shift.
-  - If the certain shifts are not getting enough applicants.
-  - These situtations hevaly disadvantages the clients and we need to have a clear policy on how to handle these situations.
-- Terms of service and privacy policy for the mobile applications.
-- How to handle the data request from worker side.
-- Having a discussion about rephrasing certain termeniologies in the application
-  - Meaning of the worker registration process, is it signup or onboarding, because we are not doing a proper signup process where the worker can create an account by themselves, instead we are doing an onboarding process where the worker needs to provide their phone number and then we create an account for them and send them the OTP to login, as they should be already attached to a vendor when they are providing their phone number, we can consider this as an onboarding process rather than a signup process.
-  - Meaning of the worker profile visibility, is it "profile visibility" or "availability status", because the worker is not making their profile completely invisible to the clients, instead they are just marking themselves as unavailable for work, so we can consider this as "availability status" rather than "profile visibility".
-
-
-- Meaning of the the auto match ?
-  - Shouldn't we do this any way ?
-  - Is this only a marketing item ?
-
-
-- Validation layer
-  - Profile info
-  - emergency contact
-  - experiences
-  - attires
-    - there should be manual verification by the client even if the ai verification is passed.
-    - to track false positives and false negatives.
-  - certifications
-    - there should be manual verification by the client even if the ai verification is passed.
-    - to track false positives and false negatives.
-  - documents
-  - tax forms
-
-- We need have a show a list of clothing items in the staff app -> shift page.

apps/mobile/apps/client/CHANGELOG.md

@@ -0,0 +1,230 @@
+# Client Mobile App - Change Log
+
+## [v0.0.1-m3] - Milestone 3 - 2026-02-15
+
+### Added - Authentication & Onboarding
+- Business email and password authentication
+- Client account registration
+- Business onboarding flow
+- Company information setup
+
+### Added - Home Dashboard
+- Welcome screen with business name
+- Coverage statistics for today:
+  - Coverage percentage
+  - Workers checked in vs needed
+  - Open positions count
+- Late workers alerts with visual indicators
+- Today's estimated labor cost
+- Upcoming shifts section
+- Quick action buttons:
+  - Create Order
+  - Hubs management
+
+### Added - Hub Management
+- Hubs page accessible from settings
+- Hub creation flow:
+  - Hub name input
+  - Address autocomplete with Google Maps Places API
+  - Hub creation confirmation
+- Hubs list view showing all created hubs
+- Hub card display with name, address, and tag ID
+
+### Added - Order Creation
+- Orders tab in bottom navigation
+- "+ Post" button to create new orders
+- Order type selection screen:
+  - One-Time orders (implemented)
+- One-Time Order creation form:
+  - Order name
+  - Date picker
+  - Hub selection
+  - Position management:
+    - Role selection
+    - Worker count
+    - Start/end time
+    - Shift duration calculation
+  - Cost estimation
+- Order creation confirmation
+
+### Added - Order Management
+- Orders list view with:
+  - Order cards showing date, location, time
+  - Worker count (filled/needed)
+  - Coverage percentage bar
+  - Status indicators (OPEN, FILLED, IN PROGRESS)
+- Order details view:
+  - Event name and location
+  - Roles and worker requirements
+  - Clock in/out times
+  - Estimated cost
+  - Coverage percentage
+  - Map integration with directions
+
+### Added - Coverage Monitoring
+- Coverage tab in bottom navigation
+- Real-time worker status dashboard:
+  - Checked In (green indicator)
+  - En Route (yellow indicator)
+  - Late (red indicator)
+  - Not Arrived status
+- Color-coded status badges
+- Worker information cards
+- Active shift monitoring
+
+### Added - Navigation
+- Bottom navigation bar with tabs:
+  - Coverage
+  - Billing
+  - Home
+  - Orders
+  - Reports
+- Settings menu accessible from home screen
+- Back navigation handling
+
+### Added - Settings
+- Settings page with options:
+  - Hubs management
+  - Profile editing
+  - Notifications preferences
+  - Log out
+
+### Technical Features
+- Firebase authentication integration
+- Data Connect backend integration
+- Google Maps Places API for address autocomplete
+- Real-time worker status tracking
+- Cost calculation engine
+- Coverage percentage calculations
+
+### Known Limitations
+- Orders require hub assignment
+- Currently supports one-time orders only
+- Order approval flow not yet implemented
+- RAPID, Recurring, and Permanent order types are placeholders
+
+---
+
+## [v0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added - Enhanced Authentication & Session Management
+- Authentication session persistence across app restarts
+- Automatic login with valid session tokens
+- Improved user experience with seamless session handling
+
+### Added - RAPID Order Creation (AI-Powered)
+- Voice input for order creation with audio recording
+- Text input for order description
+- Multi-platform audio recording support (iOS/Android)
+- AI transcription service for voice-to-text conversion
+- AI parsing to generate order drafts from natural language
+- Same-day order support for urgent coverage needs
+- Populated order form matching one-time order structure
+- Edit AI-generated order before submission
+- Quick order creation workflow
+- Audio file upload for transcription
+- RAPID order verification page with refinements
+- Hub and role matching for order creation
+
+### Added - Recurring Order Support
+- Recurring order creation flow
+- Schedule configuration interface
+- Recurring patterns (daily, weekly, custom)
+- Recurring order management
+
+### Added - Permanent Order Support
+- Permanent order creation flow
+- Long-term position setup
+- Permanent order management
+
+### Added - Enhanced Order Management
+- Hide edit icon for past or completed orders
+- Updated Reorder modal supporting all order types:
+  - One-Time reorder
+  - RAPID reorder
+  - Recurring reorder
+  - Permanent reorder
+- Reorder functionality with order type awareness
+- Hub manager assignment to orders
+- Cost center entity linking to hubs
+- Completion review UI with:
+  - Actions summary
+  - Amount display
+  - Info sections
+  - Worker listing
+- Invoice management improvements
+
+### Added - Comprehensive Reports System
+- Reports page with AI-powered insights
+- Three AI-generated insights on reports landing page
+- Six report types:
+  1. **Daily Ops Report**: Daily operational metrics and statistics
+  2. **Spend Report**: Labor cost analysis and spend tracking
+  3. **Coverage Report**: Shift coverage analytics and trends
+  4. **No-Show Report**: Worker attendance and no-show tracking
+  5. **Performance Report**: Worker performance metrics and ratings
+  6. *(Reserved for future report type)*
+
+### Added - Hub Management Enhancements
+- Dedicated hub details interface
+- Detailed hub information view
+- Hub editing page (separate interface)
+- Enhanced hub navigation
+
+### Added - Home Dashboard Enhancements
+- Reorder quick action button
+### Added - Home Dashboard Enhancements
+- Reorder quick action button for fast order duplication
+- Insights quick action button for AI analytics
+- Direct access to AI insights from home
+- Refactored home widgets with SectionLayout:
+  - Today's shifts section with titles
+  - Tomorrow's shifts section
+  - Coverage widget improvements
+  - Live activity widget enhancements
+  - Spending widget updates
+- Full-width dividers for better visual separation
+- Improved dashboard widget organization
+
+### Improved - User Experience
+- Better order type selection flow
+- Enhanced order creation UX across all types
+- Improved reports navigation
+- Better hub management interface
+- Bottom navigation bar show/hide based on route changes
+- Enhanced navigation robustness with error handling
+- Improved invoice page layout with reordered titles
+- Session management improvements with proper role validation
+- Enhanced settings page navigation flow
+- Better amount widget styling in completion review
+
+### Fixed
+- Client app crash issues resolved
+- Shift booking status inconsistencies fixed
+- Session navigation errors corrected
+- Formatting and code clarity improvements across codebase
+
+### Technical Features
+- Backend transaction support for order creation
+- Order validation (minimum hours check)
+- Shift creation validation
+- 24-hour cancellation policy enforcement
+- Enhanced backend reporting APIs
+- AI insights generation system
+- Core API integration:
+  - RAPID order transcription endpoints
+  - Order parsing services  
+  - File upload with signed URLs
+  - LLM services
+- ApiService with Dio for standardized API requests
+- DataConnectService integration across all repositories
+- Enhanced session management with SessionListener
+- Role-based session handling
+
+### Known Limitations
+- RAPID order parsing requires clear voice/text input
+- AI insights require sufficient historical data
+- Reports may have limited data in early usage
+- PDF export for reports not yet implemented
+
+---

apps/mobile/apps/client/android/app/build.gradle.kts

@@ -21,8 +21,20 @@ dartDefinesString.split(",").forEach {
     }
 }
 
+// Load flavor-specific key properties: key.dev.properties, key.stage.properties, key.prod.properties
+// The active flavor is resolved from the Gradle task name (e.g. assembleDevRelease -> dev)
+fun resolveFlavorFromTask(): String {
+    val taskNames = gradle.startParameter.taskNames.joinToString(" ").lowercase()
+    return when {
+        taskNames.contains("prod") -> "prod"
+        taskNames.contains("stage") -> "stage"
+        else -> "dev"
+    }
+}
+
+val activeFlavorForSigning = resolveFlavorFromTask()
 val keystoreProperties = Properties().apply {
-    val propertiesFile = rootProject.file("key.properties")
+    val propertiesFile = rootProject.file("key.${activeFlavorForSigning}.properties")
     if (propertiesFile.exists()) {
         load(propertiesFile.inputStream())
     }
@@ -43,28 +55,44 @@ android {
     }
 
     defaultConfig {
-        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
-        applicationId = "com.krowwithus.client"
-        // You can update the following values to match your application needs.
+        // applicationId is set per flavor below
         // For more information, see: https://flutter.dev/to/review-gradle-config.
         minSdk = flutter.minSdkVersion
         targetSdk = flutter.targetSdkVersion
         versionCode = flutter.versionCode
         versionName = flutter.versionName
-
         manifestPlaceholders["GOOGLE_MAPS_API_KEY"] = dartEnvironmentVariables["GOOGLE_MAPS_API_KEY"] ?: ""
     }
 
+    flavorDimensions += "environment"
+    productFlavors {
+        create("dev") {
+            dimension = "environment"
+            applicationId = "dev.krowwithus.client"
+            resValue("string", "app_name", "KROW With Us Business [DEV]")
+        }
+        create("stage") {
+            dimension = "environment"
+            applicationId = "stage.krowwithus.client"
+            resValue("string", "app_name", "KROW With Us Business [STG]")
+        }
+        create("prod") {
+            dimension = "environment"
+            applicationId = "prod.krowwithus.client"
+            resValue("string", "app_name", "KROW Client")
+        }
+    }
+
     signingConfigs {
         create("release") {
             if (System.getenv()["CI"] == "true") {
                 // CodeMagic CI environment
-                storeFile = file(System.getenv()["CM_KEYSTORE_PATH_CLIENT"] ?: "")
-                storePassword = System.getenv()["CM_KEYSTORE_PASSWORD_CLIENT"]
-                keyAlias = System.getenv()["CM_KEY_ALIAS_CLIENT"]
-                keyPassword = System.getenv()["CM_KEY_PASSWORD_CLIENT"]
+                storeFile = file(System.getenv()["CM_KEYSTORE_PATH"] ?: "")
+                storePassword = System.getenv()["CM_KEYSTORE_PASSWORD"]
+                keyAlias = System.getenv()["CM_KEY_ALIAS"]
+                keyPassword = System.getenv()["CM_KEY_PASSWORD"]
             } else {
-                // Local development environment
+                // Local development environment — loads from key.<flavor>.properties
                 keyAlias = keystoreProperties["keyAlias"] as String?
                 keyPassword = keystoreProperties["keyPassword"] as String?
                 storeFile = keystoreProperties["storeFile"]?.let { file(it) }
@@ -75,13 +103,25 @@ android {
 
     buildTypes {
         release {
-            // TODO: Add your own signing config for the release build.
-            // Signing with the debug keys for now, so `flutter run --release` works.
             signingConfig = signingConfigs.getByName("release")
         }
     }
 }
 
+// Skip google-services processing for flavors whose google-services.json
+// contains placeholder values (e.g. prod before the Firebase project exists).
+// Once a real config is dropped in, the task automatically re-enables.
+afterEvaluate {
+    tasks.matching {
+        it.name.startsWith("process") && it.name.endsWith("GoogleServices")
+    }.configureEach {
+        val taskFlavor = name.removePrefix("process").removeSuffix("GoogleServices")
+            .removeSuffix("Debug").removeSuffix("Release").lowercase()
+        val configFile = file("src/$taskFlavor/google-services.json")
+        enabled = configFile.exists() && configFile.readText().contains("\"mobilesdk_app_id\": \"1:")
+    }
+}
+
 flutter {
     source = "../.."
 }

apps/mobile/apps/client/android/app/src/dev/google-services.json

@@ -5,78 +5,6 @@
     "storage_bucket": "krow-workforce-dev.firebasestorage.app"
   },
   "client": [
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:edcddb83ea4bbb517757db",
-        "android_client_info": {
-          "package_name": "com.krow.app.business.dev"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krowwithus.staff"
-              }
-            }
-          ]
-        }
-      }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:d49b8c0f4d19e95e7757db",
-        "android_client_info": {
-          "package_name": "com.krow.app.staff.dev"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krowwithus.staff"
-              }
-            }
-          ]
-        }
-      }
-    },
     {
       "client_info": {
         "mobilesdk_app_id": "1:933560802882:android:da13569105659ead7757db",
@@ -164,6 +92,78 @@
           ]
         }
       }
+    },
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:933560802882:android:1eb46251032273cb7757db",
+        "android_client_info": {
+          "package_name": "dev.krowwithus.client"
+        }
+      },
+      "oauth_client": [
+        {
+          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+          "client_type": 3
+        }
+      ],
+      "api_key": [
+        {
+          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": [
+            {
+              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+              "client_type": 3
+            },
+            {
+              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
+              "client_type": 2,
+              "ios_info": {
+                "bundle_id": "com.krowwithus.staff"
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:933560802882:android:ee100eab75b6b04c7757db",
+        "android_client_info": {
+          "package_name": "dev.krowwithus.staff"
+        }
+      },
+      "oauth_client": [
+        {
+          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+          "client_type": 3
+        }
+      ],
+      "api_key": [
+        {
+          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": [
+            {
+              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+              "client_type": 3
+            },
+            {
+              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
+              "client_type": 2,
+              "ios_info": {
+                "bundle_id": "com.krowwithus.staff"
+              }
+            }
+          ]
+        }
+      }
     }
   ],
   "configuration_version": "1"

apps/mobile/apps/client/android/app/src/main/AndroidManifest.xml

@@ -1,6 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <application
-        android:label="KROW With Us Client"
+        android:label="@string/app_name"
         android:name="${applicationName}"
         android:icon="@mipmap/launcher_icon">
         <activity

apps/mobile/apps/client/android/app/src/stage/google-services.json

@@ -0,0 +1,48 @@
+{
+  "project_info": {
+    "project_number": "1032971403708",
+    "project_id": "krow-workforce-staging",
+    "storage_bucket": "krow-workforce-staging.firebasestorage.app"
+  },
+  "client": [
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:1032971403708:android:1ab9badf171c3aca356bb9",
+        "android_client_info": {
+          "package_name": "stage.krowwithus.client"
+        }
+      },
+      "oauth_client": [],
+      "api_key": [
+        {
+          "current_key": "AIzaSyAZ4dOatvf3ZBt4qnbSlIvJ51bblHaRsRw"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": []
+        }
+      }
+    },
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:1032971403708:android:14e471d055e59597356bb9",
+        "android_client_info": {
+          "package_name": "stage.krowwithus.staff"
+        }
+      },
+      "oauth_client": [],
+      "api_key": [
+        {
+          "current_key": "AIzaSyAZ4dOatvf3ZBt4qnbSlIvJ51bblHaRsRw"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": []
+        }
+      }
+    }
+  ],
+  "configuration_version": "1"
+}

apps/mobile/apps/client/android/key.prod.properties

@@ -0,0 +1,9 @@
+storePassword=krowwithus
+keyPassword=krowwithus
+keyAlias=krow_client_prod
+storeFile=krow_with_us_client_prod.jks
+
+###
+### Client Prod
+### SHA1: B2:80:46:90:7F:E5:9E:86:62:7B:06:90:AC:C0:20:02:73:5B:20:5C
+### SHA256: D8:3C:B0:07:B5:95:3C:82:2F:2C:A9:F6:8D:6F:77:B9:31:9D:BE:E9:74:4A:59:D9:7F:DC:EB:E2:C6:26:AB:27

apps/mobile/apps/client/android/key.stage.properties

@@ -0,0 +1,9 @@
+storePassword=krowwithus
+keyPassword=krowwithus
+keyAlias=krow_client_stage
+storeFile=krow_with_us_client_stage.jks
+
+###
+### Client Stage
+### SHA1: 89:9F:12:9E:A5:18:AC:1D:75:73:29:0B:F2:C2:E6:EB:38:B0:F0:A0
+### SHA256: 80:13:10:CB:88:A8:8D:E9:F6:9E:D6:55:53:9C:BE:2D:D4:9C:7A:26:56:A3:E9:70:7C:F5:9A:A7:20:1A:6D:FE

apps/mobile/apps/client/firebase.json

@@ -1 +1,31 @@
-{"flutter":{"platforms":{"android":{"default":{"projectId":"krow-workforce-dev","appId":"1:933560802882:android:da13569105659ead7757db","fileOutput":"android/app/google-services.json"}},"ios":{"default":{"projectId":"krow-workforce-dev","appId":"1:933560802882:ios:d2b6d743608e2a527757db","uploadDebugSymbols":false,"fileOutput":"ios/Runner/GoogleService-Info.plist"}},"dart":{"lib/firebase_options.dart":{"projectId":"krow-workforce-dev","configurations":{"android":"1:933560802882:android:da13569105659ead7757db","ios":"1:933560802882:ios:d2b6d743608e2a527757db","web":"1:933560802882:web:173a841992885bb27757db"}}}}}}
+{
+    "flutter": {
+        "platforms": {
+            "android": {
+                "default": {
+                    "projectId": "krow-workforce-dev",
+                    "appId": "1:933560802882:android:da13569105659ead7757db",
+                    "fileOutput": "android/app/google-services.json"
+                }
+            },
+            "ios": {
+                "default": {
+                    "projectId": "krow-workforce-dev",
+                    "appId": "1:933560802882:ios:d2b6d743608e2a527757db",
+                    "uploadDebugSymbols": false,
+                    "fileOutput": "ios/Runner/GoogleService-Info.plist"
+                }
+            },
+            "dart": {
+                "lib/firebase_options.dart": {
+                    "projectId": "krow-workforce-dev",
+                    "configurations": {
+                        "android": "1:933560802882:android:da13569105659ead7757db",
+                        "ios": "1:933560802882:ios:d2b6d743608e2a527757db",
+                        "web": "1:933560802882:web:173a841992885bb27757db"
+                    }
+                }
+            }
+        }
+    }
+}

apps/mobile/apps/client/ios/Runner.xcodeproj/project.pbxproj

@@ -149,6 +149,7 @@
 			buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */;
 			buildPhases = (
 				9740EEB61CF901F6004384FC /* Run Script */,
+				BC26E38F2F5F614000517BDF /* ShellScript */,
 				97C146EA1CF9000F007C117D /* Sources */,
 				97C146EB1CF9000F007C117D /* Frameworks */,
 				97C146EC1CF9000F007C117D /* Resources */,
@@ -257,6 +258,24 @@
 			shellPath = /bin/sh;
 			shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build";
 		};
+		BC26E38F2F5F614000517BDF /* ShellScript */ = {
+			isa = PBXShellScriptBuildPhase;
+			alwaysOutOfDate = 1;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+			);
+			inputPaths = (
+			);
+			outputFileListPaths = (
+			);
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "# Tye a script or drag a script file from your workspace to insert its path.\n$PROJECT_DIR/scripts/copy-firebase-config.sh\n\n";
+		};
 /* End PBXShellScriptBuildPhase section */
 
 /* Begin PBXSourcesBuildPhase section */
@@ -363,6 +382,7 @@
 			isa = XCBuildConfiguration;
 			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
 			buildSettings = {
+				APP_NAME = "KROW With Us Business [STAGE]";
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
@@ -372,7 +392,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.client;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_VERSION = 5.0;
@@ -542,6 +562,7 @@
 			isa = XCBuildConfiguration;
 			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
 			buildSettings = {
+				APP_NAME = "KROW With Us Business [DEV] ";
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
@@ -551,7 +572,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.client;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
@@ -564,6 +585,7 @@
 			isa = XCBuildConfiguration;
 			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
 			buildSettings = {
+				APP_NAME = "KROW With Us Business";
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
@@ -573,7 +595,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.client;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_VERSION = 5.0;
@@ -581,6 +603,837 @@
 			};
 			name = Release;
 		};
+		BC26E3562F5F5AC000517BDF /* Debug-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = "Debug-dev";
+		};
+		BC26E3572F5F5AC000517BDF /* Debug-dev */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business [DEV] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Debug-dev";
+		};
+		BC26E3582F5F5AC000517BDF /* Debug-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Debug-dev";
+		};
+		BC26E3592F5F5AC500517BDF /* Debug-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = "Debug-stage";
+		};
+		BC26E35A2F5F5AC500517BDF /* Debug-stage */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business [STAGE] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Debug-stage";
+		};
+		BC26E35B2F5F5AC500517BDF /* Debug-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Debug-stage";
+		};
+		BC26E35C2F5F5ACB00517BDF /* Debug-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = "Debug-prod";
+		};
+		BC26E35D2F5F5ACB00517BDF /* Debug-prod */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Debug-prod";
+		};
+		BC26E35E2F5F5ACB00517BDF /* Debug-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Debug-prod";
+		};
+		BC26E35F2F5F5AD200517BDF /* Profile-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Profile-dev";
+		};
+		BC26E3602F5F5AD200517BDF /* Profile-dev */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business [DEV] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Profile-dev";
+		};
+		BC26E3612F5F5AD200517BDF /* Profile-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Profile-dev";
+		};
+		BC26E3622F5F5AD800517BDF /* Profile-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Profile-stage";
+		};
+		BC26E3632F5F5AD800517BDF /* Profile-stage */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business [STAGE]";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Profile-stage";
+		};
+		BC26E3642F5F5AD800517BDF /* Profile-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Profile-stage";
+		};
+		BC26E3652F5F5AE300517BDF /* Profile-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Profile-prod";
+		};
+		BC26E3662F5F5AE300517BDF /* Profile-prod */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Profile-prod";
+		};
+		BC26E3672F5F5AE300517BDF /* Profile-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Profile-prod";
+		};
+		BC26E3682F5F5AE800517BDF /* Release-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Release-dev";
+		};
+		BC26E3692F5F5AE800517BDF /* Release-dev */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business [DEV] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Release-dev";
+		};
+		BC26E36A2F5F5AE800517BDF /* Release-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Release-dev";
+		};
+		BC26E36B2F5F5AED00517BDF /* Release-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Release-stage";
+		};
+		BC26E36C2F5F5AED00517BDF /* Release-stage */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business [STAGE] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Release-stage";
+		};
+		BC26E36D2F5F5AED00517BDF /* Release-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Release-stage";
+		};
+		BC26E36E2F5F5AF300517BDF /* Release-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Release-prod";
+		};
+		BC26E36F2F5F5AF300517BDF /* Release-prod */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us Business";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Release-prod";
+		};
+		BC26E3702F5F5AF300517BDF /* Release-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.client;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Release-prod";
+		};
 /* End XCBuildConfiguration section */
 
 /* Begin XCConfigurationList section */
@@ -588,8 +1441,17 @@
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				331C8088294A63A400263BE5 /* Debug */,
+				BC26E35E2F5F5ACB00517BDF /* Debug-prod */,
+				BC26E35B2F5F5AC500517BDF /* Debug-stage */,
+				BC26E3582F5F5AC000517BDF /* Debug-dev */,
 				331C8089294A63A400263BE5 /* Release */,
+				BC26E3702F5F5AF300517BDF /* Release-prod */,
+				BC26E36D2F5F5AED00517BDF /* Release-stage */,
+				BC26E36A2F5F5AE800517BDF /* Release-dev */,
 				331C808A294A63A400263BE5 /* Profile */,
+				BC26E3672F5F5AE300517BDF /* Profile-prod */,
+				BC26E3642F5F5AD800517BDF /* Profile-stage */,
+				BC26E3612F5F5AD200517BDF /* Profile-dev */,
 			);
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
@@ -598,8 +1460,17 @@
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				97C147031CF9000F007C117D /* Debug */,
+				BC26E35C2F5F5ACB00517BDF /* Debug-prod */,
+				BC26E3592F5F5AC500517BDF /* Debug-stage */,
+				BC26E3562F5F5AC000517BDF /* Debug-dev */,
 				97C147041CF9000F007C117D /* Release */,
+				BC26E36E2F5F5AF300517BDF /* Release-prod */,
+				BC26E36B2F5F5AED00517BDF /* Release-stage */,
+				BC26E3682F5F5AE800517BDF /* Release-dev */,
 				249021D3217E4FDB00AE95B9 /* Profile */,
+				BC26E3652F5F5AE300517BDF /* Profile-prod */,
+				BC26E3622F5F5AD800517BDF /* Profile-stage */,
+				BC26E35F2F5F5AD200517BDF /* Profile-dev */,
 			);
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
@@ -608,8 +1479,17 @@
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				97C147061CF9000F007C117D /* Debug */,
+				BC26E35D2F5F5ACB00517BDF /* Debug-prod */,
+				BC26E35A2F5F5AC500517BDF /* Debug-stage */,
+				BC26E3572F5F5AC000517BDF /* Debug-dev */,
 				97C147071CF9000F007C117D /* Release */,
+				BC26E36F2F5F5AF300517BDF /* Release-prod */,
+				BC26E36C2F5F5AED00517BDF /* Release-stage */,
+				BC26E3692F5F5AE800517BDF /* Release-dev */,
 				249021D4217E4FDB00AE95B9 /* Profile */,
+				BC26E3662F5F5AE300517BDF /* Profile-prod */,
+				BC26E3632F5F5AD800517BDF /* Profile-stage */,
+				BC26E3602F5F5AD200517BDF /* Profile-dev */,
 			);
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;

apps/mobile/apps/client/ios/Runner.xcodeproj/xcshareddata/xcschemes/dev.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "2630"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug-dev"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug-dev"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Profile-dev"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug-dev">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release-dev"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

apps/mobile/apps/client/ios/Runner.xcodeproj/xcshareddata/xcschemes/prod.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "2630"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug-prod"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug-prod"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Profile-prod"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug-prod">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release-prod"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

apps/mobile/apps/client/ios/Runner.xcodeproj/xcshareddata/xcschemes/stage.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "2630"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug-stage"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug-stage"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Profile-stage"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug-stage">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release-stage"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

apps/mobile/apps/client/ios/Runner/Info.plist

@@ -5,7 +5,7 @@
 	<key>CFBundleDevelopmentRegion</key>
 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 	<key>CFBundleDisplayName</key>
-	<string>KROW With Us Client</string>
+	<string>$(APP_NAME)</string>
 	<key>CFBundleExecutable</key>
 	<string>$(EXECUTABLE_NAME)</string>
 	<key>CFBundleIdentifier</key>
@@ -13,7 +13,7 @@
 	<key>CFBundleInfoDictionaryVersion</key>
 	<string>6.0</string>
 	<key>CFBundleName</key>
-	<string>KROW With Us Client</string>
+	<string>$(APP_NAME)</string>
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>

apps/mobile/apps/client/ios/config/dev/GoogleService-Info.plist

@@ -3,9 +3,9 @@
 <plist version="1.0">
 <dict>
 	<key>CLIENT_ID</key>
-	<string>933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com</string>
+	<string>933560802882-jpv087j5jenp1h63mc9ge51767s3l2ac.apps.googleusercontent.com</string>
 	<key>REVERSED_CLIENT_ID</key>
-	<string>com.googleusercontent.apps.933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh</string>
+	<string>com.googleusercontent.apps.933560802882-jpv087j5jenp1h63mc9ge51767s3l2ac</string>
 	<key>ANDROID_CLIENT_ID</key>
 	<string>933560802882-fbqg2icq24bmci3f84evjrbth5huh87f.apps.googleusercontent.com</string>
 	<key>API_KEY</key>
@@ -15,7 +15,7 @@
 	<key>PLIST_VERSION</key>
 	<string>1</string>
 	<key>BUNDLE_ID</key>
-	<string>com.krowwithus.staff</string>
+	<string>dev.krowwithus.client</string>
 	<key>PROJECT_ID</key>
 	<string>krow-workforce-dev</string>
 	<key>STORAGE_BUCKET</key>
@@ -31,6 +31,6 @@
 	<key>IS_SIGNIN_ENABLED</key>
 	<true></true>
 	<key>GOOGLE_APP_ID</key>
-	<string>1:933560802882:ios:fa584205b356de937757db</string>
+	<string>1:933560802882:ios:7e179dfdd1a8994c7757db</string>
 </dict>
 </plist>

apps/mobile/apps/client/ios/config/stage/GoogleService-Info.plist

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>API_KEY</key>
+	<string>AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY</string>
+	<key>GCM_SENDER_ID</key>
+	<string>1032971403708</string>
+	<key>PLIST_VERSION</key>
+	<string>1</string>
+	<key>BUNDLE_ID</key>
+	<string>stage.krowwithus.client</string>
+	<key>PROJECT_ID</key>
+	<string>krow-workforce-staging</string>
+	<key>STORAGE_BUCKET</key>
+	<string>krow-workforce-staging.firebasestorage.app</string>
+	<key>IS_ADS_ENABLED</key>
+	<false></false>
+	<key>IS_ANALYTICS_ENABLED</key>
+	<false></false>
+	<key>IS_APPINVITE_ENABLED</key>
+	<true></true>
+	<key>IS_GCM_ENABLED</key>
+	<true></true>
+	<key>IS_SIGNIN_ENABLED</key>
+	<true></true>
+	<key>GOOGLE_APP_ID</key>
+	<string>1:1032971403708:ios:0ff547e80f5324ed356bb9</string>
+</dict>
+</plist>

apps/mobile/apps/client/ios/scripts/firebase-config.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Copy the correct GoogleService-Info.plist based on the build configuration.
+# This script should be added as a "Run Script" build phase in Xcode,
+# BEFORE the "Compile Sources" phase.
+#
+# The FLUTTER_FLAVOR environment variable is set by Flutter when building
+# with --flavor. It maps to: dev, stage, prod.
+
+FLAVOR="${FLUTTER_FLAVOR:-dev}"
+PLIST_SOURCE="${PROJECT_DIR}/config/${FLAVOR}/GoogleService-Info.plist"
+PLIST_DEST="${PROJECT_DIR}/Runner/GoogleService-Info.plist"
+
+if [ ! -f "$PLIST_SOURCE" ]; then
+  echo "error: GoogleService-Info.plist not found for flavor '${FLAVOR}' at ${PLIST_SOURCE}"
+  exit 1
+fi
+
+echo "Copying GoogleService-Info.plist for flavor: ${FLAVOR}"
+cp "${PLIST_SOURCE}" "${PLIST_DEST}"

apps/mobile/apps/client/lib/firebase_options.dart

@@ -1,44 +1,22 @@
-// File generated by FlutterFire CLI.
-
 import 'package:firebase_core/firebase_core.dart' show FirebaseOptions;
 import 'package:flutter/foundation.dart'
     show defaultTargetPlatform, kIsWeb, TargetPlatform;
+import 'package:krow_core/core.dart';
 
-/// Default [FirebaseOptions] for use with your Firebase apps.
+/// Environment-aware [FirebaseOptions] for the Client app.
 ///
-/// Example:
-/// ```dart
-/// import 'firebase_options.dart';
-/// // ...
-/// await Firebase.initializeApp(
-///   options: DefaultFirebaseOptions.currentPlatform,
-/// );
-/// ```
+/// Selects the correct Firebase configuration based on the compile-time
+/// `ENV` dart define (dev, stage, prod). Defaults to dev.
 class DefaultFirebaseOptions {
   static FirebaseOptions get currentPlatform {
     if (kIsWeb) {
-      return web;
+      return _webOptions;
     }
     switch (defaultTargetPlatform) {
       case TargetPlatform.android:
-        return android;
+        return _androidOptions;
       case TargetPlatform.iOS:
-        return ios;
-      case TargetPlatform.macOS:
-        throw UnsupportedError(
-          'DefaultFirebaseOptions have not been configured for macos - '
-          'you can reconfigure this by running the FlutterFire CLI again.',
-        );
-      case TargetPlatform.windows:
-        throw UnsupportedError(
-          'DefaultFirebaseOptions have not been configured for windows - '
-          'you can reconfigure this by running the FlutterFire CLI again.',
-        );
-      case TargetPlatform.linux:
-        throw UnsupportedError(
-          'DefaultFirebaseOptions have not been configured for linux - '
-          'you can reconfigure this by running the FlutterFire CLI again.',
-        );
+        return _iosOptions;
       default:
         throw UnsupportedError(
           'DefaultFirebaseOptions are not supported for this platform.',
@@ -46,7 +24,65 @@ class DefaultFirebaseOptions {
     }
   }
 
-  static const FirebaseOptions web = FirebaseOptions(
+  static FirebaseOptions get _androidOptions {
+    switch (AppEnvironment.current) {
+      case AppEnvironment.dev:
+        return _devAndroid;
+      case AppEnvironment.stage:
+        return _stageAndroid;
+      case AppEnvironment.prod:
+        return _prodAndroid;
+    }
+  }
+
+  static FirebaseOptions get _iosOptions {
+    switch (AppEnvironment.current) {
+      case AppEnvironment.dev:
+        return _devIos;
+      case AppEnvironment.stage:
+        return _stageIos;
+      case AppEnvironment.prod:
+        return _prodIos;
+    }
+  }
+
+  static FirebaseOptions get _webOptions {
+    switch (AppEnvironment.current) {
+      case AppEnvironment.dev:
+        return _devWeb;
+      case AppEnvironment.stage:
+        return _stageWeb;
+      case AppEnvironment.prod:
+        return _prodWeb;
+    }
+  }
+
+  // ===========================================================================
+  // DEV (krow-workforce-dev)
+  // ===========================================================================
+
+  static const FirebaseOptions _devAndroid = FirebaseOptions(
+    apiKey: 'AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4',
+    appId: '1:933560802882:android:1eb46251032273cb7757db',
+    messagingSenderId: '933560802882',
+    projectId: 'krow-workforce-dev',
+    storageBucket: 'krow-workforce-dev.firebasestorage.app',
+  );
+
+  static const FirebaseOptions _devIos = FirebaseOptions(
+    apiKey: 'AIzaSyDyEXkzZAWpXXe4dAesYaZflt5BEtMn9tA',
+    appId: '1:933560802882:ios:7e179dfdd1a8994c7757db',
+    messagingSenderId: '933560802882',
+    projectId: 'krow-workforce-dev',
+    storageBucket: 'krow-workforce-dev.firebasestorage.app',
+    androidClientId:
+        '933560802882-fbqg2icq24bmci3f84evjrbth5huh87f.apps.googleusercontent.com',
+    iosClientId:
+        '933560802882-jpv087j5jenp1h63mc9ge51767s3l2ac.apps.googleusercontent.com',
+    iosBundleId: 'dev.krowwithus.client',
+  );
+
+  static const FirebaseOptions _devWeb = FirebaseOptions(
     apiKey: 'AIzaSyBqRtZPMGU-Sz5x5UnRrunKu5NSWYyPRn8',
     appId: '1:933560802882:web:173a841992885bb27757db',
     messagingSenderId: '933560802882',
@@ -56,23 +92,62 @@ class DefaultFirebaseOptions {
     measurementId: 'G-9S7WEQTDKX',
   );
 
-  static const FirebaseOptions android = FirebaseOptions(
-    apiKey: 'AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4',
-    appId: '1:933560802882:android:da13569105659ead7757db',
-    messagingSenderId: '933560802882',
-    projectId: 'krow-workforce-dev',
-    storageBucket: 'krow-workforce-dev.firebasestorage.app',
+  // ===========================================================================
+  // STAGE (krow-workforce-staging)
+  // ===========================================================================
+
+  static const FirebaseOptions _stageAndroid = FirebaseOptions(
+    apiKey: 'AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY',
+    appId: '1:1032971403708:android:1ab9badf171c3aca356bb9',
+    messagingSenderId: '1032971403708',
+    projectId: 'krow-workforce-staging',
+    storageBucket: 'krow-workforce-staging.firebasestorage.app',
   );
 
-  static const FirebaseOptions ios = FirebaseOptions(
-    apiKey: 'AIzaSyDyEXkzZAWpXXe4dAesYaZflt5BEtMn9tA',
-    appId: '1:933560802882:ios:d2b6d743608e2a527757db',
-    messagingSenderId: '933560802882',
-    projectId: 'krow-workforce-dev',
-    storageBucket: 'krow-workforce-dev.firebasestorage.app',
-    androidClientId: '933560802882-fbqg2icq24bmci3f84evjrbth5huh87f.apps.googleusercontent.com',
-    iosClientId: '933560802882-jqpv1l3gjmi3m87b2gu1iq4lg46lkdfg.apps.googleusercontent.com',
-    iosBundleId: 'com.krowwithus.client',
+  static const FirebaseOptions _stageIos = FirebaseOptions(
+    apiKey: 'AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY',
+    appId: '1:1032971403708:ios:0ff547e80f5324ed356bb9',
+    messagingSenderId: '1032971403708',
+    projectId: 'krow-workforce-staging',
+    storageBucket: 'krow-workforce-staging.firebasestorage.app',
+    iosBundleId: 'stage.krowwithus.client',
   );
 
+  static const FirebaseOptions _stageWeb = FirebaseOptions(
+    apiKey: 'AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY',
+    appId: '', // TODO: Register web app in krow-workforce-staging
+    messagingSenderId: '1032971403708',
+    projectId: 'krow-workforce-staging',
+    storageBucket: 'krow-workforce-staging.firebasestorage.app',
+  );
+
+  // ===========================================================================
+  // PROD (krow-workforce-prod)
+  // TODO: Fill in after creating krow-workforce-prod Firebase project
+  // ===========================================================================
+
+  static const FirebaseOptions _prodAndroid = FirebaseOptions(
+    apiKey: '', // TODO: Add prod API key
+    appId: '', // TODO: Add prod app ID
+    messagingSenderId: '', // TODO: Add prod sender ID
+    projectId: 'krow-workforce-prod',
+    storageBucket: 'krow-workforce-prod.firebasestorage.app',
+  );
+
+  static const FirebaseOptions _prodIos = FirebaseOptions(
+    apiKey: '', // TODO: Add prod API key
+    appId: '', // TODO: Add prod app ID
+    messagingSenderId: '', // TODO: Add prod sender ID
+    projectId: 'krow-workforce-prod',
+    storageBucket: 'krow-workforce-prod.firebasestorage.app',
+    iosBundleId: 'prod.krowwithus.client',
+  );
+
+  static const FirebaseOptions _prodWeb = FirebaseOptions(
+    apiKey: '', // TODO: Add prod API key
+    appId: '', // TODO: Add prod app ID
+    messagingSenderId: '', // TODO: Add prod sender ID
+    projectId: 'krow-workforce-prod',
+    storageBucket: 'krow-workforce-prod.firebasestorage.app',
+  );
 }

apps/mobile/apps/client/lib/src/widgets/session_listener.dart

@@ -104,7 +104,7 @@ class _SessionListenerState extends State<SessionListener> {
           actions: <Widget>[
             TextButton(
               onPressed: () {
-                Navigator.of(context).pop();
+                Modular.to.popSafe();
                 _proceedToLogin();
               },
               child: const Text('Log In'),
@@ -134,7 +134,7 @@ class _SessionListenerState extends State<SessionListener> {
             ),
             TextButton(
               onPressed: () {
-                Navigator.of(context).pop();
+                Modular.to.popSafe();;
                 _proceedToLogin();
               },
               child: const Text('Log Out'),

apps/mobile/apps/client/pubspec.yaml

@@ -1,7 +1,7 @@
 name: krowwithus_client
 description: "KROW Client Application"
 publish_to: "none"
-version: 0.0.1-IlianaClientM3
+version: 0.0.1-m4
 resolution: workspace
 
 environment:

apps/mobile/apps/staff/CHANGELOG.md

@@ -0,0 +1,193 @@
+# Staff Mobile App - Change Log
+
+## [v0.0.1-m3] - Milestone 3 - 2026-02-15
+
+### Added - Authentication & Onboarding
+- Phone number authentication with OTP verification
+- Staff onboarding flow with profile setup
+- Personal information collection (name, bio, languages)
+- Preferred work locations selection
+- Skills and industry selection
+
+### Added - Home Dashboard
+- Welcome screen with personalized greeting
+- Today's shifts section showing confirmed shifts
+- Tomorrow's shifts preview
+- Recommended shifts section based on profile
+- Quick action buttons (Find Shifts, Availability, Messages, Earnings)
+
+### Added - Shift Management
+- Find Shifts functionality to discover available work
+- Shift details view showing:
+  - Business name and location
+  - Hourly rate and estimated earnings
+  - Date, start time, end time
+  - Job requirements
+  - Map integration with directions
+- Shift booking/application process
+- Booking confirmation dialog
+- My Shifts view with week-by-week navigation
+- Color-coded shift status (Confirmed, Pending, Completed)
+
+### Added - Clock In/Out
+- Clock In page with slider interaction
+- Clock Out page with slider interaction
+- Automatic timestamp recording
+- Shift status updates upon clock in/out
+- Visual status indicators (green for checked in)
+
+### Added - Profile Management
+- Profile tab with personal information
+- Emergency Contact management:
+  - Contact name
+  - Relationship
+  - Phone number
+- Bank Account linking for direct deposit
+- Tax Forms section:
+  - W-4 form access
+  - I-9 form access
+- Time Card view:
+  - Historical shift records
+  - Hours worked tracking
+  - Earnings history
+
+### Added - Navigation
+- Bottom navigation bar with 5 tabs:
+  - Shifts
+  - Payments
+  - Home
+  - Clock In
+  - Profile
+- Tab bar hiding on specific pages
+
+### Technical Features
+- Firebase authentication integration
+- Data Connect backend integration
+- Google Maps integration for locations
+- Phone verification system
+- OTP code handling
+
+### Known Limitations
+- Newly created orders don't appear immediately in Find Shifts (requires vendor approval)
+- Limited to one-time order types in this milestone
+
+---
+
+## [v0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added - Enhanced Authentication & Session Management
+- Authentication session persistence across app restarts
+- Automatic login with valid session tokens
+- Improved user experience with seamless session handling
+
+### Added - Enhanced Shift Details
+- Google Maps location display in shift details view
+- Interactive map showing shift location
+- Directions integration
+- Shift requirements section showing:
+  - Required attire items (MUST HAVE)
+  - Preferred attire items (NICE TO HAVE)
+  - Other shift-specific requirements
+
+### Added - Attire Management
+- Dedicated Attire screen in profile
+- Camera and gallery support for attire photo capture
+- Local image preview before submission
+- Upload attire images for verification
+- MUST HAVE attire items list
+- NICE TO HAVE attire items list
+- Attire photo gallery in profile
+- Submit attire for review workflow
+- Attire verification status tracking (Pending, Approved, Rejected)
+- Attestation checkbox for attire accuracy confirmation
+- Filtered attire items based on requirements
+
+### Added - Documents & Certificates Management
+- Documents section in profile with verification status tracking
+- Upload documents (ID, licenses, etc.) with:
+  - Camera or gallery selection
+  - File type validation
+  - Upload progress tracking
+  - Verification metadata
+- Certificates management:
+  - Upload certificates with expiry dates
+  - Certificate number field
+  - Certificate type selection
+  - View existing certificates
+  - Delete certificates
+  - Verification status (Not Verified, Verified, Expired)
+- Mandatory document flagging
+- Document verification workflow
+
+### Added - Profile Enhancements
+- FAQ (Frequently Asked Questions) screen
+- Privacy and Security settings screen:
+  - Profile visibility toggle ("Hide account from business")
+  - Terms of Service document access
+  - Privacy Policy document access
+- Preferred locations management:
+  - Dedicated edit screen
+  - Location search functionality
+  - Display selected locations
+- Language selection interface:
+  - Spanish language support
+  - Success feedback on language change
+  - Persistent language preference
+- Benefits overview section:
+  - Benefits listing with circular progress indicators
+  - Benefits dashboard integration
+- Profile completion tracking for:
+  - Personal information
+  - Emergency contacts
+  - Experience
+  - Attire
+  - Documents
+  - Certificates
+
+### Added - Profile Completion Gating
+- Navigation restrictions for incomplete profiles
+- Only Home and Profile tabs accessible until profile is complete
+- Profile completion checklist
+- Guided onboarding completion flow
+
+### Improved - User Experience
+- Enhanced shift details UI with better information hierarchy
+- Improved profile section organization
+- Better navigation flow for profile completion
+- UiEmptyState widgets for better empty state handling:
+  - Bank account page empty state
+  - Home page when no shifts available
+- Improved onboarding flow with refactored experience and personal info pages
+- Enhanced emergency contact screen with info banner
+- Refactored profile header with profile level badge ("KROWER I")
+- Benefits card components with improved styling
+- Bottom navigation bar show/hide based on route
+- Tax forms page with progress overview
+- Improved notice and file type banners for uploads
+- Enhanced navigation robustness with proper error handling
+- Immediate ID token refresh after sign-in to prevent unauthenticated requests
+
+### Fixed
+- Profile completion status now updates correctly for emergency contacts
+- Session handling improved to prevent data loss
+- Navigation errors redirect to appropriate home page
+- Locale synchronization by reloading from persistent storage after change
+
+### Technical Features
+- Enhanced backend validation for shift acceptance
+- Overlapping shift prevention
+- Improved session management
+- Document upload and storage integration
+- Signed URL generation for file uploads
+- Camera and gallery native device access
+- File visibility controls (public/private)
+- Core API services integration (verification, file upload, LLM)
+- ApiService with Dio for standardized API requests
+- Device services abstraction layer
+
+### Known Limitations
+- Cannot accept overlapping shifts
+- Shifts require manual confirmation in some cases
+- Attire verification requires manual client approval
+
+---

apps/mobile/apps/staff/android/app/build.gradle.kts

@@ -21,8 +21,20 @@ dartDefinesString.split(",").forEach {
     }
 }
 
+// Load flavor-specific key properties: key.dev.properties, key.stage.properties, key.prod.properties
+// The active flavor is resolved from the Gradle task name (e.g. assembleDevRelease -> dev)
+fun resolveFlavorFromTask(): String {
+    val taskNames = gradle.startParameter.taskNames.joinToString(" ").lowercase()
+    return when {
+        taskNames.contains("prod") -> "prod"
+        taskNames.contains("stage") -> "stage"
+        else -> "dev"
+    }
+}
+
+val activeFlavorForSigning = resolveFlavorFromTask()
 val keystoreProperties = Properties().apply {
-    val propertiesFile = rootProject.file("key.properties")
+    val propertiesFile = rootProject.file("key.${activeFlavorForSigning}.properties")
     if (propertiesFile.exists()) {
         load(propertiesFile.inputStream())
     }
@@ -43,9 +55,7 @@ android {
     }
 
     defaultConfig {
-        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
-        applicationId = "com.krowwithus.staff"
-        // You can update the following values to match your application needs.
+        // applicationId is set per flavor below
         // For more information, see: https://flutter.dev/to/review-gradle-config.
         minSdk = flutter.minSdkVersion
         targetSdk = flutter.targetSdkVersion
@@ -55,16 +65,35 @@ android {
     manifestPlaceholders["GOOGLE_MAPS_API_KEY"] = dartEnvironmentVariables["GOOGLE_MAPS_API_KEY"] ?: ""
     }
 
+    flavorDimensions += "environment"
+    productFlavors {
+        create("dev") {
+            dimension = "environment"
+            applicationId = "dev.krowwithus.staff"
+            resValue("string", "app_name", "KROW With Us [DEV]")
+        }
+        create("stage") {
+            dimension = "environment"
+            applicationId = "stage.krowwithus.staff"
+            resValue("string", "app_name", "KROW With Us [STG]")
+        }
+        create("prod") {
+            dimension = "environment"
+            applicationId = "prod.krowwithus.staff"
+            resValue("string", "app_name", "KROW Staff")
+        }
+    }
+
     signingConfigs {
         create("release") {
             if (System.getenv()["CI"] == "true") {
                 // CodeMagic CI environment
-                storeFile = file(System.getenv()["CM_KEYSTORE_PATH_STAFF"] ?: "")
-                storePassword = System.getenv()["CM_KEYSTORE_PASSWORD_STAFF"]
-                keyAlias = System.getenv()["CM_KEY_ALIAS_STAFF"]
-                keyPassword = System.getenv()["CM_KEY_PASSWORD_STAFF"]
+                storeFile = file(System.getenv()["CM_KEYSTORE_PATH"] ?: "")
+                storePassword = System.getenv()["CM_KEYSTORE_PASSWORD"]
+                keyAlias = System.getenv()["CM_KEY_ALIAS"]
+                keyPassword = System.getenv()["CM_KEY_PASSWORD"]
             } else {
-                // Local development environment
+                // Local development environment — loads from key.<flavor>.properties
                 keyAlias = keystoreProperties["keyAlias"] as String?
                 keyPassword = keystoreProperties["keyPassword"] as String?
                 storeFile = keystoreProperties["storeFile"]?.let { file(it) }
@@ -84,6 +113,20 @@ android {
     }
 }
 
+// Skip google-services processing for flavors whose google-services.json
+// contains placeholder values (e.g. prod before the Firebase project exists).
+// Once a real config is dropped in, the task automatically re-enables.
+afterEvaluate {
+    tasks.matching {
+        it.name.startsWith("process") && it.name.endsWith("GoogleServices")
+    }.configureEach {
+        val taskFlavor = name.removePrefix("process").removeSuffix("GoogleServices")
+            .removeSuffix("Debug").removeSuffix("Release").lowercase()
+        val configFile = file("src/$taskFlavor/google-services.json")
+        enabled = configFile.exists() && configFile.readText().contains("\"mobilesdk_app_id\": \"1:")
+    }
+}
+
 flutter {
     source = "../.."
 }

apps/mobile/apps/staff/android/app/google-services.json_back

@@ -1,162 +0,0 @@
-{
-  "project_info": {
-    "project_number": "933560802882",
-    "project_id": "krow-workforce-dev",
-    "storage_bucket": "krow-workforce-dev.firebasestorage.app"
-  },
-  "client": [
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:edcddb83ea4bbb517757db",
-        "android_client_info": {
-          "package_name": "com.krow.app.business.dev"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-dppsapp5i3lsfrlm1mhob2s21peofg1t.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krow.app.staff.dev"
-              }
-            }
-          ]
-        }
-      }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:d49b8c0f4d19e95e7757db",
-        "android_client_info": {
-          "package_name": "com.krow.app.staff.dev"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-dppsapp5i3lsfrlm1mhob2s21peofg1t.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krow.app.staff.dev"
-              }
-            }
-          ]
-        }
-      }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:da13569105659ead7757db",
-        "android_client_info": {
-          "package_name": "com.krowwithus.client"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-dppsapp5i3lsfrlm1mhob2s21peofg1t.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krow.app.staff.dev"
-              }
-            }
-          ]
-        }
-      }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:1ae05d85c865f77c7757db",
-        "android_client_info": {
-          "package_name": "com.krowwithus.staff"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-ikdfv3o5f47g36qqgvfq55o4m19n7gk4.apps.googleusercontent.com",
-          "client_type": 1,
-          "android_info": {
-            "package_name": "com.krowwithus.staff",
-            "certificate_hash": "ac917ae8470ab29f1107c773c6017ff5ea5d102d"
-          }
-        },
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-dppsapp5i3lsfrlm1mhob2s21peofg1t.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krow.app.staff.dev"
-              }
-            }
-          ]
-        }
-      }
-    }
-  ],
-  "configuration_version": "1"
-}

apps/mobile/apps/staff/android/app/src/dev/google-services.json

@@ -5,78 +5,6 @@
     "storage_bucket": "krow-workforce-dev.firebasestorage.app"
   },
   "client": [
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:edcddb83ea4bbb517757db",
-        "android_client_info": {
-          "package_name": "com.krow.app.business.dev"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krowwithus.staff"
-              }
-            }
-          ]
-        }
-      }
-    },
-    {
-      "client_info": {
-        "mobilesdk_app_id": "1:933560802882:android:d49b8c0f4d19e95e7757db",
-        "android_client_info": {
-          "package_name": "com.krow.app.staff.dev"
-        }
-      },
-      "oauth_client": [
-        {
-          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-          "client_type": 3
-        }
-      ],
-      "api_key": [
-        {
-          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
-        }
-      ],
-      "services": {
-        "appinvite_service": {
-          "other_platform_oauth_client": [
-            {
-              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
-              "client_type": 3
-            },
-            {
-              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
-              "client_type": 2,
-              "ios_info": {
-                "bundle_id": "com.krowwithus.staff"
-              }
-            }
-          ]
-        }
-      }
-    },
     {
       "client_info": {
         "mobilesdk_app_id": "1:933560802882:android:da13569105659ead7757db",
@@ -164,6 +92,78 @@
           ]
         }
       }
+    },
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:933560802882:android:1eb46251032273cb7757db",
+        "android_client_info": {
+          "package_name": "dev.krowwithus.client"
+        }
+      },
+      "oauth_client": [
+        {
+          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+          "client_type": 3
+        }
+      ],
+      "api_key": [
+        {
+          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": [
+            {
+              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+              "client_type": 3
+            },
+            {
+              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
+              "client_type": 2,
+              "ios_info": {
+                "bundle_id": "com.krowwithus.staff"
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:933560802882:android:ee100eab75b6b04c7757db",
+        "android_client_info": {
+          "package_name": "dev.krowwithus.staff"
+        }
+      },
+      "oauth_client": [
+        {
+          "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+          "client_type": 3
+        }
+      ],
+      "api_key": [
+        {
+          "current_key": "AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": [
+            {
+              "client_id": "933560802882-grp98a1v7amflnnup68vh01tj06eaem1.apps.googleusercontent.com",
+              "client_type": 3
+            },
+            {
+              "client_id": "933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com",
+              "client_type": 2,
+              "ios_info": {
+                "bundle_id": "com.krowwithus.staff"
+              }
+            }
+          ]
+        }
+      }
     }
   ],
   "configuration_version": "1"

apps/mobile/apps/staff/android/app/src/main/AndroidManifest.xml

@@ -1,6 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <application
-        android:label="KROW With Us Staff"
+        android:label="@string/app_name"
         android:name="${applicationName}"
         android:icon="@mipmap/launcher_icon">
         <activity

apps/mobile/apps/staff/android/app/src/main/kotlin/com/krowwithus/krowwithus_staff/MainActivity.kt

@@ -1,5 +0,0 @@
-package com.krowwithus.krowwithus_staff
-
-import io.flutter.embedding.android.FlutterActivity
-
-class MainActivity : FlutterActivity()

apps/mobile/apps/staff/android/app/src/stage/google-services.json

@@ -0,0 +1,48 @@
+{
+  "project_info": {
+    "project_number": "1032971403708",
+    "project_id": "krow-workforce-staging",
+    "storage_bucket": "krow-workforce-staging.firebasestorage.app"
+  },
+  "client": [
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:1032971403708:android:1ab9badf171c3aca356bb9",
+        "android_client_info": {
+          "package_name": "stage.krowwithus.client"
+        }
+      },
+      "oauth_client": [],
+      "api_key": [
+        {
+          "current_key": "AIzaSyAZ4dOatvf3ZBt4qnbSlIvJ51bblHaRsRw"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": []
+        }
+      }
+    },
+    {
+      "client_info": {
+        "mobilesdk_app_id": "1:1032971403708:android:14e471d055e59597356bb9",
+        "android_client_info": {
+          "package_name": "stage.krowwithus.staff"
+        }
+      },
+      "oauth_client": [],
+      "api_key": [
+        {
+          "current_key": "AIzaSyAZ4dOatvf3ZBt4qnbSlIvJ51bblHaRsRw"
+        }
+      ],
+      "services": {
+        "appinvite_service": {
+          "other_platform_oauth_client": []
+        }
+      }
+    }
+  ],
+  "configuration_version": "1"
+}

apps/mobile/apps/staff/android/key.prod.properties

@@ -0,0 +1,9 @@
+storePassword=krowwithus
+keyPassword=krowwithus
+keyAlias=krow_staff_prod
+storeFile=krow_with_us_staff_prod.jks
+
+###
+### Staff Prod
+### SHA1: B3:9A:AE:EC:8D:A2:C8:88:5F:FA:AC:9B:31:0A:AC:F3:D6:7D:82:83
+### SHA256: 0C:F3:5F:B5:C5:DA:E3:94:E1:FB:9E:D9:84:4F:2D:4A:E5:1B:48:FB:33:A1:DD:F3:43:41:22:32:A4:9A:25:E8

apps/mobile/apps/staff/android/key.stage.properties

@@ -0,0 +1,9 @@
+storePassword=krowwithus
+keyPassword=krowwithus
+keyAlias=krow_staff_stage
+storeFile=krow_with_us_staff_stage.jks
+
+###
+### Staff Stage
+### SHA1: E8:C4:B8:F5:5E:19:04:31:D6:E5:16:76:47:62:D0:5B:2F:F3:CE:05
+### SHA256: 25:55:68:E6:77:03:33:E1:D0:4E:F4:75:6E:6B:3D:3D:A2:DB:9B:2B:5E:AD:FF:CD:22:64:CE:3F:E8:AF:60:50

apps/mobile/apps/staff/ios/Runner.xcodeproj/project.pbxproj

@@ -149,6 +149,7 @@
 			buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */;
 			buildPhases = (
 				9740EEB61CF901F6004384FC /* Run Script */,
+				BC26E38C2F5F605000517BDF /* ShellScript */,
 				97C146EA1CF9000F007C117D /* Sources */,
 				97C146EB1CF9000F007C117D /* Frameworks */,
 				97C146EC1CF9000F007C117D /* Resources */,
@@ -255,7 +256,26 @@
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
-			shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build";
+			shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build\n";
+		};
+		BC26E38C2F5F605000517BDF /* ShellScript */ = {
+			isa = PBXShellScriptBuildPhase;
+			alwaysOutOfDate = 1;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+			);
+			inputPaths = (
+				"$(SRCROOT)/newInputFile",
+			);
+			outputFileListPaths = (
+			);
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "# Tye a script or drag a script file from your workspace to insert its path.\n$PROJECT_DIR/scripts/copy-firebase-config.sh\n";
 		};
 /* End PBXShellScriptBuildPhase section */
 
@@ -363,6 +383,7 @@
 			isa = XCBuildConfiguration;
 			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
 			buildSettings = {
+				APP_NAME = "KROW With Us [STAGE] ";
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
@@ -372,7 +393,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.staff;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_VERSION = 5.0;
@@ -542,6 +563,7 @@
 			isa = XCBuildConfiguration;
 			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
 			buildSettings = {
+				APP_NAME = "KROW With Us [DEV] ";
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
@@ -551,7 +573,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.staff;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
@@ -564,6 +586,7 @@
 			isa = XCBuildConfiguration;
 			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
 			buildSettings = {
+				APP_NAME = "KROW With Us";
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
@@ -573,7 +596,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.staff;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_VERSION = 5.0;
@@ -581,6 +604,837 @@
 			};
 			name = Release;
 		};
+		BC26E3712F5F5EBD00517BDF /* Debug-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = "Debug-dev";
+		};
+		BC26E3722F5F5EBD00517BDF /* Debug-dev */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us [DEV] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Debug-dev";
+		};
+		BC26E3732F5F5EBD00517BDF /* Debug-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Debug-dev";
+		};
+		BC26E3742F5F5EC300517BDF /* Debug-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = "Debug-stage";
+		};
+		BC26E3752F5F5EC300517BDF /* Debug-stage */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us [STAGE] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Debug-stage";
+		};
+		BC26E3762F5F5EC300517BDF /* Debug-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Debug-stage";
+		};
+		BC26E3772F5F5EC800517BDF /* Debug-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = "Debug-prod";
+		};
+		BC26E3782F5F5EC800517BDF /* Debug-prod */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Debug-prod";
+		};
+		BC26E3792F5F5EC800517BDF /* Debug-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Debug-prod";
+		};
+		BC26E37A2F5F5ECF00517BDF /* Release-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Release-dev";
+		};
+		BC26E37B2F5F5ECF00517BDF /* Release-dev */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us [DEV] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Release-dev";
+		};
+		BC26E37C2F5F5ECF00517BDF /* Release-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Release-dev";
+		};
+		BC26E37D2F5F5ED800517BDF /* Release-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Release-stage";
+		};
+		BC26E37E2F5F5ED800517BDF /* Release-stage */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us [STAGE] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Release-stage";
+		};
+		BC26E37F2F5F5ED800517BDF /* Release-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Release-stage";
+		};
+		BC26E3802F5F5EDD00517BDF /* Release-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Release-prod";
+		};
+		BC26E3812F5F5EDD00517BDF /* Release-prod */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Release-prod";
+		};
+		BC26E3822F5F5EDD00517BDF /* Release-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Release-prod";
+		};
+		BC26E3832F5F5EE500517BDF /* Profile-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Profile-dev";
+		};
+		BC26E3842F5F5EE500517BDF /* Profile-dev */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us [DEV] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Profile-dev";
+		};
+		BC26E3852F5F5EE500517BDF /* Profile-dev */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Profile-dev";
+		};
+		BC26E3862F5F5EEA00517BDF /* Profile-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Profile-stage";
+		};
+		BC26E3872F5F5EEA00517BDF /* Profile-stage */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us [STAGE] ";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = stage.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Profile-stage";
+		};
+		BC26E3882F5F5EEA00517BDF /* Profile-stage */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Profile-stage";
+		};
+		BC26E3892F5F5EEF00517BDF /* Profile-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = "Profile-prod";
+		};
+		BC26E38A2F5F5EEF00517BDF /* Profile-prod */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				APP_NAME = "KROW With Us";
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = prod.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = "Profile-prod";
+		};
+		BC26E38B2F5F5EEF00517BDF /* Profile-prod */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = com.krowwithus.staff;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = "Profile-prod";
+		};
 /* End XCBuildConfiguration section */
 
 /* Begin XCConfigurationList section */
@@ -588,8 +1442,17 @@
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				331C8088294A63A400263BE5 /* Debug */,
+				BC26E3792F5F5EC800517BDF /* Debug-prod */,
+				BC26E3762F5F5EC300517BDF /* Debug-stage */,
+				BC26E3732F5F5EBD00517BDF /* Debug-dev */,
 				331C8089294A63A400263BE5 /* Release */,
+				BC26E3822F5F5EDD00517BDF /* Release-prod */,
+				BC26E37F2F5F5ED800517BDF /* Release-stage */,
+				BC26E37C2F5F5ECF00517BDF /* Release-dev */,
 				331C808A294A63A400263BE5 /* Profile */,
+				BC26E38B2F5F5EEF00517BDF /* Profile-prod */,
+				BC26E3882F5F5EEA00517BDF /* Profile-stage */,
+				BC26E3852F5F5EE500517BDF /* Profile-dev */,
 			);
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
@@ -598,8 +1461,17 @@
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				97C147031CF9000F007C117D /* Debug */,
+				BC26E3772F5F5EC800517BDF /* Debug-prod */,
+				BC26E3742F5F5EC300517BDF /* Debug-stage */,
+				BC26E3712F5F5EBD00517BDF /* Debug-dev */,
 				97C147041CF9000F007C117D /* Release */,
+				BC26E3802F5F5EDD00517BDF /* Release-prod */,
+				BC26E37D2F5F5ED800517BDF /* Release-stage */,
+				BC26E37A2F5F5ECF00517BDF /* Release-dev */,
 				249021D3217E4FDB00AE95B9 /* Profile */,
+				BC26E3892F5F5EEF00517BDF /* Profile-prod */,
+				BC26E3862F5F5EEA00517BDF /* Profile-stage */,
+				BC26E3832F5F5EE500517BDF /* Profile-dev */,
 			);
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
@@ -608,8 +1480,17 @@
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				97C147061CF9000F007C117D /* Debug */,
+				BC26E3782F5F5EC800517BDF /* Debug-prod */,
+				BC26E3752F5F5EC300517BDF /* Debug-stage */,
+				BC26E3722F5F5EBD00517BDF /* Debug-dev */,
 				97C147071CF9000F007C117D /* Release */,
+				BC26E3812F5F5EDD00517BDF /* Release-prod */,
+				BC26E37E2F5F5ED800517BDF /* Release-stage */,
+				BC26E37B2F5F5ECF00517BDF /* Release-dev */,
 				249021D4217E4FDB00AE95B9 /* Profile */,
+				BC26E38A2F5F5EEF00517BDF /* Profile-prod */,
+				BC26E3872F5F5EEA00517BDF /* Profile-stage */,
+				BC26E3842F5F5EE500517BDF /* Profile-dev */,
 			);
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;

apps/mobile/apps/staff/ios/Runner.xcodeproj/xcshareddata/xcschemes/dev.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "2630"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

apps/mobile/apps/staff/ios/Runner.xcodeproj/xcshareddata/xcschemes/prod.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "2630"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

apps/mobile/apps/staff/ios/Runner.xcodeproj/xcshareddata/xcschemes/stage.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "2630"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

apps/mobile/apps/staff/ios/Runner/Info.plist

@@ -5,7 +5,7 @@
 	<key>CFBundleDevelopmentRegion</key>
 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 	<key>CFBundleDisplayName</key>
-	<string>KROW With Us Staff</string>
+	<string>$(APP_NAME)</string>
 	<key>CFBundleExecutable</key>
 	<string>$(EXECUTABLE_NAME)</string>
 	<key>CFBundleIdentifier</key>
@@ -13,7 +13,7 @@
 	<key>CFBundleInfoDictionaryVersion</key>
 	<string>6.0</string>
 	<key>CFBundleName</key>
-	<string>KROW With Us Staff</string>
+	<string>$(APP_NAME)</string>
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>

apps/mobile/apps/staff/ios/config/dev/GoogleService-Info.plist

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CLIENT_ID</key>
+	<string>933560802882-jpv087j5jenp1h63mc9ge51767s3l2ac.apps.googleusercontent.com</string>
+	<key>REVERSED_CLIENT_ID</key>
+	<string>com.googleusercontent.apps.933560802882-jpv087j5jenp1h63mc9ge51767s3l2ac</string>
+	<key>ANDROID_CLIENT_ID</key>
+	<string>933560802882-fbqg2icq24bmci3f84evjrbth5huh87f.apps.googleusercontent.com</string>
+	<key>API_KEY</key>
+	<string>AIzaSyDyEXkzZAWpXXe4dAesYaZflt5BEtMn9tA</string>
+	<key>GCM_SENDER_ID</key>
+	<string>933560802882</string>
+	<key>PLIST_VERSION</key>
+	<string>1</string>
+	<key>BUNDLE_ID</key>
+	<string>dev.krowwithus.client</string>
+	<key>PROJECT_ID</key>
+	<string>krow-workforce-dev</string>
+	<key>STORAGE_BUCKET</key>
+	<string>krow-workforce-dev.firebasestorage.app</string>
+	<key>IS_ADS_ENABLED</key>
+	<false></false>
+	<key>IS_ANALYTICS_ENABLED</key>
+	<false></false>
+	<key>IS_APPINVITE_ENABLED</key>
+	<true></true>
+	<key>IS_GCM_ENABLED</key>
+	<true></true>
+	<key>IS_SIGNIN_ENABLED</key>
+	<true></true>
+	<key>GOOGLE_APP_ID</key>
+	<string>1:933560802882:ios:7e179dfdd1a8994c7757db</string>
+</dict>
+</plist>

apps/mobile/apps/staff/ios/config/stage/GoogleService-Info.plist

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>API_KEY</key>
+	<string>AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY</string>
+	<key>GCM_SENDER_ID</key>
+	<string>1032971403708</string>
+	<key>PLIST_VERSION</key>
+	<string>1</string>
+	<key>BUNDLE_ID</key>
+	<string>stage.krowwithus.client</string>
+	<key>PROJECT_ID</key>
+	<string>krow-workforce-staging</string>
+	<key>STORAGE_BUCKET</key>
+	<string>krow-workforce-staging.firebasestorage.app</string>
+	<key>IS_ADS_ENABLED</key>
+	<false></false>
+	<key>IS_ANALYTICS_ENABLED</key>
+	<false></false>
+	<key>IS_APPINVITE_ENABLED</key>
+	<true></true>
+	<key>IS_GCM_ENABLED</key>
+	<true></true>
+	<key>IS_SIGNIN_ENABLED</key>
+	<true></true>
+	<key>GOOGLE_APP_ID</key>
+	<string>1:1032971403708:ios:0ff547e80f5324ed356bb9</string>
+</dict>
+</plist>

apps/mobile/apps/staff/ios/scripts/firebase-config.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Copy the correct GoogleService-Info.plist based on the build configuration.
+# This script should be added as a "Run Script" build phase in Xcode,
+# BEFORE the "Compile Sources" phase.
+#
+# The FLUTTER_FLAVOR environment variable is set by Flutter when building
+# with --flavor. It maps to: dev, stage, prod.
+
+FLAVOR="${FLUTTER_FLAVOR:-dev}"
+PLIST_SOURCE="${PROJECT_DIR}/config/${FLAVOR}/GoogleService-Info.plist"
+PLIST_DEST="${PROJECT_DIR}/Runner/GoogleService-Info.plist"
+
+if [ ! -f "$PLIST_SOURCE" ]; then
+  echo "error: GoogleService-Info.plist not found for flavor '${FLAVOR}' at ${PLIST_SOURCE}"
+  exit 1
+fi
+
+echo "Copying GoogleService-Info.plist for flavor: ${FLAVOR}"
+cp "${PLIST_SOURCE}" "${PLIST_DEST}"

apps/mobile/apps/staff/lib/firebase_options.dart

@@ -1,44 +1,22 @@
-// File generated by FlutterFire CLI.
-
 import 'package:firebase_core/firebase_core.dart' show FirebaseOptions;
 import 'package:flutter/foundation.dart'
     show defaultTargetPlatform, kIsWeb, TargetPlatform;
+import 'package:krow_core/core.dart';
 
-/// Default [FirebaseOptions] for use with your Firebase apps.
+/// Environment-aware [FirebaseOptions] for the Staff app.
 ///
-/// Example:
-/// ```dart
-/// import 'firebase_options.dart';
-/// // ...
-/// await Firebase.initializeApp(
-///   options: DefaultFirebaseOptions.currentPlatform,
-/// );
-/// ```
+/// Selects the correct Firebase configuration based on the compile-time
+/// `ENV` dart define (dev, stage, prod). Defaults to dev.
 class DefaultFirebaseOptions {
   static FirebaseOptions get currentPlatform {
     if (kIsWeb) {
-      return web;
+      return _webOptions;
     }
     switch (defaultTargetPlatform) {
       case TargetPlatform.android:
-        return android;
+        return _androidOptions;
       case TargetPlatform.iOS:
-        return ios;
-      case TargetPlatform.macOS:
-        throw UnsupportedError(
-          'DefaultFirebaseOptions have not been configured for macos - '
-          'you can reconfigure this by running the FlutterFire CLI again.',
-        );
-      case TargetPlatform.windows:
-        throw UnsupportedError(
-          'DefaultFirebaseOptions have not been configured for windows - '
-          'you can reconfigure this by running the FlutterFire CLI again.',
-        );
-      case TargetPlatform.linux:
-        throw UnsupportedError(
-          'DefaultFirebaseOptions have not been configured for linux - '
-          'you can reconfigure this by running the FlutterFire CLI again.',
-        );
+        return _iosOptions;
       default:
         throw UnsupportedError(
           'DefaultFirebaseOptions are not supported for this platform.',
@@ -46,7 +24,65 @@ class DefaultFirebaseOptions {
     }
   }
 
-  static const FirebaseOptions web = FirebaseOptions(
+  static FirebaseOptions get _androidOptions {
+    switch (AppEnvironment.current) {
+      case AppEnvironment.dev:
+        return _devAndroid;
+      case AppEnvironment.stage:
+        return _stageAndroid;
+      case AppEnvironment.prod:
+        return _prodAndroid;
+    }
+  }
+
+  static FirebaseOptions get _iosOptions {
+    switch (AppEnvironment.current) {
+      case AppEnvironment.dev:
+        return _devIos;
+      case AppEnvironment.stage:
+        return _stageIos;
+      case AppEnvironment.prod:
+        return _prodIos;
+    }
+  }
+
+  static FirebaseOptions get _webOptions {
+    switch (AppEnvironment.current) {
+      case AppEnvironment.dev:
+        return _devWeb;
+      case AppEnvironment.stage:
+        return _stageWeb;
+      case AppEnvironment.prod:
+        return _prodWeb;
+    }
+  }
+
+  // ===========================================================================
+  // DEV (krow-workforce-dev)
+  // ===========================================================================
+
+  static const FirebaseOptions _devAndroid = FirebaseOptions(
+    apiKey: 'AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4',
+    appId: '1:933560802882:android:ee100eab75b6b04c7757db',
+    messagingSenderId: '933560802882',
+    projectId: 'krow-workforce-dev',
+    storageBucket: 'krow-workforce-dev.firebasestorage.app',
+  );
+
+  static const FirebaseOptions _devIos = FirebaseOptions(
+    apiKey: 'AIzaSyDyEXkzZAWpXXe4dAesYaZflt5BEtMn9tA',
+    appId: '1:933560802882:ios:edf97dab6eb87b977757db',
+    messagingSenderId: '933560802882',
+    projectId: 'krow-workforce-dev',
+    storageBucket: 'krow-workforce-dev.firebasestorage.app',
+    androidClientId:
+        '933560802882-fbqg2icq24bmci3f84evjrbth5huh87f.apps.googleusercontent.com',
+    iosClientId:
+        '933560802882-fphpkdjubve8k7e8ogqj3fk1qducv3sg.apps.googleusercontent.com',
+    iosBundleId: 'dev.krowwithus.staff',
+  );
+
+  static const FirebaseOptions _devWeb = FirebaseOptions(
     apiKey: 'AIzaSyBqRtZPMGU-Sz5x5UnRrunKu5NSWYyPRn8',
     appId: '1:933560802882:web:173a841992885bb27757db',
     messagingSenderId: '933560802882',
@@ -56,23 +92,62 @@ class DefaultFirebaseOptions {
     measurementId: 'G-9S7WEQTDKX',
   );
 
-  static const FirebaseOptions android = FirebaseOptions(
-    apiKey: 'AIzaSyDBYhflhK6DThKnS7RM-9raKdvyKzLUjY4',
-    appId: '1:933560802882:android:1ae05d85c865f77c7757db',
-    messagingSenderId: '933560802882',
-    projectId: 'krow-workforce-dev',
-    storageBucket: 'krow-workforce-dev.firebasestorage.app',
+  // ===========================================================================
+  // STAGE (krow-workforce-staging)
+  // ===========================================================================
+
+  static const FirebaseOptions _stageAndroid = FirebaseOptions(
+    apiKey: 'AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY',
+    appId: '1:1032971403708:android:14e471d055e59597356bb9',
+    messagingSenderId: '1032971403708',
+    projectId: 'krow-workforce-staging',
+    storageBucket: 'krow-workforce-staging.firebasestorage.app',
   );
 
-  static const FirebaseOptions ios = FirebaseOptions(
-    apiKey: 'AIzaSyDyEXkzZAWpXXe4dAesYaZflt5BEtMn9tA',
-    appId: '1:933560802882:ios:fa584205b356de937757db',
-    messagingSenderId: '933560802882',
-    projectId: 'krow-workforce-dev',
-    storageBucket: 'krow-workforce-dev.firebasestorage.app',
-    androidClientId: '933560802882-fbqg2icq24bmci3f84evjrbth5huh87f.apps.googleusercontent.com',
-    iosClientId: '933560802882-29olj9ku64jbe9h7flinha6hbi8qrluh.apps.googleusercontent.com',
-    iosBundleId: 'com.krowwithus.staff',
+  static const FirebaseOptions _stageIos = FirebaseOptions(
+    apiKey: 'AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY',
+    appId: '1:1032971403708:ios:8c2bbd76bc4f55d9356bb9',
+    messagingSenderId: '1032971403708',
+    projectId: 'krow-workforce-staging',
+    storageBucket: 'krow-workforce-staging.firebasestorage.app',
+    iosBundleId: 'stage.krowwithus.staff',
   );
 
+  static const FirebaseOptions _stageWeb = FirebaseOptions(
+    apiKey: 'AIzaSyCgTXI3QhbEK3r4J5y7ek_6AxqhmR99QjY',
+    appId: '', // TODO: Register web app in krow-workforce-staging
+    messagingSenderId: '1032971403708',
+    projectId: 'krow-workforce-staging',
+    storageBucket: 'krow-workforce-staging.firebasestorage.app',
+  );
+
+  // ===========================================================================
+  // PROD (krow-workforce-prod)
+  // TODO: Fill in after creating krow-workforce-prod Firebase project
+  // ===========================================================================
+
+  static const FirebaseOptions _prodAndroid = FirebaseOptions(
+    apiKey: '', // TODO: Add prod API key
+    appId: '', // TODO: Add prod app ID
+    messagingSenderId: '', // TODO: Add prod sender ID
+    projectId: 'krow-workforce-prod',
+    storageBucket: 'krow-workforce-prod.firebasestorage.app',
+  );
+
+  static const FirebaseOptions _prodIos = FirebaseOptions(
+    apiKey: '', // TODO: Add prod API key
+    appId: '', // TODO: Add prod app ID
+    messagingSenderId: '', // TODO: Add prod sender ID
+    projectId: 'krow-workforce-prod',
+    storageBucket: 'krow-workforce-prod.firebasestorage.app',
+    iosBundleId: 'prod.krowwithus.staff',
+  );
+
+  static const FirebaseOptions _prodWeb = FirebaseOptions(
+    apiKey: '', // TODO: Add prod API key
+    appId: '', // TODO: Add prod app ID
+    messagingSenderId: '', // TODO: Add prod sender ID
+    projectId: 'krow-workforce-prod',
+    storageBucket: 'krow-workforce-prod.firebasestorage.app',
+  );
 }

apps/mobile/apps/staff/lib/src/widgets/session_listener.dart

@@ -104,7 +104,7 @@ class _SessionListenerState extends State<SessionListener> {
           actions: <Widget>[
             TextButton(
               onPressed: () {
-                Navigator.of(context).pop();
+                Modular.to.popSafe();;
                 _proceedToLogin();
               },
               child: const Text('Log In'),
@@ -134,7 +134,7 @@ class _SessionListenerState extends State<SessionListener> {
             ),
             TextButton(
               onPressed: () {
-                Navigator.of(context).pop();
+                Modular.to.popSafe();;
                 _proceedToLogin();
               },
               child: const Text('Log Out'),

apps/mobile/apps/staff/pubspec.yaml

@@ -1,7 +1,7 @@
 name: krowwithus_staff
 description: "KROW Staff Application"
 publish_to: 'none'
-version: 0.0.1-IlianaStaffM3
+version: 0.0.1-m4
 resolution: workspace
 
 environment:

apps/mobile/config.dev.json

@@ -1,4 +1,5 @@
 {
+  "ENV": "dev",
   "GOOGLE_MAPS_API_KEY": "AIzaSyAyRS9I4xxoVPAX91RJvWJHszB3ZY3-IC0",
   "CORE_API_BASE_URL": "https://krow-core-api-e3g6witsvq-uc.a.run.app"
 }

apps/mobile/config.prod.json

@@ -0,0 +1,5 @@
+{
+  "ENV": "prod",
+  "GOOGLE_MAPS_API_KEY": "",
+  "CORE_API_BASE_URL": ""
+}

apps/mobile/config.stage.json

@@ -0,0 +1,5 @@
+{
+  "ENV": "stage",
+  "GOOGLE_MAPS_API_KEY": "AIzaSyAyRS9I4xxoVPAX91RJvWJHszB3ZY3-IC0",
+  "CORE_API_BASE_URL": "https://krow-core-api-staging-e3g6witsvq-uc.a.run.app"
+}

apps/mobile/melos.yaml

@@ -14,15 +14,14 @@ scripts:
       echo "              🚀 KROW WORKFORCE CUSTOM COMMANDS 🚀"
       echo "============================================================"
       echo "  BUILD COMMANDS:"
-      echo "  - melos run build:client         : Build Client App (APK)"
-      echo "  - melos run build:staff          : Build Staff App (APK)"
+      echo "  - melos run build:client -- <PLATFORM> --<MODE> --flavor <ENV> --dart-define-from-file=../../config.<ENV>.json"
+      echo "  - melos run build:staff  -- <PLATFORM> --<MODE> --flavor <ENV> --dart-define-from-file=../../config.<ENV>.json"
       echo "  - melos run build:design-system  : Build Design System Viewer"
       echo ""
       echo "  DEBUG/START COMMANDS:"
-      echo "  - melos run start:client -- -d <ID> : Run Client App"
-      echo "  - melos run start:staff -- -d <ID>  : Run Staff App"
+      echo "  - melos run start:client -- -d <ID> --flavor <ENV> --dart-define-from-file=../../config.<ENV>.json"
+      echo "  - melos run start:staff  -- -d <ID> --flavor <ENV> --dart-define-from-file=../../config.<ENV>.json"
       echo "  - melos run start:design-system     : Run DS Viewer"
-      echo "    (e.g., melos run start:client -- -d chrome)"
       echo ""
       echo "  CODE GENERATION:"
       echo "  - melos run gen:l10n             : Generate Slang l10n"
@@ -49,32 +48,30 @@ scripts:
     packageFilters:
       dependsOn: build_runner
 
+  # Single-line scripts so that melos run arg forwarding works via --
+  # Usage: melos run build:client -- apk --release --flavor dev --dart-define-from-file=../../config.dev.json
   build:client:
-    run: |
-      melos run gen:l10n --filter="core_localization"
-      melos run gen:build --filter="core_localization"
-      melos exec --scope="krowwithus_client" -- "flutter build apk"
-    description: "Build the Client app (Android APK by default)."
+    run: melos exec --scope="krowwithus_client" -- flutter build
+    description: "Build the Client app. Pass args via --: <platform> --<mode> --flavor <env> --dart-define-from-file=../../config.<env>.json"
 
   build:staff:
-    run: |
-      melos run gen:l10n --filter="core_localization"
-      melos run gen:build --filter="core_localization"
-      melos exec --scope="krowwithus_staff" -- "flutter build apk"
-    description: "Build the Staff app (Android APK by default)."
+    run: melos exec --scope="krowwithus_staff" -- flutter build
+    description: "Build the Staff app. Pass args via --: <platform> --<mode> --flavor <env> --dart-define-from-file=../../config.<env>.json"
 
   build:design-system-viewer:
-    run: melos exec --scope="design_system_viewer" -- "flutter build apk"
+    run: melos exec --scope="design_system_viewer" -- flutter build apk
     description: "Build the Design System Viewer app (Android APK by default)."
 
+  # Single-line scripts so that melos run arg forwarding works via --
+  # Usage: melos run start:client -- -d android --flavor dev --dart-define-from-file=../../config.dev.json
   start:client:
-    run: melos exec --scope="krowwithus_client" -- "flutter run"
-    description: "Start the Client app. Pass platform using -- -d <platform>, e.g. -d chrome"
+    run: melos exec --scope="krowwithus_client" -- flutter run
+    description: "Start the Client app. Pass args via --: -d <device> --flavor <env> --dart-define-from-file=../../config.<env>.json"
 
   start:staff:
-    run: melos exec --scope="krowwithus_staff" -- "flutter run"
-    description: "Start the Staff app. Pass platform using -- -d <platform>, e.g. -d chrome"
+    run: melos exec --scope="krowwithus_staff" -- flutter run
+    description: "Start the Staff app. Pass args via --: -d <device> --flavor <env> --dart-define-from-file=../../config.<env>.json"
 
   start:design-system-viewer:
-    run: melos exec --scope="design_system_viewer" -- "flutter run"
+    run: melos exec --scope="design_system_viewer" -- flutter run
     description: "Start the Design System Viewer app. Pass platform using -- -d <platform>, e.g. -d chrome"

apps/mobile/packages/core/lib/core.dart

@@ -9,6 +9,7 @@ export 'src/presentation/widgets/web_mobile_frame.dart';
 export 'src/presentation/mixins/bloc_error_handler.dart';
 export 'src/presentation/observers/core_bloc_observer.dart';
 export 'src/config/app_config.dart';
+export 'src/config/app_environment.dart';
 export 'src/routing/routing.dart';
 export 'src/services/api_service/api_service.dart';
 export 'src/services/api_service/dio_client.dart';

apps/mobile/packages/core/lib/src/config/app_environment.dart

@@ -0,0 +1,46 @@
+/// Represents the application environment.
+enum AppEnvironment {
+  dev,
+  stage,
+  prod;
+
+  /// Resolves the current environment from the compile-time `ENV` dart define.
+  /// Defaults to [AppEnvironment.dev] if not set or unrecognized.
+  static AppEnvironment get current {
+    const String envString = String.fromEnvironment('ENV', defaultValue: 'dev');
+    return AppEnvironment.values.firstWhere(
+      (AppEnvironment e) => e.name == envString,
+      orElse: () => AppEnvironment.dev,
+    );
+  }
+
+  /// Whether the app is running in production.
+  bool get isProduction => this == AppEnvironment.prod;
+
+  /// Whether the app is running in a non-production environment.
+  bool get isNonProduction => !isProduction;
+
+  /// The Firebase project ID for this environment.
+  String get firebaseProjectId {
+    switch (this) {
+      case AppEnvironment.dev:
+        return 'krow-workforce-dev';
+      case AppEnvironment.stage:
+        return 'krow-workforce-staging';
+      case AppEnvironment.prod:
+        return 'krow-workforce-prod';
+    }
+  }
+
+  /// A display label for the environment (empty for prod).
+  String get label {
+    switch (this) {
+      case AppEnvironment.dev:
+        return '[DEV]';
+      case AppEnvironment.stage:
+        return '[STG]';
+      case AppEnvironment.prod:
+        return '';
+    }
+  }
+}

apps/mobile/packages/core/lib/src/core_module.dart

@@ -13,35 +13,35 @@ class CoreModule extends Module {
   @override
   void exportedBinds(Injector i) {
     // 1. Register the base HTTP client
-    i.addSingleton<Dio>(() => DioClient());
+    i.addLazySingleton<Dio>(() => DioClient());
 
     // 2. Register the base API service
-    i.addSingleton<BaseApiService>(() => ApiService(i.get<Dio>()));
+    i.addLazySingleton<BaseApiService>(() => ApiService(i.get<Dio>()));
 
     // 3. Register Core API Services (Orchestrators)
-    i.addSingleton<FileUploadService>(
+    i.addLazySingleton<FileUploadService>(
       () => FileUploadService(i.get<BaseApiService>()),
     );
-    i.addSingleton<SignedUrlService>(
+    i.addLazySingleton<SignedUrlService>(
       () => SignedUrlService(i.get<BaseApiService>()),
     );
-    i.addSingleton<VerificationService>(
+    i.addLazySingleton<VerificationService>(
       () => VerificationService(i.get<BaseApiService>()),
     );
-    i.addSingleton<LlmService>(() => LlmService(i.get<BaseApiService>()));
-    i.addSingleton<RapidOrderService>(
+    i.addLazySingleton<LlmService>(() => LlmService(i.get<BaseApiService>()));
+    i.addLazySingleton<RapidOrderService>(
       () => RapidOrderService(i.get<BaseApiService>()),
     );
 
     // 4. Register Device dependency
-    i.addSingleton<ImagePicker>(() => ImagePicker());
+    i.addLazySingleton<ImagePicker>(() => ImagePicker());
 
     // 5. Register Device Services
-    i.addSingleton<CameraService>(() => CameraService(i.get<ImagePicker>()));
-    i.addSingleton<GalleryService>(() => GalleryService(i.get<ImagePicker>()));
-    i.addSingleton<FilePickerService>(FilePickerService.new);
-    i.addSingleton<AudioRecorderService>(AudioRecorderService.new);
-    i.addSingleton<DeviceFileUploadService>(
+    i.addLazySingleton<CameraService>(() => CameraService(i.get<ImagePicker>()));
+    i.addLazySingleton<GalleryService>(() => GalleryService(i.get<ImagePicker>()));
+    i.addLazySingleton<FilePickerService>(FilePickerService.new);
+    i.addLazySingleton<AudioRecorderService>(AudioRecorderService.new);
+    i.addLazySingleton<DeviceFileUploadService>(
       () => DeviceFileUploadService(
         cameraService: i.get<CameraService>(),
         galleryService: i.get<GalleryService>(),

apps/mobile/packages/core/lib/src/routing/client/navigator.dart

@@ -210,6 +210,13 @@ extension ClientNavigator on IModularNavigator {
     safePush(ClientPaths.createOrderPermanent, arguments: arguments);
   }
 
+  /// Pushes the review order page before submission.
+  ///
+  /// Returns `true` if the user confirmed submission, `null` if they went back.
+  Future<bool?> toCreateOrderReview({Object? arguments}) async {
+    return safePush<bool>(ClientPaths.createOrderReview, arguments: arguments);
+  }
+
   // ==========================================================================
   // VIEW ORDER
   // ==========================================================================

apps/mobile/packages/core/lib/src/routing/client/route_paths.dart

@@ -154,4 +154,9 @@ class ClientPaths {
   ///
   /// Create a long-term or permanent staffing position.
   static const String createOrderPermanent = '/create-order/permanent';
+
+  /// Review order before submission.
+  ///
+  /// Summary page shown before posting any order type.
+  static const String createOrderReview = '/create-order/review';
 }

apps/mobile/packages/core_localization/lib/src/data/repositories_impl/locale_repository_impl.dart

@@ -1,4 +1,5 @@
 import 'dart:ui';
+
 import 'package:core_localization/src/l10n/strings.g.dart';
 
 import '../../domain/repositories/locale_repository_interface.dart';
@@ -31,12 +32,10 @@ class LocaleRepositoryImpl implements LocaleRepositoryInterface {
     return getDefaultLocale();
   }
 
+  /// We can hardcode this to english based on customer requirements, 
+  /// but in a more dynamic app this should be the device locale or a fallback to english.
   @override
   Locale getDefaultLocale() {
-    final Locale deviceLocale = AppLocaleUtils.findDeviceLocale().flutterLocale;
-    if (getSupportedLocales().contains(deviceLocale)) {
-      return deviceLocale;
-    }
     return const Locale('en');
   }
 

apps/mobile/packages/core_localization/lib/src/l10n/en.i18n.json

@@ -325,6 +325,8 @@
   "client_create_order": {
     "title": "Create Order",
     "section_title": "ORDER TYPE",
+    "no_vendors_title": "No Vendors Available",
+    "no_vendors_description": "There are no staffing vendors associated with your account.",
     "types": {
       "rapid": "RAPID",
       "rapid_desc": "URGENT same-day Coverage",
@@ -397,6 +399,33 @@
       "title": "Permanent Order",
       "subtitle": "Long-term staffing placement",
       "placeholder": "Permanent Order Flow (Work in Progress)"
+    },
+    "review": {
+      "invalid_arguments": "Unable to load order review. Please go back and try again.",
+      "title": "Review & Submit",
+      "subtitle": "Confirm details before posting",
+      "edit": "Edit",
+      "basics": "Basics",
+      "order_name": "Order Name",
+      "hub": "Hub",
+      "shift_contact": "Shift Contact",
+      "schedule": "Schedule",
+      "date": "Date",
+      "time": "Time",
+      "duration": "Duration",
+      "start_date": "Start Date",
+      "end_date": "End Date",
+      "repeat": "Repeat",
+      "positions": "POSITIONS",
+      "total": "Total",
+      "estimated_total": "Estimated Total",
+      "estimated_weekly_total": "Estimated Weekly Total",
+      "post_order": "Post Order",
+      "hours_suffix": "hrs"
+    },
+    "rapid_draft": {
+      "title": "Rapid Order",
+      "subtitle": "Verify the order details"
     }
   },
   "client_main": {
@@ -1249,7 +1278,7 @@
       "clock_in": "CLOCK IN",
       "decline": "DECLINE",
       "accept_shift": "ACCEPT SHIFT",
-      "apply_now": "APPLY NOW",
+      "apply_now": "BOOK SHIFT",
       "book_dialog": {
         "title": "Book Shift",
         "message": "Do you want to instantly book this shift?"
@@ -1665,9 +1694,44 @@
     "todays_cost": "Today's Cost",
     "no_shifts_day": "No shifts scheduled for this day",
     "no_workers_assigned": "No workers assigned yet",
+    "status_checked_in_at": "Checked In at $time",
+    "status_on_site": "On Site",
+    "status_en_route": "En Route",
+    "status_en_route_expected": "En Route - Expected $time",
+    "status_confirmed": "Confirmed",
+    "status_running_late": "Running Late",
+    "status_late": "Late",
+    "status_checked_out": "Checked Out",
+    "status_done": "Done",
+    "status_no_show": "No Show",
+    "status_completed": "Completed",
     "worker_row": {
       "verify": "Verify",
       "verified_message": "Worker attire verified for $name"
+    },
+    "page": {
+      "daily_coverage": "Daily Coverage",
+      "coverage_status": "Coverage Status",
+      "workers": "Workers",
+      "error_occurred": "An error occurred",
+      "retry": "Retry",
+      "shifts": "Shifts"
+    },
+    "calendar": {
+      "prev_week": "\u2190 Prev Week",
+      "today": "Today",
+      "next_week": "Next Week \u2192"
+    },
+    "stats": {
+      "checked_in": "Checked In",
+      "en_route": "En Route"
+    },
+    "alert": {
+      "workers_running_late(count)": {
+        "one": "$count worker is running late",
+        "other": "$count workers are running late"
+      },
+      "auto_backup_searching": "Auto-backup system is searching for replacements."
     }
   },
   "client_reports_common": {

apps/mobile/packages/core_localization/lib/src/l10n/es.i18n.json

@@ -325,6 +325,8 @@
   "client_create_order": {
     "title": "Crear Orden",
     "section_title": "TIPO DE ORDEN",
+    "no_vendors_title": "No Hay Proveedores Disponibles",
+    "no_vendors_description": "No hay proveedores de personal asociados con su cuenta.",
     "types": {
       "rapid": "R\u00c1PIDO",
       "rapid_desc": "Cobertura URGENTE mismo d\u00eda",
@@ -397,6 +399,33 @@
       "title": "Orden Permanente",
       "subtitle": "Colocaci\u00f3n de personal a largo plazo",
       "placeholder": "Flujo de Orden Permanente (Trabajo en Progreso)"
+    },
+    "review": {
+      "invalid_arguments": "No se pudo cargar la revisi\u00f3n de la orden. Por favor, regresa e intenta de nuevo.",
+      "title": "Revisar y Enviar",
+      "subtitle": "Confirma los detalles antes de publicar",
+      "edit": "Editar",
+      "basics": "Datos B\u00e1sicos",
+      "order_name": "Nombre de la Orden",
+      "hub": "Hub",
+      "shift_contact": "Contacto del Turno",
+      "schedule": "Horario",
+      "date": "Fecha",
+      "time": "Hora",
+      "duration": "Duraci\u00f3n",
+      "start_date": "Fecha de Inicio",
+      "end_date": "Fecha de Fin",
+      "repeat": "Repetir",
+      "positions": "POSICIONES",
+      "total": "Total",
+      "estimated_total": "Total Estimado",
+      "estimated_weekly_total": "Total Semanal Estimado",
+      "post_order": "Publicar Orden",
+      "hours_suffix": "hrs"
+    },
+    "rapid_draft": {
+      "title": "Orden R\u00e1pida",
+      "subtitle": "Verifica los detalles de la orden"
     }
   },
   "client_main": {
@@ -1244,7 +1273,7 @@
       "clock_in": "ENTRADA",
       "decline": "RECHAZAR",
       "accept_shift": "ACEPTAR TURNO",
-      "apply_now": "SOLICITAR AHORA",
+      "apply_now": "RESERVAR TURNO",
       "book_dialog": {
         "title": "Reservar turno",
         "message": "\u00bfDesea reservar este turno al instante?"
@@ -1665,9 +1694,44 @@
     "todays_cost": "Costo de Hoy",
     "no_shifts_day": "No hay turnos programados para este día",
     "no_workers_assigned": "Aún no hay trabajadores asignados",
+    "status_checked_in_at": "Registrado a las $time",
+    "status_on_site": "En Sitio",
+    "status_en_route": "En Camino",
+    "status_en_route_expected": "En Camino - Esperado $time",
+    "status_confirmed": "Confirmado",
+    "status_running_late": "Llegando Tarde",
+    "status_late": "Tarde",
+    "status_checked_out": "Salida Registrada",
+    "status_done": "Hecho",
+    "status_no_show": "No Se Presentó",
+    "status_completed": "Completado",
     "worker_row": {
       "verify": "Verificar",
       "verified_message": "Vestimenta del trabajador verificada para $name"
+    },
+    "page": {
+      "daily_coverage": "Cobertura Diaria",
+      "coverage_status": "Estado de Cobertura",
+      "workers": "Trabajadores",
+      "error_occurred": "Ocurri\u00f3 un error",
+      "retry": "Reintentar",
+      "shifts": "Turnos"
+    },
+    "calendar": {
+      "prev_week": "\u2190 Semana Anterior",
+      "today": "Hoy",
+      "next_week": "Semana Siguiente \u2192"
+    },
+    "stats": {
+      "checked_in": "Registrado",
+      "en_route": "En Camino"
+    },
+    "alert": {
+      "workers_running_late(count)": {
+        "one": "$count trabajador est\u00e1 llegando tarde",
+        "other": "$count trabajadores est\u00e1n llegando tarde"
+      },
+      "auto_backup_searching": "El sistema de respaldo autom\u00e1tico est\u00e1 buscando reemplazos."
     }
   },
   "client_reports_common": {

apps/mobile/packages/data_connect/lib/src/connectors/hubs/data/repositories/hubs_connector_repository_impl.dart

@@ -1,10 +1,12 @@
 // ignore_for_file: always_specify_types, depend_on_referenced_packages, dead_code, dead_null_aware_expression, unused_local_variable, unused_import, sort_constructors_first, prefer_final_fields, prefer_const_constructors, deprecated_member_use, implicit_call_tearoffs
 import 'dart:convert';
-import 'package:firebase_data_connect/src/core/ref.dart';
+
+import 'package:firebase_data_connect/firebase_data_connect.dart';
 import 'package:http/http.dart' as http;
 import 'package:krow_core/core.dart';
 import 'package:krow_data_connect/krow_data_connect.dart' as dc;
 import 'package:krow_domain/krow_domain.dart';
+
 import '../../domain/repositories/hubs_connector_repository.dart';
 
 /// Implementation of [HubsConnectorRepository].