Flutter Engineering
Baseline Flutter engineering for HeyEddi apps. Detects which stacks apply and adds the correct tooling: Vue projects should use @project-engineering instead.
Subagents (default)
Delegate scaffold/audit/test scripts to Task shell; repo discovery to explore. Main chat picks stack from audit JSON. See reference/subagents.md.
Stacks
| Stack |
When |
Tooling added |
| Flutter |
Mobile / web frontend |
pubspec.yaml, Riverpod, go_router, Material 3, widget tests |
| FastAPI |
REST API backend |
backend/, pytest, openapi.json, uvicorn on 8090 |
| Firebase |
Firestore / Auth |
firebase.json, rules, emulators |
Declare intent in .heyeddi/stack.json:
{
"frontend": "flutter",
"backends": ["fastapi"],
"web_port": 8085,
"api_port": 8090
}
Or "backends": ["firebase"] or ["fastapi", "firebase"].
Workflow
- Prefs gate (always-on hard):
@heyeddi-setup verify_setup --check before git/CI/commit assumptions; incomplete → run setup until pass.
audit_scaffold: per-layer JSON (flutter / fastapi / firebase).
scaffold_stack --stack auto: fills gaps (flutter, fastapi, firebase, or full).
ensure_flutter + ensure_python (via @project-engineering) as needed.
dev_server_info: Flutter web :8085, API :8090, Firebase emulators :4000.
- Plan gate (always-on):
@engineering-excellence check_engineering_plan --check before feature code.
- Implement features (
@design-handoff-flutter, @flutter-patterns, @dart-type-bridger).
run_tests + run_backend_tests + verify_build.
- Change gate (always-on):
audit_engineering --check (errors fail; warns advisory).
Local dev servers
Set FLUTTER_WEB_URL (or DEV_SERVER_URL) for @visual-auditor when auditing Flutter web.
References
reference/dev-server.md: Flutter web + mobile
reference/fastapi-client.md: Dio + OpenAPI types
reference/firebase-client.md: firebase_core + Firestore
reference/heyeddi-handoff.md: chain @design-handoff-flutter
Related skills
@dart-type-bridger: OpenAPI / Firestore → Dart models
@flutter-patterns: repositories, Riverpod providers, auth
@design-handoff-flutter: screenshot → Material widgets
@project-engineering: shared FastAPI/Firebase scaffolds (invoked by scaffold_stack)
When the task is complete: suggest next skills
When you have finished the user's request for this skill (not after every tool call or subagent phase), suggest what to run next:
Run:
python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill flutter-engineering --project-root .
Add --route /path if you worked a specific route.
Include the script's ### Next step block in your final reply. The user copies the Prompt line into chat (e.g. @heyeddi-design craft /settings).
Pass --mode shape (or craft, audit, etc.) when you know which sub-command just finished.
See @heyeddi → reference/next-skill-handoff.md.
1---2name: flutter-engineering3description: "Ensures HeyEddi Flutter projects have the right engineering stack: Flutter (Riverpod, go_router, Material 3), FastAPI backend, or Firebase tooling. Audits gaps, scaffolds as needed, runs flutter test/analyze, documents local dev servers. Use when frontend is Flutter or before design/feature work on a HeyEddi mobile/web app."4version: 1.0.05product-version: 3.8.186author: HeyEddi-com7paths:8 - "pubspec.yaml"9 - "lib/**"10 - "pyproject.toml"11 - "backend/**"12 - "firebase.json"13 - "openapi.json"14 - ".heyeddi/**"15metadata:16 source: https://skillmd.com/skills/heyeddi-com/flutter-engineering17---1819# Flutter Engineering2021Baseline **Flutter engineering** for HeyEddi apps. Detects which stacks apply and adds the correct tooling: Vue projects should use `@project-engineering` instead.2223## Subagents (default)2425Delegate scaffold/audit/test scripts to **Task** `shell`; repo discovery to `explore`. Main chat picks stack from audit JSON. See `reference/subagents.md`.2627## Stacks2829| Stack | When | Tooling added |30|-------|------|----------------|31| **Flutter** | Mobile / web frontend | `pubspec.yaml`, Riverpod, go_router, Material 3, widget tests |32| **FastAPI** | REST API backend | `backend/`, pytest, `openapi.json`, uvicorn on **8090** |33| **Firebase** | Firestore / Auth | `firebase.json`, rules, emulators |3435Declare intent in `.heyeddi/stack.json`:3637```json38{39 "frontend": "flutter",40 "backends": ["fastapi"],41 "web_port": 8085,42 "api_port": 809043}44```4546Or `"backends": ["firebase"]` or `["fastapi", "firebase"]`.4748## Workflow49501. **Prefs gate (always-on hard):** `@heyeddi-setup` `verify_setup --check` before git/CI/commit assumptions; incomplete → run setup until pass.512. **`audit_scaffold`**: per-layer JSON (flutter / fastapi / firebase).523. **`scaffold_stack --stack auto`**: fills gaps (`flutter`, `fastapi`, `firebase`, or `full`).534. **`ensure_flutter`** + **`ensure_python`** (via `@project-engineering`) as needed.545. **`dev_server_info`**: Flutter web `:8085`, API `:8090`, Firebase emulators `:4000`.556. **Plan gate (always-on):** `@engineering-excellence` `check_engineering_plan --check` before feature code.567. Implement features (`@design-handoff-flutter`, `@flutter-patterns`, `@dart-type-bridger`).578. **`run_tests`** + **`run_backend_tests`** + **`verify_build`**.589. **Change gate (always-on):** `audit_engineering --check` (errors fail; warns advisory).5960## Local dev servers6162| Stack | Command | URL |63|-------|---------|-----|64| Flutter web | `flutter run -d web-server --web-port=8085 --web-hostname=127.0.0.1` | http://127.0.0.1:8085 |65| Flutter mobile | `flutter run` | device / emulator |66| FastAPI | `cd backend && poetry run uvicorn app.main:app --reload --port 8090` | http://127.0.0.1:8090/docs |67| Firebase | `firebase emulators:start` | http://localhost:4000 |6869Set `FLUTTER_WEB_URL` (or `DEV_SERVER_URL`) for `@visual-auditor` when auditing Flutter web.7071## References7273- `reference/dev-server.md`: Flutter web + mobile74- `reference/fastapi-client.md`: Dio + OpenAPI types75- `reference/firebase-client.md`: firebase_core + Firestore76- `reference/heyeddi-handoff.md`: chain `@design-handoff-flutter`7778## Related skills7980- `@dart-type-bridger`: OpenAPI / Firestore → Dart models81- `@flutter-patterns`: repositories, Riverpod providers, auth82- `@design-handoff-flutter`: screenshot → Material widgets83- `@project-engineering`: shared FastAPI/Firebase scaffolds (invoked by `scaffold_stack`)84## When the task is complete: suggest next skills8586When you have **finished the user's request** for this skill (not after every tool call or subagent phase), suggest what to run next:87881. Run:8990 ```bash91 python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill flutter-engineering --project-root .92 ```9394 Add `--route /path` if you worked a specific route.95962. Include the script's **`### Next step`** block in your **final** reply. The user copies the **Prompt** line into chat (e.g. `@heyeddi-design craft /settings`).9798Pass `--mode shape` (or `craft`, `audit`, etc.) when you know which sub-command just finished.99100See `@heyeddi` → `reference/next-skill-handoff.md`.101