mcpField
F
flutter-engineering

flutter-engineering

github.com/heyeddi-comDevelopment096 installsUpdated 1d ago
Repository

About flutter-engineering

flutter-engineering is an engineering skill for HeyEddi app development that audits and fills scaffolding for Flutter, FastAPI, and Firebase projects. It organizes work around layer audits, build and test steps, and plan and change checks.

Key features

  1. 01Detect Flutter, FastAPI, and Firebase stacks
  2. 02Audit and fill project scaffolding
  3. 03Provide local development server workflows
  4. 04Run frontend and backend tests and build checks
  5. 05Require plan and change review gates

Use cases

  1. 01Scaffold a Flutter mobile or web frontend
  2. 02Set up a FastAPI REST API backend
  3. 03Configure Firebase for Firestore or Auth
  4. 04Validate feature changes through defined checks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill flutter-engineering

After installing, type/flutter-engineeringin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

manifest.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
reference/
design-handoff.md
dev-server.md
fastapi-client.md
firebase-client.md
subagents.md
scaffold/
stack-flutter-fastapi.json
stack-flutter-full.json
stack-flutter.json
scaffold/flutter/
analysis_options.yaml
pubspec.yaml
scaffold/flutter/lib/
app.dart
main.dart
scaffold/flutter/lib/config/
env.dart
scaffold/flutter/lib/router/
app_router.dart
scaffold/flutter/lib/screens/
home_screen.dart
settings_screen.dart
scaffold/flutter/lib/services/
api_client.dart
scaffold/flutter/lib/theme/
app_theme.dart
scaffold/flutter/lib/widgets/
app_shell.dart
scaffold/flutter/test/
widget_test.dart
scripts/
_heyeddi_paths.py
_project_detect.py
_skill_cli.py
audit_scaffold.py
dev_server_info.py

Details

From the project README

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

StackWhenTooling added
FlutterMobile / web frontendpubspec.yaml, Riverpod, go_router, Material 3, widget tests
FastAPIREST API backendbackend/, pytest, openapi.json, uvicorn on 8090
FirebaseFirestore / Authfirebase.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

  1. Prefs gate (always-on hard): @heyeddi-setup verify_setup --check before git/CI/commit assumptions; incomplete → run setup until pass.
  2. audit_scaffold: per-layer JSON (flutter / fastapi / firebase).
  3. scaffold_stack --stack auto: fills gaps (flutter, fastapi, firebase, or full).
  4. ensure_flutter + ensure_python (via @project-engineering) as needed.
  5. dev_server_info: Flutter web :8085, API :8090, Firebase emulators :4000.
  6. Plan gate (always-on): @engineering-excellence check_engineering_plan --check before feature code.
  7. Implement features (@design-handoff-flutter, @flutter-patterns, @dart-type-bridger).
  8. run_tests + run_backend_tests + verify_build.
  9. Change gate (always-on): audit_engineering --check (errors fail; warns advisory).

Local dev servers

StackCommandURL
Flutter webflutter run -d web-server --web-port=8085 --web-hostname=127.0.0.1http://127.0.0.1:8085
Flutter mobileflutter rundevice / emulator
FastAPIcd backend && poetry run uvicorn app.main:app --reload --port 8090http://127.0.0.1:8090/docs
Firebasefirebase emulators:starthttp://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)

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:

  1. 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.

  2. 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.

Comments

Markdown supported