Code Structure

final class NavigationRouter: ObservableObject {
    static let shared = NavigationRouter()
    
    @Published var navigationPath = NavigationPath()
    @Published var selectedTab: TabSelectionUniPrepStage = .hub
    @Published var showTabBar: Bool = true
    @Published private(set) var pendingNavigation: AppDestination?
    
    func navigate(to destination: AppDestination) {
        // Handles modal dismissal and navigation
    }
}

enum AppDestination: Hashable {
    case university(UniversityV2)
    case course(Course_V2)
    case groupChat(GroupChat)
    case userProfile(GroupUser)
    case accommodation(AccommodationV2)
    case event(CalendarEvent)
    case society(Society)
    // ... 90+ more cases
}

final class DeepLinkManager {
    static let shared = DeepLinkManager()
    
    func handle(url: URL) {
        // Parses URL and navigates to appropriate destination
        // Example: chapter://university/123
    }
}

@MainActor
class AppContainer: ObservableObject {
    static let shared = AppContainer()
    
    // Filter ViewModels
    @Published var searchUniFilter: UniversityV2FilterManager
    @Published var searchCourseFilter: CourseV2FilterViewModel
    
    // Core Managers (NOT @Published to avoid cascade re-renders)
    var authManager: AuthManager
    var locationManager: DeviceLocationManager
    var notificationManager = NotificationManager.shared
    
    // Data Services
    var searchCourseDataService: CourseDataServiceV2
    var searchUniversityDataService: UniversityDataServiceV2
    var shortlistManager: ShortlistV2Manager
    var whatsOnManager: WhatsOnManager
    
    // Auth State (only this triggers container updates)
    @Published private(set) var isAuthenticated: Bool = false
    @Published private(set) var userEnrollmentStatus: EnrollmentStatus?
}

Chapter/
├── ChapterApp.swift                 # App entry point
├── Navigation/                      # Navigation & routing
│   ├── NavigationRouter.swift      # Centralized navigation
│   ├── DeepLinkManager.swift       # Deep link handling
│   ├── AppDependencies.swift       # Dependency injection container
│   └── OrientationManager.swift    # Screen orientation control
├── Master Tab View/                # Main tab interface
│   ├── MasterTabView.swift        # Tab bar controller
│   └── TabSelectionUniPrepStage.swift
├── Hub/                            # Widget-based hub screen
│   ├── ChapterHubView.swift
│   └── ChapterWidgetManager.swift
├── Structs and Enums/             # Data models
│   ├── University_V2.swift        # University model
│   ├── Course_v2.swift           # Course model
│   ├── User/                     # User models
│   ├── Location.swift            # Location models
│   └── Misc.swift                # Misc shared models
├── Extensions/                    # Swift extensions
│   ├── Colours.swift             # Custom gradients & colors
│   ├── Extensions.swift          # General extensions
│   ├── Numbers.swift             # Number formatting
│   └── Shapes.swift              # Custom SwiftUI shapes
├── Helpers/                       # Reusable UI components
│   ├── Buttons.swift
│   ├── LoadingIndicatorView.swift
│   ├── SkeletonLoading.swift
│   └── WebView.swift
├── Search/                        # University & course search
├── Main Feed/                     # Social feed
├── Groups/                        # Group chats
├── Inbox/                         # Messages & notifications
├── Campus Feed/                   # Campus-specific content
├── MainCalendar/                  # Calendar & events
├── Accomodation/                  # Housing search
├── Career Paths/                  # Career guidance & arcade games
│   └── Career Arcade/            # SpriteKit mini-games
├── ChapterMatchV2/                # University matching algorithm
├── Shortlist V2/                  # Saved universities/courses
├── Compare V2/                    # Side-by-side comparison
├── Game/                          # Main world game (SpriteKit)
├── Onboarding V2/                 # User onboarding flow
├── Login Flow/                    # Authentication screens
├── UserV2 Profile/                # User profile & settings
├── Albums/                        # Photo albums
├── Checklist V2/                  # Tasks & to-dos
├── Digital CV/                    # CV builder
├── Societies + Sports Clubs/      # Extracurriculars
├── What's On?/                    # Events discovery
├── Error Handling/                # Error services
├── Assets.xcassets/               # Images & colors
└── Info.plist                     # App configuration

Accomodation/
├── AccommodationV2MainView.swift          # Main list view
├── AccommodationV2Manager.swift           # Business logic
├── AccommodationFiltersView.swift         # Filter UI
├── AccommodationV2.swift                  # Data model
└── Detail View/
    └── AccommodationV2DetailView.swift    # Detail screen

