Skip to content

feat(mobile): Flutter iOS app with Phase 1 features#2

Open
dnplkndll wants to merge 15 commits into
developfrom
feat/flutter-mobile-app
Open

feat(mobile): Flutter iOS app with Phase 1 features#2
dnplkndll wants to merge 15 commits into
developfrom
feat/flutter-mobile-app

Conversation

@dnplkndll
Copy link
Copy Markdown

@dnplkndll dnplkndll commented Mar 25, 2026 •
edited
Loading

Summary

Flutter mobile app for self-hosted Huly — complete implementation across 11 commits.

Commits

Commit Description
`6518691` Phase 1 — Auth (OTP, password, OAuth, 2FA), issue CRUD, status, search, refresh
`3f9a2ae` Phase 2 — Member name resolution, activity feed, settings, bottom nav
`ab37e90` Phase 3 — Chunter chat (channel/DM list, message thread, send)
`bb7fd03` Phase 4 — Lifecycle-aware polling
`460a5f5` Review — Extract MessageBubble, stripHtml, formatTimestamp
`706fbe4` Comments — Post comments on issues
`a49594e` Attachments — Upload files via blob API
`9e31c88` Biometric auth — Face ID / fingerprint lock
`01bee39` WebSocket — Real-time Tx events with Huly protocol
`1eef68f` Push notifications — FCM integration

Features

Auth & Security

  • OTP, password, OAuth (Google/GitHub/OIDC) via `huly://` custom scheme
  • 2FA/TOTP verification
  • Biometric lock (Face ID / fingerprint)
  • Secure token storage (iOS Keychain)

Issue Tracking

  • List/detail/create/edit with TxUpdateDoc
  • Status management, client-side search/filter
  • Activity feed + comment posting
  • File attachments (image picker → blob upload)
  • Assignee name resolution

Chunter Chat

  • Channel + DM list with member name resolution
  • Message thread with send, shared MessageBubble widget
  • 10s polling + WebSocket real-time

Real-Time

  • WebSocket: Huly protocol (HelloRequest/HelloResponse, ping/pong, Tx streaming)
  • dataVersionProvider: Auto-refreshes all providers on Tx events
  • Polling fallback: Keeps working during WebSocket gaps
  • Push notifications: FCM token registered as PushSubscription
    • Works with existing Huly notification service (no server changes)
    • Foreground display via flutter_local_notifications
    • Requires GoogleService-Info.plist; gracefully disabled without it

Navigation & UX

  • Bottom nav: Issues / Chat / Settings
  • Settings: server info, workspace, biometric toggle, sign out
  • Lock screen with auto-biometric prompt

Architecture

  • State: Riverpod
  • Routing: go_router with ShellRoute
  • Models: freezed + json_serializable
  • HTTP: dio REST client
  • WebSocket: web_socket_channel + custom Huly protocol
  • Push: firebase_messaging + flutter_local_notifications
  • Storage: flutter_secure_storage

Testing

  • `flutter build ios --no-codesign` — passes
  • `flutter test` — 16/16 tests pass

@dnplkndll dnplkndll force-pushed the feat/flutter-mobile-app branch 4 times, most recently from df6d496 to 7084b9b Compare March 27, 2026 02:04
dnplkndll and others added 14 commits March 27, 2026 07:50
@dnplkndll @claude
feat(mobile): add Flutter iOS app with Phase 1 features
c2fdab7 
Flutter mobile app for self-hosted Huly with:
- Auth: OTP, password, OAuth (Google/GitHub/OIDC) via huly:// scheme
- 2FA/TOTP support (verify2fa flow with dedicated screen)
- Issue tracking: list, detail, create, edit with TxUpdateDoc
- Status management: fetch/display/edit issue statuses
- Client-side search/filter on issue list
- Auto-refresh (45s timer, pauses when backgrounded)
- Huly design system (dark theme, shared widgets)
- iOS share extension for quick issue creation
- Secure token storage (Keychain)
- Server-side mobileRedirect in authProviders

Architecture: Riverpod state, go_router, freezed models, dio HTTP

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll
docs: add mobile app roadmap and phase plan
ac4afc5 
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): phase 2 — member resolution, activity feed, navigation
490ffde 
- Add Member model (contact:class:Person) with provider
- Add ChatMessage model for activity/comments
- Resolve assignee names on issue detail and list screens
- Show activity feed (comments) on issue detail screen
- Add bottom navigation bar (Issues / Settings tabs)
- Add Settings screen (server info, workspace, sign out, version)
- Move logout from issue list AppBar to Settings screen

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): phase 3 — Chunter chat/messaging
2e7bf12 
- Add Channel model (channels + direct messages)
- Add chat provider (channels list, message fetch)
- Add channel list screen with DM name resolution
- Add message thread screen with real-time 10s polling
- Add send message support (TxCreateDoc for ChatMessage)
- Add buildCreateChatMessageTx to transaction builder
- Add Chat tab to bottom navigation bar

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): phase 4 — lifecycle-aware polling
96b473d 
- Add lifecycle-aware polling to channel list (30s, pauses when backgrounded)
- Add lifecycle-aware polling to message thread (10s, pauses when backgrounded)
- Add lifecycle-aware polling to issue list (45s, existing — no change)
- All polling pauses on AppLifecycleState.paused, resumes + immediate
  refresh on AppLifecycleState.resumed

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
refactor(mobile): extract shared utilities and fix review issues
2254f50 
DRY:
- Extract MessageBubble widget (was duplicated in activity feed + chat)
- Extract stripHtml() and formatTimestamp() to core/utils/html.dart
- Remove duplicated _formatTime methods

