@maestro-ai/mcp-server 1.0.0 → 1.0.1

package/dist/content/content/design-system/indexes/colors-index.md

@@ -1,156 +0,0 @@
-# Índice de Paletas de Cores
-
-Navegue por categoria ou busque no CSV completo: [`../data/colors.csv`](../data/colors.csv)
-
----
-
-## 🔍 Busca Rápida
-
-**CSV Completo:** 96 paletas disponíveis
-
-**Como buscar:**
-1. Identifique o tipo de produto (SaaS, E-commerce, Fintech, etc)
-2. Procure a categoria abaixo
-3. Veja as paletas sugeridas com cores primárias
-4. Consulte linha no CSV para detalhes completos
-
----
-
-## Por Tipo de Produto
-
-### 💼 SaaS & Produtividade
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 1 | SaaS (General) | #2563EB | #3B82F6 | #F97316 | saas, general |
-| 2 | Micro SaaS | #2563EB | #3B82F6 | #F97316 | micro, saas |
-| 17 | Productivity Tool | #3B82F6 | #60A5FA | #F97316 | productivity, tool |
-| 18 | Design System/Component Library | #3B82F6 | #60A5FA | #F97316 | design, system, component |
-| 23 | Remote Work/Collaboration Tool | #3B82F6 | #60A5FA | #F97316 | remote, work, collaboration |
-
-### 🛒 E-commerce & Marketplace
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 3 | E-commerce | #3B82F6 | #60A5FA | #F97316 | commerce |
-| 4 | E-commerce Luxury | #1C1917 | #44403C | #CA8A04 | commerce, luxury |
-| 28 | Subscription Box Service | #3B82F6 | #60A5FA | #F97316 | subscription, box |
-| 50 | Marketplace (P2P) | #3B82F6 | #60A5FA | #F97316 | marketplace, p2p |
-
-### 💰 Fintech & Finance
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 7 | Financial Dashboard | #3B82F6 | #60A5FA | #F97316 | financial, dashboard |
-| 15 | Fintech/Crypto | #F59E0B | #FBBF24 | #8B5CF6 | fintech, crypto |
-| 20 | NFT/Web3 Platform | #3B82F6 | #60A5FA | #F97316 | nft, web3, platform |
-| 44 | Banking/Traditional Finance | #0F766E | #14B8A6 | #0369A1 | banking, traditional |
-| 43 | Insurance Platform | #3B82F6 | #60A5FA | #F97316 | insurance, platform |
-
-### 🏥 Healthcare & Wellness
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 9 | Healthcare App | #0891B2 | #22D3EE | #059669 | healthcare, app |
-| 24 | Mental Health App | #3B82F6 | #60A5FA | #F97316 | mental, health |
-| 34 | Beauty/Spa/Wellness Service | #10B981 | #34D399 | #8B5CF6 | beauty, spa, wellness |
-| 37 | Fitness/Gym App | #DC2626 | #F87171 | #16A34A | fitness, gym |
-| 60 | Senior Care/Elderly | #3B82F6 | #60A5FA | #F97316 | senior, care, elderly |
-
-### 🎓 Education & Learning
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 10 | Educational App | #4F46E5 | #818CF8 | #F97316 | educational, app |
-| 45 | Online Course/E-learning | #0D9488 | #2DD4BF | #EA580C | online, course, learning |
-| 84 | Language Learning App | #0D9488 | #2DD4BF | #EA580C | language, learning |
-| 85 | Coding Bootcamp | #3B82F6 | #60A5FA | #F97316 | coding, bootcamp |
-
-### 🎨 Creative & Entertainment
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 11 | Creative Agency | #EC4899 | #F472B6 | #06B6D4 | creative, agency |
-| 12 | Portfolio/Personal | #18181B | #3F3F46 | #2563EB | portfolio, personal |
-| 13 | Gaming | #7C3AED | #A78BFA | #F43F5E | gaming |
-| 29 | Podcast Platform | #3B82F6 | #60A5FA | #F97316 | podcast, platform |
-| 47 | Music Streaming | #3B82F6 | #60A5FA | #F97316 | music, streaming |
-
-### 🏪 Services & Local Business
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 5 | Service Landing Page | #3B82F6 | #60A5FA | #F97316 | service, landing |
-| 6 | B2B Service | #0F172A | #334155 | #0369A1 | b2b, service |
-| 36 | Restaurant/Food Service | #DC2626 | #F87171 | #CA8A04 | restaurant, food |
-| 38 | Real Estate/Property | #0F766E | #14B8A6 | #0369A1 | real, estate |
-| 40 | Hotel/Hospitality | #1E3A8A | #3B82F6 | #CA8A04 | hotel, hospitality |
-
-### 🔐 Tech & Security
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 19 | AI/Chatbot Platform | #7C3AED | #A78BFA | #06B6D4 | chatbot, platform |
-| 86 | Cybersecurity Platform | #00FF41 | #0D0D0D | #00FF41 | cybersecurity, hacker |
-| 87 | Developer Tool / IDE | #3B82F6 | #1E293B | #2563EB | developer, tool, ide, code |
-
-### 🚀 Innovation & Future
-
-| # | Nome | Primary | Secondary | CTA | Keywords |
-|---|------|---------|-----------|-----|----------|
-| 88 | Biotech / Life Sciences | #0EA5E9 | #0284C7 | #10B981 | biotech, science |
-| 89 | Space Tech / Aerospace | #FFFFFF | #94A3B8 | #3B82F6 | space, aerospace |
-| 91 | Quantum Computing | #00FFFF | #7B61FF | #FF00FF | quantum, qubit |
-| 95 | Spatial / Vision OS | #FFFFFF | #E5E5E5 | #007AFF | spatial, glass, vision |
-| 96 | Climate Tech | #2E8B57 | #87CEEB | #FFD700 | climate, green, energy |
-
----
-
-## 📖 Como Usar
-
-### Para ler detalhes completos:
-
-1. **Via Índice:** Encontre número da paleta acima
-2. **Abra CSV:** `content/design-system/data/colors.csv`
-3. **Vá para linha:** Linha = Número + 1 (header na linha 1)
-4. **Extraia campos:** Primary, Secondary, CTA, Background, Text, Border, Notes
-
-### Exemplo:
-
-```
-Projeto: SaaS de gestão de projetos
-Buscar: "SaaS (General)" → # 1
-Abrir: colors.csv linha 2
-Resultado completo:
-- Primary: #2563EB
-- Secondary: #3B82F6
-- CTA: #F97316
-- Background: #F8FAFC
-- Text: #1E293B
-- Border: #E2E8F0
-- Notes: Trust blue + accent contrast
-```
-
----
-
-## ⚠️ Validação Obrigatória
-
-**Purple Ban:** Verificar se paleta NÃO usa roxo como cor principal (regra MCP UX Design)
-
-Cores a evitar:
-- Roxo (#6B21A8, #7C3AED, #8B5CF6, #A78BFA)
-- Violeta
-- Magenta (#EC4899, #F472B6)
-
-**Exceções no database:**
-- Linha 19: AI/Chatbot Platform (#7C3AED) ⚠️
-- Linha 41: Wedding/Event Planning (#7C3AED) ⚠️
-- Linha 76: Event Management (#7C3AED) ⚠️
-- Linha 78: Membership/Community (#7C3AED) ⚠️
-
-→ Se encontrar roxo, sugerir alternativa ao usuário
-
----
-
-**Total de paletas:** 96  
-**Última atualização:** 2026-01-23

package/dist/content/content/design-system/indexes/quick-search.md

@@ -1,111 +0,0 @@
-# Guia Rápido de Busca no Design System
-
-Referência rápida para buscar paletas, fontes e estilos.
-
----
-
-## 🎯 Busca por Keywords
-
-### Buscar Paleta de Cores
-
-**Por tipo de produto:**
-```
-SaaS → Linhas 1-2, 17-18, 23
-E-commerce → Linhas 3-4, 28, 50
-Fintech → Linhas 7, 15, 20, 43-44
-Healthcare → Linhas 9, 24, 34, 37, 60-64
-Education → Linhas 10, 45, 84-85
-```
-
-**Por mood/estilo:**
-```
-Professional/Corporate → Linhas 6, 14, 42-43, 72-73
-Creative/Artistic → Linhas  11-12, 39, 75
-Dark/Tech → Linhas 15, 86-87, 89, 91
-Elegant/Luxury → Linhas 4, 35, 38, 40-41
-Playful/Fun → Linhas 13, 27, 30, 59
-```
-
-### Buscar Par de Fontes
-
-**Por mood:**
-```
-Elegant → STT 1, 12, 30, 50
-Modern → STT 2, 3, 11, 13
-Professional → STT 2, 16, 31
-Playful → STT 6, 19, 45
-Minimal → STT 5, 47, 48
-```
-
-**Por uso:**
-```
-Luxury brands → STT 1, 12, 32, 50
-SaaS/Tech → STT 2, 3, 13, 31
-Editorial/Blog → STT 4, 14, 35
-Developer tools → STT 9, 42
-```
-
-### Buscar Estilo UI
-
-**Por categoria:**
-```
-Minimalism → STT 1, 5, 47, 50
-Modern → STT 2, 11, 20, 43
-3D/Immersive → STT 6, 15
-Dark Mode → STT 8, 41-42
-Landing Page → STT 21-28
-Dashboard/BI → STT 29-38
-```
-
----
-
-## 📊 Workflow Rápido
-
-### Cenário 1: Projeto SaaS Moderno
-
-```markdown
-1. Cores: colors-index.md → "SaaS General" (#2563EB)
-2. Fontes: typography-index.md → "Modern Professional" (Poppins + Open Sans)
-3. Estilo: styles-index.md → "Minimalism & Swiss Style"
-4. Resultado: Design system completo em < 5min
-```
-
-### Cenário 2: E-commerce Luxury
-
-```markdown
-1. Cores: colors-index.md → "E-commerce Luxury" (#1C1917 black + gold)
-2. Fontes: typography-index.md → "Luxury Serif" (Cormorant + Montserrat)
-3. Estilo: styles-index.md → "Luxury Minimalist"
-4. Guidelines: UX → Evitar distrações, foco em produto
-```
-
-### Cenário 3: Healthcare App
-
-```markdown
-1. Cores: colors-index.md → "Healthcare App" (#0891B2 calm blue)
-2. Fontes: typography-index.md → "Medical Clean" (Figtree + Noto Sans)
-3. Estilo: styles-index.md → "Accessible & Ethical" (WCAG AAA)
-4. Validação: Acessibilidade obrigatória
-```
-
----
-
-## 🔗 Links Rápidos
-
-- **[README Principal](../README.md)** - Visão geral
-- **[Cores Completo](colors-index.md)** - 96 paletas
-- **[Tipografia](typography-index.md)** - 57 pares
-- **[Estilos](styles-index.md)** - 58 estilos
-
----
-
-## ⚡ Dicas de Eficiência
-
-1. **Comece pelo tipo de produto** (SaaS, E-commerce, etc)
-2. **Refine por mood** (Elegant, Modern, Playful)
-3. **Valide Purple Ban** (sem roxo)
-4. **Confirme com usuário** (database é sugestão)
-
----
-
-**Atualizado:** 2026-01-23

package/dist/content/content/design-system/indexes/stacks-index.md

@@ -1,341 +0,0 @@
-# Índice de Guidelines por Stack
-
-Navegue por framework/stack ou busque no CSV completo.
-
----
-
-## 🌐 Web Frameworks & Libraries
-
-### HTML + Tailwind (57 guidelines)
-
-**Arquivo:** [`../stacks/html-tailwind.csv`](../stacks/html-tailwind.csv)
-
-**Categorias Principais:**
-- Animation (5) - `animate-*`, transitions, durations
-- Z-Index (3) - Stacking context, modals, backgrounds
-- Layout (4) - Container, padding, grid gaps, flexbox
-- Images (4) - Aspect ratio, object-fit, lazy loading, responsive
-- Typography (4) - Prose plugin, line height, font scale, truncation
-- Colors (4) - Opacity, dark mode, semantic naming
-- Spacing (3) - Spacing scale, negative margins, space-between
-- Forms (4) - Focus states, sizing, disabled states
-- Responsive (3) - Mobile-first, breakpoints, visibility
-- Buttons (4) - Sizing, touch targets, loading, icons
-- Cards (3) - Structure, hover states, spacing
-- Accessibility (3) - Screen readers, focus-visible, reduced-motion
-- Performance (3) - Content paths, JIT mode, @apply usage
-- Plugins (2) - Official plugins, custom utilities
-
-**Tailwind v4 Specific:**
-- ⭐ Use `bg-linear-to-*` for gradients (not `bg-gradient-to-*`)
-- ⭐ Use `size-*` for square dimensions (not `h-* w-*`)
-- ⭐ Use `shrink-0` shorthand (not `flex-shrink-0`)
-- ⭐ Use theme colors directly: `bg-primary` (not `bg-[var(--color-primary)]`)
-
-**High Severity:** 9 regras críticas
-
----
-
-### React (55 guidelines)
-
-**Arquivo:** [`../stacks/react.csv`](../stacks/react.csv)
-
-**Categorias Principais:**
-- State (5) - useState, useReducer, lift state, lazy init, avoid unnecessary
-- Effects (4) - Cleanup, dependencies, avoid unnecessary, refs
-- Rendering (5) - Keys, useMemo, useCallback, memo, avoid inline objects
-- Components (4) - Small/focused, composition, colocate, fragments
-- Props (4) - Destructure, defaults, avoid drilling, TypeScript
-- Events (3) - Synthetic events, binding, passing handlers
-- Forms (3) - Controlled components, submission, debouncing
-- Hooks (3) - Rules of hooks, custom hooks, naming
-- Context (3) - Global data, split contexts, memoize values
-- Performance (4) - Profiler, lazy load, virtualize, batching
-- Error Handling (2) - Error boundaries, async errors
-- Testing (2) - Test behavior, testing-library queries
-- Accessibility (4) - Semantic HTML, focus, ARIA, labels
-- TypeScript (4) - Props typing, state typing, events, generics
-- Patterns (3) - Container/Presentational, render props, compound
-
-**High Severity:** 16 regras críticas
-- Avoid unnecessary state
-- Clean up effects  
-- Specify dependencies correctly
-- Use keys properly (stable IDs)
-- Rules of hooks
-- Memoize context values
-- Virtualize long lists (100+ items)
-- Error boundaries
-- Semantic HTML
-
----
-
-### Next.js (54 guidelines)
-
-**Arquivo:** [`../stacks/nextjs.csv`](../stacks/nextjs.csv)
-
-**Categorias Principais:**
-- Routing (6) - App Router, file-based, route groups, loading, errors
-- Rendering (5) - Server Components, Client Components, streaming
-- Data Fetching (5) - Fetch in Server Components, caching, Server Actions
-- Images (5) - next/image, dimensions, fill, remote domains, priority
-- Fonts (3) - next/font, layout application, variable fonts
-- Metadata (3) - generateMetadata, OpenGraph, metadata API
-- API (4) - Route Handlers, Response objects, HTTP methods, validation
-- Middleware (3) - Auth, path matching, edge-compatible
-- Environment (3) - NEXT_PUBLIC prefix, validation, .env.local
-- Performance (4) - Bundle analyzer, dynamic imports, layout shifts
-- Link (3) - next/link, prefetch, scroll
-- Config (3) - next.config.js, strict mode, redirects
-- Deployment (2) - Vercel, self-hosting
-- Security (3) - Sanitize input, CSP headers, Server Action validation
-
-**⚠️ CRITICAL (Next.js 15):**
-```csv
-Configure caching explicitly
-fetch() is UNCACHED by default in v15!
-Do: fetch(url, { cache: 'force-cache' })
-Don't: fetch(url) // Uncached!
-Severity: High
-```
-
-**High Severity:** ~15 regras críticas
-
----
-
-### Vue (50 guidelines)
-
-**Arquivo:** [`../stacks/vue.csv`](../stacks/vue.csv)
-
-**Uso:** Aplicações Vue 3 com Composition API
-
----
-
-### Svelte (50 guidelines)
-
-**Arquivo:** [`../stacks/svelte.csv`](../stacks/svelte.csv)
-
-**Uso:** Aplicações Svelte 5 com Runes
-
----
-
-### shadcn/ui (65 guidelines)
-
-**Arquivo:** [`../stacks/shadcn.csv`](../stacks/shadcn.csv)
-
-**Uso:** Projects usando shadcn/ui components
-
----
-
-### Nuxt.js (70 guidelines)
-
-**Arquivo:** [`../stacks/nuxtjs.csv`](../stacks/nuxtjs.csv)
-
-**Uso:** Aplicações Nuxt 3
-
----
-
-### Nuxt UI (60 guidelines)
-
-**Arquivo:** [`../stacks/nuxt-ui.csv`](../stacks/nuxt-ui.csv)
-
-**Uso:** Projects usando Nuxt UI
-
----
-
-## 📱 Mobile Frameworks
-
-### React Native (45 guidelines)
-
-**Arquivo:** [`../stacks/react-native.csv`](../stacks/react-native.csv)
-
-**Uso:** Apps mobile React Native (iOS + Android)
-
----
-
-### SwiftUI (50 guidelines)
-
-**Arquivo:** [`../stacks/swiftui.csv`](../stacks/swiftui.csv)
-
-**Uso:** Apps iOS/macOS nativas
-
----
-
-### Flutter (47 guidelines)
-
-**Arquivo:** [`../stacks/flutter.csv`](../stacks/flutter.csv)
-
-**Uso:** Apps Flutter (iOS + Android)
-
----
-
-### Jetpack Compose (40 guidelines)
-
-**Arquivo:** [`../stacks/jetpack-compose.csv`](../stacks/jetpack-compose.csv)
-
-**Uso:** Apps Android nativas modernas
-
----
-
-## 🔍 Como Usar
-
-### Para Especialistas MCP
-
-**1. Identificar stack do projeto:**
-```
-Estado.json → stack_framework: "react" | "nextjs" | "vue" | etc
-```
-
-**2. Abrir CSV correspondente:**
-```
-content/design-system/stacks/react.csv
-content/design-system/stacks/nextjs.csv
-```
-
-**3. Buscar por categoria:**
-```csv
-# Implementando hooks?
-Category: "Hooks" (3 regras)
-
-# Otimizando performance?
-Category: "Performance" (4 regras)
-
-# TypeScript?
-Category: "TypeScript" (4 regras)
-```
-
-**4. Filtrar por severidade:**
-```csv
-# High Severity = Crítico (aplicar primeiro)
-# Medium = Importante  
-# Low = Boas práticas
-```
-
-**5. Consultar exemplos:**
-```csv
-Code Good: [exemplo correto]
-Code Bad: [anti-pattern]
-```
-
----
-
-## 📊 Estatísticas por Severidade
-
-### Web Stacks
-
-| Stack | High | Medium | Low | Total |
-|-------|------|--------|-----|-------|
-| Tailwind | 9 | 28 | 20 | 57 |
-| React | 16 | ~30 | ~9 | 55 |
-| Next.js | ~15 | ~30 | ~9 | 54 |
-| shadcn | ~20 | ~35 | ~10 | 65 |
-| Nuxt.js | ~25 | ~35 | ~10 | 70 |
-
-### Mobile Stacks
-
-| Stack | High | Medium | Low | Total |
-|-------|------|--------|-----|-------|
-| React Native | ~15 | ~20 | ~10 | 45 |
-| SwiftUI | ~15 | ~25 | ~10 | 50 |
-| Flutter | ~15 | ~22 | ~10 | 47 |
-| Jetpack Compose | ~12 | ~20 | ~8 | 40 |
-
----
-
-## ⚡ Workflows Rápidos
-
-### Cenário 1: Dashboard React + Next.js
-
-```
-1. nextjs.csv:
-   ✅ Use Server Components by default (High)
-   ✅ Configure caching explicitly (High - v15!)
-   ✅ Use next/image (High)
-
-2. react.csv:
-   ✅ Avoid unnecessary state (High)
-   ✅ Use keys properly (High)
-   ✅ Error boundaries (High)
-
-3. tailwind.csv:
-   ✅ Mobile-first approach (Medium)
-   ✅ Focus states (High)
-   ✅ Dark mode (Medium)
-```
-
-### Cenário 2: App Mobile React Native
-
-```
-1. react-native.csv:
-   ✅ FlatList for long lists (High)
-   ✅ TouchableOpacity for interactions (Medium)
-   ✅ Platform-specific code (Medium)
-
-2. react.csv:
-   ✅ Rules of hooks (High)
-   ✅ Memoize callbacks (Medium)
-   ✅ Error boundaries (High)
-```
-
-### Cenário 3: Landing Page com Nuxt UI
-
-```
-1. nuxt-ui.csv:
-   ✅ Use Nuxt UI components (Medium)
-   ✅ Theme configuration (Medium)
-   ✅ Icons library (Low)
-
-2. nuxtjs.csv:
-   ✅ Auto-imports (Medium)
-   ✅ Server routes (High)
-   ✅ SEO metadata (High)
-```
-
----
-
-## 🎯 Integração com Especialistas
-
-### Especialista em Desenvolvimento Frontend
-
-Durante Fase 11-12 (Implementação):
-1. Consultar `stacks-index.md` para identificar stack
-2. Abrir CSV correspondente
-3. Aplicar regras High Severity primeiro
-4. Validar código contra Code Bad (anti-patterns)
-5. Consultar Docs URL para aprofundamento
-
-### Especialista em Desenvolvimento Mobile
-
-Durante Fase 11-12 (Implementação Mobile):
-1. Identificar plataforma (iOS/Android/Cross-platform)
-2. Consultar CSV correspondente:
-   - iOS → swiftui.csv
-   - Android → jetpack-compose.csv
-   - Cross → react-native.csv ou flutter.csv
-3. Aplicar best practices específicas da plataforma
-
----
-
-## 📋 Estrutura dos CSVs
-
-```csv
-No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
-```
-
-**Campos:**
-- **No** - Número da guideline
-- **Category** - Categoria (State, Effects, etc)
-- **Guideline** - Título resumido
-- **Description** - Descrição completa
-- **Do** - Boas práticas (o que fazer)
-- **Don't** - Anti-patterns (o que NÃO fazer)
-- **Code Good** - Exemplo de código correto
-- **Code Bad** - Exemplo de código incorreto
-- **Severity** - High, Medium, Low
-- **Docs URL** - Link para documentação oficial
-
----
-
-**Total de Stacks:** 12  
-**Total de Guidelines:** ~600  
-**Última atualização:** 2026-01-23

package/dist/content/content/design-system/stacks/flutter.csv

@@ -1,53 +0,0 @@
-No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
-1,Widgets,Use StatelessWidget when possible,Immutable widgets are simpler,StatelessWidget for static UI,StatefulWidget for everything,class MyWidget extends StatelessWidget,class MyWidget extends StatefulWidget (static),Medium,https://api.flutter.dev/flutter/widgets/StatelessWidget-class.html
-2,Widgets,Keep widgets small,Single responsibility principle,Extract widgets into smaller pieces,Large build methods,Column(children: [Header() Content()]),500+ line build method,Medium,
-3,Widgets,Use const constructors,Compile-time constants for performance,const MyWidget() when possible,Non-const for static widgets,const Text('Hello'),Text('Hello') for literals,High,https://dart.dev/guides/language/language-tour#constant-constructors
-4,Widgets,Prefer composition over inheritance,Combine widgets using children,Compose widgets,Extend widget classes,Container(child: MyContent()),class MyContainer extends Container,Medium,
-5,State,Use setState correctly,Minimal state in StatefulWidget,setState for UI state changes,setState for business logic,setState(() { _counter++; }),Complex logic in setState,Medium,https://api.flutter.dev/flutter/widgets/State/setState.html
-6,State,Avoid setState in build,Never call setState during build,setState in callbacks only,setState in build method,onPressed: () => setState(() {}),build() { setState(); },High,
-7,State,Use state management for complex apps,Provider Riverpod BLoC,State management for shared state,setState for global state,Provider.of<MyState>(context),Global setState calls,Medium,
-8,State,Prefer Riverpod or Provider,Recommended state solutions,Riverpod for new projects,InheritedWidget manually,ref.watch(myProvider),Custom InheritedWidget,Medium,https://riverpod.dev/
-9,State,Dispose resources,Clean up controllers and subscriptions,dispose() for cleanup,Memory leaks from subscriptions,@override void dispose() { controller.dispose(); },No dispose implementation,High,
-10,Layout,Use Column and Row,Basic layout widgets,Column Row for linear layouts,Stack for simple layouts,"Column(children: [Text(), Button()])",Stack for vertical list,Medium,https://api.flutter.dev/flutter/widgets/Column-class.html
-11,Layout,Use Expanded and Flexible,Control flex behavior,Expanded to fill space,Fixed sizes in flex containers,Expanded(child: Container()),Container(width: 200) in Row,Medium,
-12,Layout,Use SizedBox for spacing,Consistent spacing,SizedBox for gaps,Container for spacing only,SizedBox(height: 16),Container(height: 16),Low,
-13,Layout,Use LayoutBuilder for responsive,Respond to constraints,LayoutBuilder for adaptive layouts,Fixed sizes for responsive,LayoutBuilder(builder: (context constraints) {}),Container(width: 375),Medium,https://api.flutter.dev/flutter/widgets/LayoutBuilder-class.html
-14,Layout,Avoid deep nesting,Keep widget tree shallow,Extract deeply nested widgets,10+ levels of nesting,Extract widget to method or class,Column(Row(Column(Row(...)))),Medium,
-15,Lists,Use ListView.builder,Lazy list building,ListView.builder for long lists,ListView with children for large lists,"ListView.builder(itemCount: 100, itemBuilder: ...)",ListView(children: items.map(...).toList()),High,https://api.flutter.dev/flutter/widgets/ListView-class.html
-16,Lists,Provide itemExtent when known,Skip measurement,itemExtent for fixed height items,No itemExtent for uniform lists,ListView.builder(itemExtent: 50),ListView.builder without itemExtent,Medium,
-17,Lists,Use keys for stateful items,Preserve widget state,Key for stateful list items,No key for dynamic lists,ListTile(key: ValueKey(item.id)),ListTile without key,High,
-18,Lists,Use SliverList for custom scroll,Custom scroll effects,CustomScrollView with Slivers,Nested ListViews,CustomScrollView(slivers: [SliverList()]),ListView inside ListView,Medium,https://api.flutter.dev/flutter/widgets/SliverList-class.html
-19,Navigation,Use Navigator 2.0 or GoRouter,Declarative routing,go_router for navigation,Navigator.push for complex apps,GoRouter(routes: [...]),Navigator.push everywhere,Medium,https://pub.dev/packages/go_router
-20,Navigation,Use named routes,Organized navigation,Named routes for clarity,Anonymous routes,Navigator.pushNamed(context '/home'),Navigator.push(context MaterialPageRoute()),Low,
-21,Navigation,Handle back button (PopScope),Android back behavior and predictive back (Android 14+),Use PopScope widget (WillPopScope is deprecated),Use WillPopScope,"PopScope(canPop: false, onPopInvoked: (didPop) => ...)",WillPopScope(onWillPop: ...),High,https://api.flutter.dev/flutter/widgets/PopScope-class.html
-22,Navigation,Pass typed arguments,Type-safe route arguments,Typed route arguments,Dynamic arguments,MyRoute(id: '123'),arguments: {'id': '123'},Medium,
-23,Async,Use FutureBuilder,Async UI building,FutureBuilder for async data,setState for async,FutureBuilder(future: fetchData()),fetchData().then((d) => setState()),Medium,https://api.flutter.dev/flutter/widgets/FutureBuilder-class.html
-24,Async,Use StreamBuilder,Stream UI building,StreamBuilder for streams,Manual stream subscription,StreamBuilder(stream: myStream),stream.listen in initState,Medium,https://api.flutter.dev/flutter/widgets/StreamBuilder-class.html
-25,Async,Handle loading and error states,Complete async UI states,ConnectionState checks,Only success state,if (snapshot.connectionState == ConnectionState.waiting),No loading indicator,High,
-26,Async,Cancel subscriptions,Clean up stream subscriptions,Cancel in dispose,Memory leaks,subscription.cancel() in dispose,No subscription cleanup,High,
-27,Theming,Use ThemeData,Consistent theming,ThemeData for app theme,Hardcoded colors,Theme.of(context).primaryColor,Color(0xFF123456) everywhere,Medium,https://api.flutter.dev/flutter/material/ThemeData-class.html
-28,Theming,Use ColorScheme,Material 3 color system,ColorScheme for colors,Individual color properties,colorScheme: ColorScheme.fromSeed(),primaryColor: Colors.blue,Medium,
-29,Theming,Access theme via context,Dynamic theme access,Theme.of(context),Static theme reference,Theme.of(context).textTheme.bodyLarge,TextStyle(fontSize: 16),Medium,
-30,Theming,Support dark mode,Respect system theme,darkTheme in MaterialApp,Light theme only,"MaterialApp(theme: light, darkTheme: dark)",MaterialApp(theme: light),Medium,
-31,Animation,Use implicit animations,Simple animations,AnimatedContainer AnimatedOpacity,Explicit for simple transitions,AnimatedContainer(duration: Duration()),AnimationController for fade,Low,https://api.flutter.dev/flutter/widgets/AnimatedContainer-class.html
-32,Animation,Use AnimationController for complex,Fine-grained control,AnimationController with Ticker,Implicit for complex sequences,AnimationController(vsync: this),AnimatedContainer for staggered,Medium,
-33,Animation,Dispose AnimationControllers,Clean up animation resources,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
-34,Animation,Use Hero for transitions,Shared element transitions,Hero for navigation animations,Manual shared element,Hero(tag: 'image' child: Image()),Custom shared element animation,Low,https://api.flutter.dev/flutter/widgets/Hero-class.html
-35,Forms,Use Form widget,Form validation,Form with GlobalKey,Individual validation,Form(key: _formKey child: ...),TextField without Form,Medium,https://api.flutter.dev/flutter/widgets/Form-class.html
-36,Forms,Use TextEditingController,Control text input,Controller for text fields,onChanged for all text,final controller = TextEditingController(),onChanged: (v) => setState(),Medium,
-37,Forms,Validate on submit,Form validation flow,_formKey.currentState!.validate(),Skip validation,if (_formKey.currentState!.validate()),Submit without validation,High,
-38,Forms,Dispose controllers,Clean up text controllers,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
-39,Performance,Use const widgets,Reduce rebuilds,const for static widgets,No const for literals,const Icon(Icons.add),Icon(Icons.add),High,
-40,Performance,Avoid rebuilding entire tree,Minimal rebuild scope,Isolate changing widgets,setState on parent,Consumer only around changing widget,setState on root widget,High,
-41,Performance,Use RepaintBoundary,Isolate repaints,RepaintBoundary for animations,Full screen repaints,RepaintBoundary(child: AnimatedWidget()),Animation without boundary,Medium,https://api.flutter.dev/flutter/widgets/RepaintBoundary-class.html
-42,Performance,Profile with DevTools,Measure before optimizing,Flutter DevTools profiling,Guess at performance,DevTools performance tab,Optimize without measuring,Medium,https://docs.flutter.dev/tools/devtools
-43,Accessibility,Use Semantics widget,Screen reader support,Semantics for accessibility,Missing accessibility info,Semantics(label: 'Submit button'),GestureDetector without semantics,High,https://api.flutter.dev/flutter/widgets/Semantics-class.html
-44,Accessibility,Support large fonts,MediaQuery text scaling,MediaQuery.textScaleFactor,Fixed font sizes,style: Theme.of(context).textTheme,TextStyle(fontSize: 14),High,
-45,Accessibility,Test with screen readers,TalkBack and VoiceOver,Test accessibility regularly,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
-46,Testing,Use widget tests,Test widget behavior,WidgetTester for UI tests,Unit tests only,testWidgets('...' (tester) async {}),Only test() for UI,Medium,https://docs.flutter.dev/testing
-47,Testing,Use integration tests,Full app testing,integration_test package,Manual testing only,IntegrationTestWidgetsFlutterBinding,Manual E2E testing,Medium,
-48,Testing,Mock dependencies,Isolate tests,Mockito or mocktail,Real dependencies in tests,when(mock.method()).thenReturn(),Real API calls in tests,Medium,
-49,Platform,Use Platform checks,Platform-specific code,Platform.isIOS Platform.isAndroid,Same code for all platforms,if (Platform.isIOS) {},Hardcoded iOS behavior,Medium,
-50,Platform,Use kIsWeb for web,Web platform detection,kIsWeb for web checks,Platform for web,if (kIsWeb) {},Platform.isWeb (doesn't exist),Medium,
-51,Packages,Use pub.dev packages,Community packages,Popular maintained packages,Custom implementations,cached_network_image,Custom image cache,Medium,https://pub.dev/
-52,Packages,Check package quality,Quality before adding,Pub points and popularity,Any package without review,100+ pub points,Unmaintained packages,Medium,