@MainActor
class AccommodationV2Manager: ObservableObject {
    @Published var accommodations: [AccommodationV2] = []
    @Published var isLoading = false
    
    private let supabase = AuthManager.shared.supabase
    
    func fetchAccommodations(for universityID: Int) async {
        isLoading = true
        defer { isLoading = false }
        
        do {
            let results: [AccommodationV2] = try await supabase
                .from("accommodations_v2")
                .select()
                .eq("university_id", value: universityID)
                .execute()
                .value
            
            self.accommodations = results
        } catch {
            print("Error fetching accommodations: \(error)")
        }
    }
}

class ImageService {
    func uploadProfilePicture(_ image: UIImage, userId: UUID) async throws -> String {
        // Upload to Cloudflare R2 or Supabase Storage
        // Return public URL
    }
}

struct UniversityV2: Codable, Identifiable {
    let id: Int
    let name: String
    let location: String
    let rankings: UniversityRankings?
    let demographics: Demographics?
    let sports: [SportsTeam]?
    // ... more properties
}

struct Course_V2: Codable, Identifiable {
    let id: UUID
    let name: String
    let uniID: Int
    let ucasPoints: Int?
    let modules: [CourseModule]?
    let ratings: CourseRatings?
    // ... more properties
}

struct GroupUser: Codable, Identifiable {
    let id: UUID
    var name: String
    var email: String?
    var uni_id: Int?
    var enrollmentStatus: EnrollmentStatus?
    var grades: [Grade]?
    var interests: [String]?
    var profilePictureURL: String?
    // ... more properties
}

class CourseDataServiceV2: ObservableObject {
    @Published var courses: [Course_V2] = []
    @Published var isLoading = false
    @Published var error: Error?
    
    private var cancellables = Set<AnyCancellable>()
}

func loadCourses() async {
    do {
        let courses = try await supabase
            .from("courses_v2")
            .select()
            .execute()
            .value
        
        await MainActor.run {
            self.courses = courses
        }
    } catch {
        print("Error: \(error)")
    }
}

struct CourseDetailView: View {
    @EnvironmentObject var container: AppContainer
    
    var body: some View {
        // Access services via container
        let _ = container.shortlistManager
    }
}

class AuthManager: ObservableObject {
    static let shared = AuthManager()
    
    @Published var currentUser: GroupUser?
    @Published var session: Session?
    
    let supabase: SupabaseClient
    
    func signIn(email: String, password: String) async throws {
        // Sign in with Supabase Auth
    }
    
    func signOut() async throws {
        // Sign out and clear session
    }
}

func searchUniversities(query: String) async throws -> [UniversityV2] {
    let results: [UniversityV2] = try await supabase
        .from("universities_v2")
        .select()
        .ilike("name", value: "%\(query)%")
        .order("name")
        .execute()
        .value
    
    return results
}

func subscribeToMessages(groupId: UUID) {
    let channel = supabase.channel("messages:\(groupId)")
    
    channel
        .on("postgres_changes", SupabaseFilter(
            event: .insert,
            schema: "public",
            table: "messages",
            filter: "group_id=eq.\(groupId)"
        )) { [weak self] payload in
            // Handle new message
        }
        .subscribe()
}

extension LinearGradient {
    static var canYouFeelTheLove: LinearGradient {
        LinearGradient(
            colors: [Color(hex: "F093FB"), Color(hex: "F5576C")],
            startPoint: .topLeading,
            endPoint: .bottomTrailing
        )
    }
    
    static var sexyBlue: LinearGradient { /* ... */ }
    static var sunset: LinearGradient { /* ... */ }
    static var explorer: LinearGradient { /* ... */ }
}

if isLoading {
    SkeletonLoading()
} else {
    ContentView()
}

Career Arcade/
├── Aim & Learn/
│   ├── AimLearnGameView.swift          # SwiftUI wrapper
│   ├── AimLearnGameScene.swift         # SpriteKit scene
│   └── AimLearnSupabaseService.swift   # Leaderboard API
├── Quick Think/
│   └── QuickThinkProfileView.swift
├── Day In Life/
│   └── DayInLifeRootView.swift
└── Leaderboard/
    └── ArcadeLeaderboardService.swift

struct AimLearnGameView: View {
    var body: some View {
        SpriteView(scene: AimLearnGameScene())
            .ignoresSafeArea()
    }
}

SUPABASE_URL = https://xxx.supabase.co
SUPABASE_ANON_KEY = eyJxxx...
MIXPANEL_TOKEN = abc123...