Fixes:
- Pass channel name via query params when navigating to message thread
- Remove redundant server-side sort in chat provider (client sort is sufficient)

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): add comment posting on issue detail
8bf0558 
- Convert IssueDetailScreen to stateful for text input
- Add comment input bar at bottom of issue detail (same pattern as chat)
- Post comments via buildCreateChatMessageTx
- Auto-refresh activity feed after posting

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): add file attachments on issues
c7af00a 
- Add image_picker dependency for gallery/camera access
- Add Attachment model (attachment:class:Attachment)
- Add uploadBlob() to REST client (PUT /api/v1/blob)
- Add buildCreateAttachmentTx() to transaction builder
- Add attachmentsProvider to fetch attachments per document
- Add attachments section to issue detail with upload button
- Display attachment list with file icon, name, and size

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): add biometric auth (Face ID / fingerprint)
075d51c 
- Add local_auth dependency for biometric authentication
- Add biometric toggle to Settings screen
- Add lock screen with auto-prompt on app restore
- Add AuthStatus.locked state with router redirect
- Store biometric preference in secure storage
- Auto-unlock prompt on lock screen load
- Sign out option from lock screen

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): add WebSocket real-time connection
3fb301a 
- Add HulyWebSocketClient implementing Huly protocol:
  - HelloRequest/HelloResponse handshake
  - Ping/pong keep-alive (10s interval)
  - JSON text mode (no compression for simplicity)
  - Tx event streaming via broadcast StreamController
  - Auto-reconnect with exponential backoff
- Add realtime_provider with dataVersionProvider
  - Increments on any Tx event, triggering provider rebuilds
- Wire WebSocket listener into _MainShell
- Update issuesProvider and channelProviders to watch dataVersionProvider
  for instant refresh on real-time events
- Keep polling as fallback for WebSocket connection gaps

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
feat(mobile): add push notifications via FCM
050978a 
- Add firebase_core, firebase_messaging, flutter_local_notifications deps
- Add PushNotificationService:
  - Request notification permission
  - Get FCM token and handle refresh
  - Display foreground notifications via flutter_local_notifications
  - Register FCM token as PushSubscription doc in workspace
    (FCM endpoints are valid Web Push endpoints — works with existing
    Huly notification service without server changes)
  - Background message handler
- Initialize Firebase in main.dart (graceful fallback if not configured)
- Register push subscription on workspace connection
- Add pushServiceProvider to realtime_provider

Note: Requires GoogleService-Info.plist (iOS) or google-services.json
(Android) to be added for Firebase to work. Without these files,
push is silently disabled and the app works normally.

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
ci(mobile): add GitHub Actions workflow for Flutter app
569cb42 
- Test job: flutter analyze + flutter test on every push/PR to mobile/
- iOS build job: build IPA, upload to TestFlight (on tags or manual trigger)
- Android build job: build AAB artifact (on tags or manual trigger)
- Manual workflow_dispatch with upload_testflight toggle

Required repo secrets for iOS signing + TestFlight:
  IOS_P12_BASE64, IOS_P12_PASSWORD, IOS_PROVISION_PROFILE_BASE64,
  IOS_KEYCHAIN_PASSWORD, ASC_KEY_ID, ASC_ISSUER_ID, ASC_API_KEY_BASE64

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
fix(mobile): fix white screen crash on launch
6213056 
- Remove ShareHandler.getPendingShare() from main() — platform channel
  not registered, causes MissingPluginException crash
- Remove Firebase init from main() — hangs without GoogleService-Info.plist
- Both will be initialized lazily after auth is complete
- Update generated plugin registrants for new dependencies

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll @claude
fix(mobile): fix flutter analyze warnings blocking CI
5b9926b 
- Fix catchError return type in realtime_provider.dart and websocket_client.dart
  (catchError handler must return Future's type)
- Remove unused issue_status.dart import from edit_issue_screen.dart

Signed-off-by: Don Kendall <kendall@donkendall.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Don Kendall <kendall@donkendall.com>
@dnplkndll dnplkndll force-pushed the feat/flutter-mobile-app branch from 7084b9b to 5b9926b Compare March 27, 2026 11:50
@dnplkndll
feat(mobile): add comprehensive tests and documentation for Flutter app
152b19f 
- Add unit and widget tests for Issues and Chat features
- Refactor EditIssueScreen to use shared HTML utilities
- Update root .gitignore to correctly track mobile/lib
- Enhance README.md with technical and architectural details
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@dnplkndll