hub_ios

KO | EN

gitlite — search

#python #hacktoberfest #nodejs #javascript #typescript #nextjs #css #reactjs #golang #rust #react #deep-learning

★ 30 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# iOS — CixioHub Mobile (Flutter)

> **Important:** CixioHub's mobile app is built with **Flutter** — a single Dart codebase that compiles to both iOS and Android. You do **not** write separate native Swift code. The Flutter project lives in `mobile/` at the workspace root.
>
> This folder (`ios/`) contains the iOS-specific build configuration generated by Flutter (Runner.xcodeproj, Info.plist, etc.). You rarely need to edit files here directly, except for APNs push notification setup.

---

## For iOS Developers

Your primary working directory is **`mobile/`** (the Flutter project).

See [`mobile/README.md`](../mobile/README.md) for full setup and implementation instructions.

---

## What you build (iOS developer role)

| Deliverable | Description |
|------------|-------------|
| Flutter app — all screens | Login, Register, Chat, Documents, Todos, Profile, Settings |
| APNs integration | Register for push notifications, handle foreground + background + terminated states |
| Deep links (Universal Links) | Tap on a push notification → open the relevant screen |
| Camera + gallery | Profile picture upload (iOS permission handling) |
| Offline cache | Cache last 10 chat sessions locally |

---

## iOS-specific setup

### Prerequisites
- macOS only
- Xcode 15+
- iOS 16+ deployment target
- Flutter SDK 3.x
- A physical iPhone or iOS Simulator

### Run on iOS Simulator

```bash
# From the mobile/ directory:
flutter run -d ios

# Or:
open ios/Runner.xcworkspace   # Open in Xcode, then press Run
```

### Release build

```bash
flutter build ios --release
# Then archive and distribute via Xcode
```

---

## APNs (Push Notifications) Setup

iOS push notifications use **Apple Push Notification service (APNs)**, delivered via **AWS SNS** or **Firebase Cloud Messaging**.

1. In Xcode: go to Runner → Signing & Capabilities → add **Push Notifications** capability
2. Also add **Background Modes** → enable "Remote notifications"
3. On a real device, the app registers with APNs and receives a device token
4. Send this token to the backend on login: `PUT /api/v1/auth/profile` with `{ "device_token": "..." }`
5. The notify service (via AWS SNS or FCM) uses this token to send pushes

> **Note:** APNs does not work on iOS Simulator. Test on a real device for push notifications.

---

## Demo expectations

Your demo should show:
1. App running on iOS Simulator **and** Android emulator (same Flutter code)
2. Full chat flow: login → new session → send message → streaming AI response
3. At least one extra module working (documents or todos)
4. APNs token registration flow visible (check backend logs showing token was received)

---

## Related

| | |
|---|---|
| Flutter project | [`mobile/`](../mobile/) |
| Android target | [`android/`](../android/) — same Flutter codebase |
| Backend API | [`backend/`](../backend/) |
| Notify service | [`notify/`](../notify/) — sends push notifications |

hub_ios

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README