mobile-dev-agency

Implements Flutter animations and transitions. Use when adding implicit/explicit animations, page transitions, Hero animations, staggered lists, or integrating Rive/Lottie. Covers AnimationController, Curves, Tween, TweenAnimationBuilder, and Material 3 motion patterns.

Guides Flutter widget composition, Material Design 3 theming, responsive layouts, accessibility, and extraction patterns. Use when building UI components, designing responsive screens, setting up ThemeExtension, or deciding when to extract widgets. Starts with composition decisions before any code.

Android deployment guide for Flutter apps. Use when creating keystores, configuring signing in build.gradle, uploading to Google Play Console, setting up internal/beta/production tracks, configuring ProGuard/R8, or automating with Fastlane. Covers app bundles, staged rollouts, and Play App Signing.

iOS deployment guide for Flutter apps. Use when configuring code signing, uploading to TestFlight, submitting to App Store, setting up Fastlane automation, or troubleshooting iOS build issues. Covers certificates, provisioning profiles, Info.plist, entitlements, and privacy manifests.

Guides Clean Architecture implementation for Flutter apps. Use when deciding which layer code belongs in, structuring new features, or establishing dependency rules. Covers model/data/domain/presentation layers, feature-based organization, and file structure conventions.

Enforces Flutter code quality standards with reasoning-driven rules. Use PROACTIVELY when creating Dart files, writing functions, implementing features, or reviewing code. Covers code style, const usage, widget design, error handling patterns, import organization, and file size management. Starts with context assessment to apply rules proportionally.

Guides Riverpod 2.x state management with decision-first approach. Use when choosing provider types, implementing controllers, handling async state, deciding lifecycle (keepAlive vs autoDispose), or testing providers. Starts with WHY before HOW.

Backend integration decisions for Flutter apps. Use when choosing between REST/Firebase/GraphQL, selecting HTTP clients, designing repository patterns, implementing error handling strategies, or configuring authentication flows. Decision-first guide — code templates in REFERENCE.md.

Optimizes Flutter app performance using framework-aware decisions. Use when diagnosing jank, reducing rebuilds, optimizing lists/images, profiling with DevTools, fixing memory leaks, or improving startup time. Starts with mechanism explanations so you fix root causes, not symptoms.

Secures Flutter applications using threat-model-driven decisions. Use when implementing secure storage, protecting API keys, adding certificate pinning, validating input, configuring platform security, or auditing app security before release. Starts with threat profile assessment to determine WHICH measures are needed vs overkill.

Guides Flutter testing strategy and implementation. Use when deciding what to test, writing unit/widget/integration/golden tests, mocking with mocktail, testing Riverpod state management, or structuring test suites. Starts with what to test vs skip, then mock boundaries, then patterns.

Implements Flutter UI using Material 3 theming, design tokens via ThemeExtension, responsive/adaptive layouts, animation, haptics, atomic design patterns, Widgetbook catalogs, and accessibility. Use when building UI components, setting up theming systems, creating responsive layouts, adding animations or haptic feedback, organizing widget architecture, or auditing accessibility. Starts with WHY behind each design-to-code decision.

Design discovery session for mobile screens. Use when: starting a new screen, redesigning UI, user says 'I need a screen for...', 'design a page', 'what should this look like', 'help me think through the UI', or describes functionality without specifying design. MUST run before mobile-visual-design or flutter-ui-craft. Extracts JTBD, context, taste, hierarchy, and constraints through interactive conversation before any code is written.

Use when evaluating mockups or screenshots before development, reviewing implemented screens against design specs, auditing design system compliance, checking WCAG accessibility, doing pre-release design QA, or reviewing AI-generated designs for generic patterns. Covers usability heuristics, accessibility, visual consistency, platform correctness, and anti-slop detection.

Designs mobile UX using evidence-based patterns and cognitive principles. Use when building navigation, forms, onboarding, screen states (loading/empty/error), tap targets, gesture interactions, or choosing between bottom tabs vs drawer vs sheets. Starts with the WHY behind each pattern so you pick the right one — not just copy UI code.

Designs visually distinctive mobile interfaces with opinionated spacing, typography, color, elevation, animation, and dark mode systems. Use when choosing fonts, building color palettes, setting spacing tokens, designing elevation hierarchies, creating animation language, implementing dark mode, or when any UI feels "generic" or "AI-generated." Applies anti-AI-slop rules and 2026 design trends to produce work that passes the portfolio test.