What is hub_ios?

This repository is the iOS-specific configuration folder for CixioHub, a mobile chat application built with Flutter. Flutter is a development framework that lets a single codebase compile to both iOS and Android apps at the same time, so one set of source files produces apps for both platforms. The actual application code lives in a separate folder called mobile/ within the broader workspace, not here. The ios/ folder that this repository covers contains files generated by Flutter for the iOS build system: things like the Xcode project file, configuration plists, and other iOS-specific metadata. You would rarely edit these files directly. The one area where direct edits are needed is setting up push notifications through Apple's notification service, called APNs. The README describes what an iOS developer working on CixioHub would be expected to deliver. That list includes building all the main app screens (login, registration, chat, documents, to-do lists, profile, and settings), wiring up push notifications and deep links so tapping a notification opens the relevant screen, handling camera and gallery access for profile photos, and caching the last ten chat sessions locally for offline access. Running the project on iOS requires macOS, Xcode 15 or newer, Flutter SDK version 3.x, and either a physical iPhone or an iOS Simulator. The app registers a device token with the backend on login, push notifications are then delivered via AWS SNS or Firebase Cloud Messaging. APNs does not work on the iOS Simulator, so testing push notifications requires a real device. The demo the README describes should show the app running on both iOS Simulator and an Android emulator from the same Flutter code, a full chat flow including streaming AI responses, at least one additional module such as documents or to-dos working, and the backend logs confirming that a device token was received.