bvandeusen/FabledApp
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
mobile app to connect to the fabled assistant
28 commits 2 branches 2 tags 624 KiB
  • Dart 77.2%
  • C++ 10.9%
  • CMake 8.6%
  • Swift 1.1%
  • Kotlin 0.9%
  • Other 1.3%
Find a file
Exact
bvandeusen 0999774f34
Some checks failed
CI / Analyze & test (push) Failing after 2s
Details
Build APK / Build release APK (push) Failing after 12s
Details
Add dev branch support to build workflow 
dev push  → artifact named fabledapp-dev-<sha>
main push → artifact named fabledapp-<sha>
tag push  → artifact + Forgejo Release

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-08 21:17:53 -04:00
.forgejo/workflows Add dev branch support to build workflow 2026-03-08 21:17:53 -04:00
android Add release signing config and fix missing INTERNET permission 2026-03-01 18:16:44 -05:00
assets/icon Remove indigo background from app icon, use transparent 2026-03-01 13:20:11 -05:00
ios Add Flutter platform stubs for iOS, web, Linux, macOS, Windows 2026-02-28 21:29:24 -05:00
lib Fix update dialog looping after download completes 2026-03-02 22:14:15 -05:00
linux Add self-hosted update system via Forgejo releases 2026-03-01 14:08:17 -05:00
macos Add self-hosted update system via Forgejo releases 2026-03-01 14:08:17 -05:00
test Initial commit: Fabled Android app 2026-02-28 21:28:53 -05:00
web Add Flutter platform stubs for iOS, web, Linux, macOS, Windows 2026-02-28 21:29:24 -05:00
windows Add Flutter platform stubs for iOS, web, Linux, macOS, Windows 2026-02-28 21:29:24 -05:00
.gitignore Initial commit: Fabled Android app 2026-02-28 21:28:53 -05:00
.metadata Initial commit: Fabled Android app 2026-02-28 21:28:53 -05:00
analysis_options.yaml Initial commit: Fabled Android app 2026-02-28 21:28:53 -05:00
pubspec.lock Migrate flutter_markdown → flutter_markdown_plus; fix app label 2026-03-01 14:26:01 -05:00
pubspec.yaml Add milestone data layer and redesign Projects tab 2026-03-02 21:33:45 -05:00
README.md Initial commit: Fabled Android app 2026-02-28 21:28:53 -05:00

README.md

Fabled — Android App

Native Android client for FabledAssistant, a self-hosted AI productivity assistant.

Features

  • Notes — create, edit, and browse markdown notes
  • Tasks — manage tasks with status (To Do / In Progress / Done) and priority
  • Chat — streaming AI conversations with real-time SSE response display
  • Quick Capture — FAB shortcut to create a note or task from anywhere
  • OAuth / SSO — authenticates via your server's configured OIDC provider; local username/password login also supported if enabled on the server
  • Session persistence — stays logged in across app restarts via a persistent cookie jar
  • Home screen widget — tap to open the chat screen directly from the Android launcher

Requirements

Getting Started

Prerequisites

  • Flutter 3.x SDK
  • Android Studio (for Android SDK and emulator)
  • JDK 17

Setup

flutter pub get
flutter run

On first launch, enter your FabledAssistant server URL (e.g. https://fabled.example.com) and sign in.

Architecture

lib/
├── main.dart                  # Entry point; resolves async deps before runApp
├── app.dart                   # GoRouter + auth redirect guards + shell nav
├── core/
│   ├── constants.dart         # Route name constants
│   └── exceptions.dart        # AppException hierarchy
├── data/
│   ├── api/                   # Dio HTTP layer (one class per resource)
│   ├── models/                # Plain Dart models with fromJson/toJson
│   └── repositories/          # Thin wrappers over API classes
└── providers/                 # Riverpod providers (state + dependency wiring)
    screens/                   # Flutter UI screens

Key packages: flutter_riverpod, go_router, dio + cookie_jar, flutter_inappwebview, flutter_markdown

Building a Release APK

flutter build apk --release

The signed APK will be at build/app/outputs/flutter-apk/app-release.apk.