Flutter engineering

Skill HeyEddi-com/skills/evals/runs/2026-07-04T22-58-59Z/flutter-engineering-scaffold/.cursor/skills/flutter-engineering

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.From its SKILL.md

Install

npx -y skills add HeyEddi-com/skills --skill flutter-engineering

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.0 KB, 713 tokens by cl100k_base, as published. Nobody here has run it

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

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.
Implement features (@design-handoff-flutter, @flutter-patterns, @dart-type-bridger).
run_tests + run_backend_tests + verify_build.

Local dev servers

Stack	Command	URL
Flutter web	`flutter run -d web-server --web-port=8085 --web-hostname=127.0.0.1`	http://127.0.0.1:8085
Flutter mobile	`flutter run`	device / emulator
FastAPI	`cd backend && poetry run uvicorn app.main:app --reload --port 8090`	http://127.0.0.1:8090/docs
Firebase	`firebase emulators:start`	http://localhost:4000

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)

What ships with it: 36 files

41.8 KB alongside SKILL.md, 12 of them executable

context/

reference/

scaffold/

flutter/analysis_options.yaml121 B
flutter/lib/app.dart433 B
flutter/lib/config/env.dart304 B
flutter/lib/main.dart231 B
flutter/lib/router/app_router.dart433 B
flutter/lib/screens/home_screen.dart733 B
flutter/lib/screens/settings_screen.dart1.5 KB
flutter/lib/services/api_client.dart632 B
flutter/lib/theme/app_theme.dart1.3 KB
flutter/lib/widgets/app_shell.dart1.1 KB
flutter/pubspec.yaml375 B
flutter/test/widget_test.dart344 B
stack-flutter-fastapi.json95 B
stack-flutter-full.json107 B
stack-flutter.json86 B

scripts/

manifest.json3.2 KB