focus-flow/apps/focus_flow_flutter

FocusFlow Flutter

Flutter desktop app target for the FocusFlow UI work.

Current Scope

The app launches into the compact Today timeline. Normal startup now opens an on-disk SQLite database and bootstraps owner settings plus the default Home project when they are missing.

The compact Today screen can toggle completion for currently rendered task cards. Backlog widgets and quick-capture controls exist for tests and focused composition paths, but the sidebar Backlog navigation remains out of scope for this screen.

Runtime Data

Normal runtime uses lib/app/persistent_scheduler_composition.dart, which reads SCHEDULER_SQLITE_PATH from a Dart define. If no define is present, it uses the local dev convention:

~/ADHD_Scheduler/scheduler.sqlite

Static demo data still lives in lib/app/demo_scheduler_composition.dart, but it is for deterministic widget/visual tests and explicit demo composition only. It is not inserted during normal startup.

Widgets consume TodayScreenData from lib/models/today_screen_models.dart. Scheduler core remains the source of truth for task state and Today ordering.

Package Boundary

Allowed app imports include public scheduler APIs such as:

import 'package:scheduler_core/scheduler_core.dart';

The persistent composition root may import package:scheduler_persistence_sqlite/sqlite.dart and dart:io for runtime path resolution. Widgets/controllers must not import scheduler src/ files, Drift, SQLite adapters, desktop notification implementations, backup/export packages, or direct OS APIs. test/forbidden_imports_test.dart enforces that boundary.

Intentionally No-op

• Sidebar navigation.
• Date navigation and calendar buttons.
• Compact/Normal toggle.
• Settings button.
• Show upcoming.
• Timeline card action icons.
• Modal Push, Move to Backlog, and Break up buttons.

Persistence Proof

Current focused tests prove:

• first run opens an empty SQLite file without seeded task rows,
• quick capture writes a backlog task,
• scheduling writes planned Today placement,
• done and not-done state persists,
• closing and reopening the same SQLite file reloads the task state.

Manual verification:

scripts/bootstrap_dev.sh
scripts/dev.sh --sqlite /tmp/focus_flow_persistence_plan_1.sqlite

Use the same --sqlite path after closing the app to confirm state persists. To reset local dev data, close the app and delete the chosen .sqlite file. This is only a dev reset; backup/restore UI remains out of scope.

Commands

flutter pub get
flutter analyze
flutter test

Run these from apps/focus_flow_flutter/.

Next Plans

• Wire visible Backlog navigation and quick-capture UI into the main shell.
• Wire functional Push, Move to Backlog, and Break up actions.
• Add real navigation/settings.
• Add Shield/Recovery only in a later scope.