MiniMax Flutter Dev

Flutter cross-platform development guide covering widget patterns, Riverpod/Bloc state management, GoRouter navigation, performance optimization, and platfor...

Security Scan

This is an instruction-only Flutter development guide whose requested capabilities and instructions match its stated purpose and do not ask for credentials or install code.

Purpose & Capability

The skill name/description describe Flutter development guidance and the SKILL.md contains only developer guidance, checklists, and references that align with that purpose. There are no unrelated environment variables, binaries, or install steps requested.

Instruction Scope

SKILL.md is purely documentation and runtime instructions are limited to guidance (patterns, checklists, references). It does not instruct the agent to read arbitrary host files, access credentials, or transmit data to third-party endpoints. Note: the references point to local Markdown files (references/*.md) that are not included; those are documentation links, not code execution instructions.

Install Mechanism

There is no install specification and no code files. As an instruction-only skill it does not write binaries to disk or download archives — this is the lowest-risk install model.

Credentials

The skill declares no required environment variables, no credentials, and no config paths. Nothing in the SKILL.md attempts to use secrets or unrelated environment state.

Persistence & Privilege

always is false, user-invocable is true, and model invocation is allowed (disable-model-invocation false). Autonomous invocation is the platform default; given the skill has no install or credentials, this is not a substantive risk here.

Assessment

This skill is an instruction-only Flutter/Dart development guide and appears internally consistent: it asks for nothing sensitive and installs nothing. That said, the skill's source/homepage are unknown and the package includes references to documentation files that are not bundled—so you should: (1) be comfortable with the unknown provenance before trusting it in automated workflows, (2) review the guide content for accuracy and style you want, and (3) if you plan to allow autonomous invocation, be aware the agent may produce code or suggestions based on this guidance (but the skill itself will not install software or access secrets). If you need provenance guarantees, prefer skills with a verifiable homepage or well-known publisher.

Flutter Development Guide

A practical guide for building cross-platform applications with Flutter 3 and Dart. Focuses on proven patterns, state management, and performance optimization.

Quick Reference

Widget Patterns

Purpose	Component
State management (simple)	StateProvider + ConsumerWidget
State management (complex)	NotifierProvider / Bloc
Async data	FutureProvider / AsyncNotifierProvider
Real-time streams	StreamProvider
Navigation	GoRouter + context.go/push
Responsive layout	LayoutBuilder + breakpoints
List display	ListView.builder
Complex scrolling	CustomScrollView + Slivers
Hooks	HookWidget + useState/useEffect
Forms	Form + TextFormField + validation

Performance Patterns

Purpose	Solution
Prevent rebuilds	const constructors
Selective updates	ref.watch(provider.select(...))
Isolate repaints	RepaintBoundary
Lazy lists	ListView.builder
Heavy computation	compute() isolate
Image caching	cached_network_image

Core Principles

Widget Optimization

• Use const constructors wherever possible
• Extract static widgets to separate const classes
• Use Key for list items (ValueKey, ObjectKey)
• Prefer ConsumerWidget over StatefulWidget for state

State Management

• Riverpod for dependency injection and simple state
• Bloc/Cubit for event-driven workflows and complex logic
• Never mutate state directly (create new instances)
• Use select() to minimize rebuilds

Layout

• 8pt spacing increments (8, 16, 24, 32, 48)
• Responsive breakpoints: mobile (<650), tablet (650-1100), desktop (>1100)
• Support all screen sizes with flexible layouts
• Follow Material 3 / Cupertino design guidelines

Performance

• Profile with DevTools before optimizing
• Target <16ms frame time for 60fps
• Use RepaintBoundary for complex animations
• Offload heavy work with compute()

Checklist

Widget Best Practices

• const constructors on all static widgets
• Proper Key on list items
• ConsumerWidget for state-dependent widgets
• No widget building inside build() method
• Extract reusable widgets to separate files

State Management

• Immutable state objects
• select() for granular rebuilds
• Proper provider scoping
• Dispose controllers and subscriptions
• Handle loading/error states

Navigation

• GoRouter with typed routes
• Auth guards via redirect
• Deep linking support
• State preservation across routes

Performance

• Profile mode testing (flutter run --profile)
• <16ms frame rendering time
• No unnecessary rebuilds (DevTools check)
• Images cached and resized
• Heavy computation in isolates

Testing

• Widget tests for UI components
• Unit tests for business logic
• Integration tests for user flows
• Bloc tests with blocTest()

References

Topic	Reference
Widget patterns, const optimization, responsive layout	Widget Patterns
Riverpod providers, notifiers, async state	Riverpod State Management
Bloc, Cubit, event-driven state	Bloc State Management
GoRouter setup, routes, deep linking	GoRouter Navigation
Feature-based structure, dependencies	Project Structure
Profiling, const optimization, DevTools	Performance Optimization
Widget tests, integration tests, mocking	Testing Strategies
iOS/Android/Web specific implementations	Platform Integration
Implicit/explicit animations, Hero, transitions	Animations
Dio, interceptors, error handling, caching	Networking
Form validation, FormField, input formatters	Forms
i18n, flutter_localizations, intl	Localization

---

Flutter, Dart, Material Design, and Cupertino are trademarks of Google LLC and Apple Inc. respectively. Riverpod, Bloc, and GoRouter are open-source packages by their respective maintainers.