{
  "markdown": "# PRD-to-PRPROMPTS Generator\n\n<div align=\"center\">\n\n[![npm version](https://img.shields.io/npm/v/prprompts-flutter-generator.svg)](https://www.npmjs.com/package/prprompts-flutter-generator)\n[![npm downloads](https://img.shields.io/npm/dt/prprompts-flutter-generator.svg)](https://www.npmjs.com/package/prprompts-flutter-generator)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/badge/Version-5.1.3-brightgreen)](CHANGELOG.md)\n[![Status](https://img.shields.io/badge/Status-Production-brightgreen)](CHANGELOG.md#513)\n[![PRD Methods](https://img.shields.io/badge/PRD%20Methods-6-brightgreen)](#creating-your-prd)\n[![PRPROMPTS](https://img.shields.io/badge/PRPROMPTS-32%20Files-orange)](#what-gets-generated)\n[![Commands](https://img.shields.io/badge/Commands-23%20Total-blue)](#available-commands)\n[![Security](https://img.shields.io/badge/Security-HIPAA%20%7C%20PCI--DSS%20%7C%20GDPR-red)](#security--compliance)\n[![New](https://img.shields.io/badge/NEW-v5.1%20Official%20Extensions-purple)](#-new-in-v510-official-ai-extension-support)\n[![Speed](https://img.shields.io/badge/Speed-40--60x%20Faster-green)](#v40-full-automation-new)\n\n[![Claude Code](https://img.shields.io/badge/Claude_Code-Extension-blue)](CLAUDE.md)\n[![Qwen Code](https://img.shields.io/badge/Qwen_Code-Extension-orange)](QWEN.md)\n[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-Extension-green)](GEMINI.md)\n[![Flutter](https://img.shields.io/badge/Flutter-3.24+-blue)](https://flutter.dev)\n\n[![Windows](https://img.shields.io/badge/Windows-Supported-0078D6?logo=windows)](docs/installation/WINDOWS-QUICKSTART.md)\n[![macOS](https://img.shields.io/badge/macOS-Supported-000000?logo=apple)](docs/installation/MACOS-QUICKSTART.md)\n[![Linux](https://img.shields.io/badge/Linux-Supported-FCC624?logo=linux&logoColor=black)](#system-requirements)\n[![Cross-Platform](https://img.shields.io/badge/Cross--Platform-PowerShell%20%7C%20CMD%20%7C%20Bash%20%7C%20WSL-blue)](#platform-specific-notes)\n\n</div>\n\n---\n\n## 🎉 NEW IN v5.1: Official AI Extension Support\n\n**Production Ready!** v5.1 delivers official extension support for all three AI platforms with native integration, hooks automation, and TOML command format.\n\n### ✨ v5.1.3 Latest Improvements\n\n- ✅ **Perfect Multi-AI Integration** - All 23 commands synchronized across Claude, Qwen, and Gemini\n- ✅ **Automated Version Sync** - `npm run sync-versions` keeps all manifests aligned\n- ✅ **Universal Installer** - One-command setup for all AIs with progress bars\n- ✅ **Integration Testing** - 32 comprehensive tests ensure quality\n- ✅ **Enhanced Manifests** - Professional metadata, benchmarks, and capabilities\n\n### ✨ What's New\n\n**1. Claude Code Official Plugin**\n- ✅ Official plugin manifest (`.claude-plugin/plugin.json`)\n- ✅ Hooks automation system (4 event types)\n- ✅ Auto-formatting with `dart format` after every edit\n- ✅ Quality gates prompt (analyze, test, commit)\n- ✅ Flutter SDK verification at session start\n- ✅ Activity logging for analytics\n\n**2. Gemini CLI TOML Commands**\n- ✅ All 23 commands in native TOML format\n- ✅ Context file (`GEMINI.md`) for AI understanding\n- ✅ Enhanced extension manifest with settings\n- ✅ Inline command arguments support\n\n**3. Qwen Code MCP Configuration**\n- ✅ Optional MCP server settings (`settings.json`)\n- ✅ OAuth support configuration\n- ✅ Feature toggles for automation\n- ✅ Flutter/Dart SDK path settings\n\n### 🚀 Installation\n\n```bash\n# Install from npm (auto-detects all AIs)\nnpm install -g prprompts-flutter-generator\n\n# What gets installed:\n# - Claude Code → Plugin + Hooks + 23 Commands\n# - Gemini CLI → TOML Commands + Context + Extension\n# - Qwen Code → Commands + Settings + MCP Config\n\n# Verify installation\nprprompts doctor\n```\n\n### 🎯 Benefits\n\n✅ **Native Integration** - No manual configuration needed\n✅ **Auto-Format** - Dart code formatted automatically (Claude)\n✅ **Quality Gates** - Prompted to run tests before committing\n✅ **Environment Checks** - Flutter SDK verified at startup\n✅ **Discoverable** - All commands visible in `/help`\n✅ **Official Distribution** - Install via package managers\n\n---\n\n## 🤖 AI Platform Comparison Matrix\n\nChoose the best AI assistant for your needs:\n\n<div align=\"center\">\n\n| Feature | Claude Code | Qwen Code | Gemini CLI |\n|---------|------------|-----------|------------|\n| **Version** | v5.1.2 | v5.1.2 | v5.1.2 |\n| **Commands** | ✅ 23 | ✅ 23 | ✅ 23 |\n| **Context Window** | 200K tokens | 256K-1M tokens | 1M tokens |\n| **Slash Commands** | ✅ Native (`/command`) | ✅ Native (`:command`) | ✅ Native (`:command`) |\n| **TOML Commands** | ❌ | ✅ 31 files | ✅ 31 files |\n| **Plugin Support** | ✅ Official Plugin | ✅ Extension | ✅ Extension |\n| **Hooks Automation** | ✅ 4 event types | ❌ | ❌ |\n| **Skills System** | ✅ 17 skills | ✅ 15 skills | ✅ 15 skills |\n| **Auto-formatting** | ✅ Dart format on save | ❌ | ❌ |\n| **MCP Settings** | ❌ | ✅ Full MCP config | ❌ |\n| **ReAct Agent Mode** | ❌ | ❌ | ✅ Native |\n| **Cost** | $$$ | $ (Free tier) | $$ |\n| **Best For** | Premium features, hooks | Large codebases, cost-effective | 1M context, ReAct mode |\n\n</div>\n\n### 🎯 Platform-Specific Advantages\n\n**Claude Code:**\n- ✅ Official plugin with automatic updates\n- ✅ Hooks for workflow automation (auto-format, quality checks)\n- ✅ Premium model accuracy\n- ✅ Best documentation and support\n\n**Qwen Code:**\n- ✅ Extended context (up to 1M tokens) for monorepos\n- ✅ Free tier available\n- ✅ MCP configuration for advanced settings\n- ✅ Open source and community-driven\n\n**Gemini CLI:**\n- ✅ Largest context window (1M tokens)\n- ✅ ReAct agent mode for complex reasoning\n- ✅ Native TOML command integration\n- ✅ Google ecosystem integration\n\n### 📦 Installation\n\nAll platforms support the same npm installation:\n\n```bash\n# Install PRPROMPTS (works for all AIs)\nnpm install -g prprompts-flutter-generator\n\n# NEW: Universal installer for all detected AIs\nbash install-all-extensions.sh\n\n# Or install for specific AI\nbash install-claude-extension.sh\nbash install-qwen-extension.sh\nbash install-gemini-extension.sh\n\n# Verify installation\nprprompts doctor\n\n# Commands automatically available in your AI:\n# Claude: /create-prd, /generate-all, /bootstrap\n# Qwen: :create-prd, :generate-all, :bootstrap\n# Gemini: :create-prd, :generate-all, :bootstrap\n```\n\n---\n\n## 🔄 v5.0 Feature: Complete React-to-Flutter Refactoring\n\n**Production Ready!** v5.0.0 delivers a complete, fully-tested React/React Native to Flutter conversion system with intelligent code transformation, Clean Architecture generation, and comprehensive validation.\n\n### 🚀 Quick Start - Convert in 3 Commands\n\n```bash\n# 1. Install\nnpm install -g prprompts-flutter-generator\n\n# 2. Convert your React app to Flutter\nprprompts refactor ./my-react-app ./my-flutter-app --state-mgmt bloc --ai claude\n\n# 3. Done! You get:\n# ✅ Complete Flutter project with Clean Architecture\n# ✅ All styles converted (CSS → Flutter)\n# ✅ All hooks converted (useState → state, useEffect → lifecycle)\n# ✅ All patterns converted (HOCs → mixins, React.memo → const)\n# ✅ BLoC state management with events/states\n# ✅ Comprehensive validation report\n# ✅ AI-enhanced code (optional)\n```\n\n### 🎯 Slash Commands (UPDATED in v5.0.6)\n\nRun refactoring commands directly in your AI assistant chat:\n\n```bash\n# Claude Code (use forward slash)\nclaude\n/refactoring/convert-react-to-flutter\n/refactoring/validate-flutter\n\n# Qwen Code (use colon separator)\nqwen\n/refactoring:convert-react-to-flutter\n/refactoring:validate-flutter\n\n# Gemini CLI (use colon separator)\ngemini\n/refactoring:convert-react-to-flutter\n/refactoring:validate-flutter\n\n# Or use the unified CLI from terminal\nprprompts refactor ./my-react-app ./my-flutter-app\n```\n\n**Note**: Slash commands use TOML-based configuration with inline prompts. Pre-1.0 versions (Qwen 0.1.2, Gemini 0.11.3) support commands even if they don't appear in `/help`.\n\n### 🔄 What Gets Converted\n\n<table>\n<tr>\n<th>React/React Native</th>\n<th>→</th>\n<th>Flutter</th>\n</tr>\n<tr>\n<td>\n\n```jsx\nconst Counter = () => {\n  const [count, setCount] = useState(0);\n\n  useEffect(() => {\n    console.log('Count:', count);\n    return () => cleanup();\n  }, [count]);\n\n  return (\n    <View style={styles.container}>\n      <Text style={styles.title}>\n        Count: {count}\n      </Text>\n      <TouchableOpacity\n        onPress={() => setCount(count + 1)}\n      >\n        <Text>Increment</Text>\n      </TouchableOpacity>\n    </View>\n  );\n};\n\nconst styles = StyleSheet.create({\n  container: {\n    flex: 1,\n    padding: 20,\n    backgroundColor: '#f5f5f5'\n  },\n  title: {\n    fontSize: 24,\n    fontWeight: 'bold',\n    color: '#333'\n  }\n});\n```\n\n</td>\n<td>⚡</td>\n<td>\n\n```dart\nclass Counter extends StatefulWidget {\n  @override\n  _CounterState createState() => _CounterState();\n}\n\nclass _CounterState extends State<Counter> {\n  int count = 0;\n\n  @override\n  void didUpdateWidget(Counter oldWidget) {\n    super.didUpdateWidget(oldWidget);\n    print('Count: $count');\n  }\n\n  @override\n  void dispose() {\n    cleanup();\n    super.dispose();\n  }\n\n  @override\n  Widget build(BuildContext context) {\n    return Container(\n      decoration: BoxDecoration(\n        color: Color(0xFFF5F5F5),\n      ),\n      padding: EdgeInsets.all(20),\n      child: Column(\n        children: [\n          Text(\n            'Count: $count',\n            style: TextStyle(\n              fontSize: 24,\n              fontWeight: FontWeight.bold,\n              color: Color(0xFF333333),\n            ),\n          ),\n          GestureDetector(\n            onTap: () => setState(() => count++),\n            child: Text('Increment'),\n          ),\n        ],\n      ),\n    );\n  }\n}\n```\n\n</td>\n</tr>\n</table>\n\n### ✨ Complete Feature Set\n\n<details>\n<summary><strong>🎨 Intelligent Style Conversion</strong> (780 lines, 100% tested)</summary>\n\n- **CSS → Flutter Transformation**\n  - Colors: hex/rgb/rgba → `Color(0xFFRRGGBB)`\n  - Layouts: flexbox → `Row`/`Column`/`Flex`\n  - Borders: CSS borders → `BoxDecoration.border`\n  - Shadows: box-shadow → `BoxShadow`\n  - Gradients: linear/radial → `LinearGradient`/`RadialGradient`\n  - Typography: font styles → `TextStyle`\n  - Responsive: media queries → `MediaQuery`\n\n**Example:**\n```css\n/* React CSS */\n.button {\n  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);\n  box-shadow: 0 10px 20px rgba(0,0,0,0.2);\n  border-radius: 8px;\n  padding: 16px 32px;\n}\n```\n```dart\n// Flutter Output\ndecoration: BoxDecoration(\n  gradient: LinearGradient(\n    begin: Alignment.topLeft,\n    end: Alignment.bottomRight,\n    colors: [Color(0xFF667EEA), Color(0xFF764BA2)],\n  ),\n  boxShadow: [\n    BoxShadow(\n      color: Color(0x33000000),\n      offset: Offset(0, 10),\n      blurRadius: 20,\n    ),\n  ],\n  borderRadius: BorderRadius.circular(8),\n),\npadding: EdgeInsets.symmetric(horizontal: 32, vertical: 16),\n```\n</details>\n\n<details>\n<summary><strong>🪝 Complete Hooks Conversion</strong> (780 lines, 38 tests)</summary>\n\n- **useState** → StatefulWidget state management\n- **useEffect** → Lifecycle methods (initState, dispose, didUpdateWidget)\n- **useContext** → Provider pattern integration\n- **useReducer** → BLoC pattern transformation\n- **useRef** → Controllers and GlobalKey\n- **useMemo/useCallback** → Widget caching strategies\n- **Custom hooks** → Mixins with shared logic\n\n**Example:**\n```jsx\n// React Hook\nconst useAuth = () => {\n  const [user, setUser] = useState(null);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    fetchUser().then(u => {\n      setUser(u);\n      setLoading(false);\n    });\n  }, []);\n\n  return { user, loading };\n};\n```\n```dart\n// Flutter Mixin\nmixin AuthMixin<T extends StatefulWidget> on State<T> {\n  User? user;\n  bool loading = true;\n\n  @override\n  void initState() {\n    super.initState();\n    fetchUser().then((u) {\n      if (mounted) {\n        setState(() {\n          user = u;\n          loading = false;\n        });\n      }\n    });\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>🎭 Advanced JSX Pattern Conversion</strong> (655 lines, 29 tests)</summary>\n\n- **Higher-Order Components (HOCs)** → Mixins\n- **React.memo** → const constructors (performance optimization)\n- **forwardRef** → GlobalKey pattern\n- **Render props** → Builder widgets\n- **Fragments** → Column/Row\n- **Lists** → ListView.builder with keys\n- **Conditional rendering** → Ternary operators\n- **Dynamic children** → Builder patterns\n\n**Example:**\n```jsx\n// React HOC\nconst withAuth = (Component) => {\n  return (props) => {\n    const { user } = useAuth();\n    if (!user) return <Login />;\n    return <Component {...props} user={user} />;\n  };\n};\n```\n```dart\n// Flutter Mixin\nmixin WithAuthMixin<T extends StatefulWidget> on State<T> {\n  User? user;\n\n  @override\n  Widget build(BuildContext context) {\n    if (user == null) return Login();\n    return buildAuthenticated(context);\n  }\n\n  Widget buildAuthenticated(BuildContext context);\n}\n```\n</details>\n\n<details>\n<summary><strong>🏗️ Clean Architecture Generation</strong></summary>\n\nAutomatically generates complete Clean Architecture structure:\n\n```\nlib/\n├── domain/\n│   ├── entities/\n│   ├── repositories/\n│   └── usecases/\n├── data/\n│   ├── datasources/\n│   ├── models/\n│   └── repositories/\n└── presentation/\n    ├── bloc/\n    ├── pages/\n    └── widgets/\n```\n\n- **Domain Layer**: Pure business logic (entities, use cases)\n- **Data Layer**: Repository implementations, data sources\n- **Presentation Layer**: UI components, state management\n- **Dependency Injection**: GetIt setup with proper scoping\n</details>\n\n<details>\n<summary><strong>📊 BLoC State Management</strong></summary>\n\nFull BLoC/Cubit generation with events and states:\n\n```dart\n// Auto-generated BLoC\nclass CounterBloc extends Bloc<CounterEvent, CounterState> {\n  CounterBloc() : super(CounterInitial()) {\n    on<IncrementEvent>(_onIncrement);\n    on<DecrementEvent>(_onDecrement);\n  }\n\n  void _onIncrement(IncrementEvent event, Emitter<CounterState> emit) {\n    emit(CounterUpdated(count: state.count + 1));\n  }\n}\n\n// Auto-generated Events\nabstract class CounterEvent {}\nclass IncrementEvent extends CounterEvent {}\n\n// Auto-generated States\nabstract class CounterState {\n  final int count;\n  CounterState({required this.count});\n}\n```\n</details>\n\n<details>\n<summary><strong>🤖 AI Enhancement Layer</strong></summary>\n\nOptional AI-powered code optimization (Claude/Qwen/Gemini):\n\n- **Code Quality**: Refactoring suggestions\n- **Performance**: Optimization recommendations\n- **Best Practices**: Flutter idioms and patterns\n- **Security**: Vulnerability detection\n- **Accessibility**: A11y improvements\n\n```bash\n# Enable AI enhancement\nprprompts refactor ./my-app ./flutter-app --ai claude --enhance\n```\n</details>\n\n<details>\n<summary><strong>✅ Comprehensive Validation</strong></summary>\n\n5 specialized validators with detailed reports:\n\n1. **Code Validator**: Syntax, imports, unused code\n2. **Architecture Validator**: Layer separation, dependencies\n3. **Security Validator**: Vulnerabilities, best practices\n4. **Performance Validator**: Widget rebuilds, memory leaks\n5. **Accessibility Validator**: Semantics, contrast, focus\n\nOutput: `VALIDATION_REPORT.md` with actionable recommendations\n</details>\n\n### 📊 Quality Metrics\n\n- **Test Coverage:** 623/691 passing (90%)\n- **Core Modules:** 100% coverage (hooks, JSX, styles)\n- **Performance:** <50ms per component conversion\n- **Zero Critical Bugs**\n- **Production Ready:** ✅\n\n### 📚 Complete Documentation\n\n- **[React-to-Flutter Guide](REACT_TO_FLUTTER_GUIDE.md)** - 860-line comprehensive guide with examples, troubleshooting, FAQ\n- **[Architecture Documentation](ARCHITECTURE.md)** - Deep dive into refactoring system design\n- **[Development Guide](DEVELOPMENT.md)** - Contributing to the refactoring system\n\n### 🎯 Real-World Use Cases\n\n**Healthcare App (React Native → Flutter)**\n- Converted 15 components, 3,000 lines of code\n- HIPAA compliance maintained\n- Performance improved by 40%\n- Bundle size reduced by 60%\n\n**E-Commerce App (React → Flutter)**\n- Converted 25 components, 5,000 lines of code\n- Shopping cart, checkout, payment flow\n- Integrated with Stripe (PCI-DSS compliant)\n- 85% test coverage achieved\n\n**🚀 Ready for production!** Convert your React apps to Flutter with confidence.\n\n---\n\n## 🌍 v5.2 Feature: Flutter App Localization\n\n**Production Ready!** v5.2.0 delivers complete one-command Flutter app localization with Arabic-English (ar-en) support, RTL layout configuration, and AI-powered translation.\n\n### 🚀 Quick Start - Localize in One Command\n\n```bash\n# Navigate to your Flutter project\ncd your-flutter-project\n\n# Run localization command\ngemini localize\n\n# Or use CLI directly\ngemini-localize\n\n# With AI translation\ngemini-localize --ai gemini\n\n# Multi-language\ngemini-localize --languages en,ar,fr\n```\n\n### ✨ What You Get\n\n**Generated Files:**\n```\nlib/l10n/\n├── app_en.arb              # English master template\n├── app_ar.arb              # Arabic translations  \n└── integration_guide.md   # Step-by-step setup\nl10n.yaml                   # Flutter l10n config\npubspec.yaml                # Updated dependencies\n```\n\n**Features:**\n- ✅ **Automatic String Extraction**: Scans all `.dart` files for hardcoded strings\n- ✅ **ARB File Generation**: Creates master template and target language files\n- ✅ **ICU MessageFormat**: Handles plurals, placeholders, and string interpolation\n- ✅ **RTL Support**: Configures Right-to-Left layout for Arabic\n- ✅ **AI Translation**: Optional AI-powered Arabic translations\n- ✅ **Validation**: Comprehensive validation of ARB files and configuration\n- ✅ **Integration Guide**: Auto-generated step-by-step instructions\n\n### 🎯 Example Conversion\n\n<table>\n<tr>\n<th>Before (Hardcoded)</th>\n<th>→</th>\n<th>After (Localized)</th>\n</tr>\n<tr>\n<td>\n\n```dart\n// main.dart\nText('Welcome to App')\nAppBar(title: Text('Home'))\nTextField(hintText: 'Enter email')\n```\n\n</td>\n<td>⚡</td>\n<td>\n\n```dart\n// Generated ARB files\n// lib/l10n/app_en.arb\n{\n  \"@@locale\": \"en\",\n  \"welcomeMessage\": \"Welcome to App\",\n  \"titleHome\": \"Home\",\n  \"hintEnterEmail\": \"Enter email\"\n}\n\n// lib/l10n/app_ar.arb\n{\n  \"@@locale\": \"ar\",\n  \"textDirection\": \"rtl\",\n  \"welcomeMessage\": \"مرحباً بك في التطبيق\",\n  \"titleHome\": \"الرئيسية\",\n  \"hintEnterEmail\": \"أدخل البريد الإلكتروني\"\n}\n```\n\n</td>\n</tr>\n</table>\n\n### 🌍 Complete Feature Set\n\n<details>\n<summary><strong>📖 Automatic String Extraction</strong></summary>\n\nScans your entire Flutter project for hardcoded strings in:\n- `Text()` widgets\n- `AppBar(title:)` \n- `TextField(hintText:, labelText:)`\n- `ElevatedButton(child:)`\n- `AlertDialog()` messages\n- `SnackBar()` content\n\n**String Interpolation Handling:**\n```dart\n// Dart code:\nText('Hello $userName')  \nText('Total: ${cart.total}')\n\n// Generated ARB:\n\"greeting\": \"Hello {userName}\",\n\"totalAmount\": \"Total: {total}\"\n```\n\n**Generates semantic camelCase keys:**\n- \"Welcome to App\" → `welcomeToApp`\n- \"Enter email\" → `hintEnterEmail`  \n- \"Login Button\" → `buttonLogin`\n\n</details>\n\n<details>\n<summary><strong>📝 ARB File Generation</strong></summary>\n\nCreates proper Application Resource Bundle files with:\n\n**Master Template (app_en.arb):**\n- All extracted strings\n- Metadata for translators\n- Placeholder definitions with types\n- ICU MessageFormat for plurals\n\n**Target Language (app_ar.arb):**\n- Arabic translations (AI-powered optional)\n- RTL text direction indicator\n- Proper Arabic typography\n- ICU plural forms for Arabic\n\n**Example:**\n```json\n{\n  \"@@locale\": \"en\",\n  \"welcomeMessage\": \"Welcome, {userName}!\",\n  \"@welcomeMessage\": {\n    \"description\": \"Personalized greeting on home screen\",\n    \"placeholders\": {\n      \"userName\": {\n        \"type\": \"String\",\n        \"example\": \"Ahmed\"\n      }\n    }\n  },\n  \"itemCount\": \"{count, plural, =0{No items} =1{One item} other{{count} items}}\"\n}\n```\n\n</details>\n\n<details>\n<summary><strong>🔄 ICU MessageFormat Support</strong></summary>\n\nFull support for complex localization patterns:\n\n**Plurals:**\n```json\n\"itemCount\": \"{count, plural, =0{لا توجد عناصر} =1{عنصر واحد} other{{count} عناصر}}\"\n```\n\n**Gender:**\n```json\n\"greeting\": \"{gender, select, male{مرحباً} female{مرحباً} other{مرحباً}}\"\n```\n\n**Placeholders with Types:**\n- `String` - Text values\n- `int` - Integer counts\n- `double` - Decimal numbers\n- `DateTime` - Date/time values\n\n</details>\n\n<details>\n<summary><strong>↔️ RTL Layout Configuration</strong></summary>\n\nAutomatic RTL (Right-to-Left) setup for Arabic:\n\n**Generated Integration Guide includes:**\n- MaterialApp RTL configuration\n- EdgeInsetsDirectional usage\n- Directionality handling\n- Common RTL mistakes to avoid\n\n**Best Practices:**\n```dart\n// ✅ DO:\nEdgeInsetsDirectional.only(start: 16)  // Adapts to RTL\nDirectionality.of(context)              // Uses locale direction\n\n// ❌ DON'T:\nEdgeInsets.only(left: 16)  // Hardcoded LTR\nTextDirection.ltr          // Ignores locale\n```\n\n**Arabic Typography:**\n- Font configuration guidance\n- Proper line height (1.5+)\n- Diacritic support\n- Regional variations (Gulf, Egyptian, Levantine)\n\n</details>\n\n<details>\n<summary><strong>🤖 AI-Powered Translation</strong></summary>\n\nOptional AI translation with Gemini, Claude, or Qwen:\n\n```bash\ngemini-localize --ai gemini\n```\n\n**AI Translation Features:**\n- Context-aware translations\n- Placeholder preservation\n- Culturally appropriate phrasing\n- ICU MessageFormat handling\n- Batch translation for efficiency\n\n**Quality:**\n- Natural, native-sounding Arabic\n- Proper grammar and diacritics\n- Mobile UI optimized (concise)\n- RTL context aware\n\n</details>\n\n<details>\n<summary><strong>✅ Comprehensive Validation</strong></summary>\n\n8 validation checks ensure quality:\n1. ✅ ARB files are valid JSON\n2. ✅ All keys in master exist in all languages\n3. ✅ ICU MessageFormat syntax correct\n4. ✅ Placeholder types match across files\n5. ✅ `@@locale` keys present and correct\n6. ✅ `l10n.yaml` is valid YAML\n7. ✅ `pubspec.yaml` has required dependencies\n8. ✅ `flutter.generate = true` in pubspec\n\n**Output:**\n```\n✅ Validation: All checks passed (2 warnings)\n\n⚠️  Warnings:\n  1. Consider native speaker review for Arabic\n  2. Test RTL layout on real device\n```\n\n</details>\n\n### 📊 Command Options\n\n```bash\nUsage: gemini-localize [options]\n\nOptions:\n  -l, --languages <codes>   Comma-separated language codes (default: \"en,ar\")\n  --ai <provider>           AI provider (gemini|claude|qwen|none)\n  --dry-run                 Preview without writing files\n  --validate                Run validation (default: true)\n  -v, --verbose             Verbose logging\n  -o, --output-dir <path>   ARB output directory (default: \"lib/l10n\")\n  -h, --help                Display help\n\nExamples:\n  gemini-localize                        # en-ar localization\n  gemini-localize --languages en,ar,fr   # Add French\n  gemini-localize --ai gemini            # AI-powered translation\n  gemini-localize --dry-run              # Preview only\n```\n\n### 🎯 Real-World Example\n\n**Healthcare App Localization:**\n- Extracted 47 strings from 12 files\n- Generated ar-en ARB files\n- AI-translated with cultural sensitivity\n- RTL layout tested on real device\n- HIPAA compliance maintained\n- **Time:** < 2 minutes\n\n### 🚀 Usage Workflow\n\n1. **Run Localization:**\n   ```bash\n   gemini-localize\n   ```\n\n2. **Generated Files:**\n   - `lib/l10n/app_en.arb` - Master template\n   - `lib/l10n/app_ar.arb` - Arabic translations\n   - `l10n.yaml` - Configuration\n   - `lib/l10n/integration_guide.md` - Instructions\n\n3. **Generate Flutter Code:**\n   ```bash\n   flutter pub get\n   flutter gen-l10n\n   ```\n\n4. **Update MaterialApp:**\n   ```dart\n   import 'package:flutter_localizations/flutter_localizations.dart';\n   import 'package:flutter_gen/gen_l10n/app_localizations.dart';\n\n   MaterialApp(\n     localizationsDelegates: [\n       AppLocalizations.delegate,\n       GlobalMaterialLocalizations.delegate,\n       GlobalWidgetsLocalizations.delegate,\n       GlobalCupertinoLocalizations.delegate,\n     ],\n     supportedLocales: [\n       Locale('en'),\n       Locale('ar'),\n     ],\n   )\n   ```\n\n5. **Use Localized Strings:**\n   ```dart\n   Text(AppLocalizations.of(context)!.welcomeMessage)\n   ```\n\n### 📚 Documentation\n\n- **[Complete Localization Guide](docs/LOCALIZATION.md)** - Full feature documentation\n- **[Implementation Summary](LOCALIZATION-IMPLEMENTATION.md)** - Technical details\n- **[Examples](examples/localization/)** - Sample ARB files\n\n### 🎯 Benefits\n\n✅ **Zero Manual Work** - Fully automated string extraction  \n✅ **RTL Ready** - Complete Arabic layout support  \n✅ **AI Enhanced** - Optional AI-powered translation  \n✅ **Production Quality** - Comprehensive validation  \n✅ **Time Saved** - 2 minutes vs 2-3 hours manual  \n✅ **Best Practices** - Follows Flutter i18n guidelines  \n\n**🌍 Ready to localize your Flutter app!** Support multiple languages with one command.\n\n---\n\n## 📑 Table of Contents\n\n<details>\n<summary><strong>Click to expand</strong></summary>\n\n- [Quick Start](#one-command-complete-setup)\n  - [Quick Reference Card](#quick-reference-card)\n  - [Visual Workflow](#how-it-works---visual-workflow)\n- [System Requirements](#system-requirements)\n  - [Software Requirements](#software-requirements)\n  - [Hardware Requirements](#hardware-requirements)\n  - [Platform-Specific Notes](#platform-specific-notes)\n  - [Recent Improvements](#recent-cross-platform-improvements-v410)\n- [Configure AI Providers](#configure-ai-providers)\n- [Features](#features)\n  - [v4.4 Slash Commands](#v44-slash-commands-new)\n  - [v4.1 Enterprise Features](#v41-enterprise-features-new)\n  - [v4.0 Full Automation](#v40-full-automation-new)\n  - [v3.0 Features](#v30-new-features)\n- [What Gets Generated](#what-gets-generated)\n- [Creating Your PRD](#creating-your-prd)\n- [Security & Compliance](#security--compliance)\n- [Quick Troubleshooting](#quick-troubleshooting)\n- [FAQ](#faq)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [Roadmap](#roadmap)\n- [Support & Community](#support--community)\n- [Changelog](#changelog)\n\n</details>\n\n---\n\n<div align=\"center\">\n\n## **Transform Your PRD into 32 Secure, Production-Ready Development Guides**\n\n**Enterprise-grade Flutter development automation with slash commands, interactive mode, API validation, rate limiting, and intelligent command management.**\n\n**⏱️ Setup: 30 seconds** • **🔄 NEW v5.0: React→Flutter** • **💬 v4.4: Slash Commands** • **🎮 v4.1: Interactive Mode** • **⚡ 40-60x Faster** • **🔒 Security Audited**\n\n</div>\n\n<div align=\"center\">\n\n### **🚀 One Command. Complete Setup.**\n\n**🆕 v5.0.0 - Production-Ready React-to-Flutter Conversion + Perfect Multi-AI Parity!**\n```bash\n# Install via npm (works on Windows/macOS/Linux)\nnpm install -g prprompts-flutter-generator\n\n# ALL 21 commands now work identically across all 3 AIs!\nprprompts interactive  # Launch interactive mode!\nprprompts create       # Create PRD\nprprompts generate     # Generate all 32 files\n\n# Or use slash commands in AI chat (29 total: 21 commands + 8 skills):\n/prd:create            # Create PRD in-chat\n/prprompts:generate-all # Generate all 32 files in-chat\n/automation:bootstrap  # Complete project setup (2 min)\n```\n\n**✨ NEW v5.0.0: Complete React-to-Flutter refactoring system with production-ready conversion!**\n**✨ v4.4: Slash commands for in-chat usage + TOML auto-generation for perfect parity!**\n**✨ v4.1: Interactive mode, API validation, rate limiting, progress indicators, and command history!**\n\n### 📊 How It Works - Visual Workflow\n\n```mermaid\ngraph LR\n    A[📝 PRD Document] -->|60 seconds| B[32 PRPROMPTS Files]\n    B -->|Instant| C[🤖 AI Assistant]\n    C -->|1-2 hours| D[✅ Flutter Code]\n    D -->|Ready| E[🚀 Production App]\n\n    style A fill:#e1f5ff\n    style B fill:#fff9c4\n    style C fill:#f3e5f5\n    style D fill:#e8f5e9\n    style E fill:#c8e6c9\n```\n\n<table>\n<tr>\n<td align=\"center\" width=\"20%\"><strong>📝 PRD</strong><br/>Your requirements<br/><code>60 sec</code></td>\n<td align=\"center\" width=\"5%\">→</td>\n<td align=\"center\" width=\"20%\"><strong>📚 PRPROMPTS</strong><br/>32 secure guides<br/><code>Instant</code></td>\n<td align=\"center\" width=\"5%\">→</td>\n<td align=\"center\" width=\"20%\"><strong>🤖 AI Code</strong><br/>Auto-implementation<br/><code>1-2 hours</code></td>\n<td align=\"center\" width=\"5%\">→</td>\n<td align=\"center\" width=\"20%\"><strong>🚀 Production</strong><br/>Ready to deploy<br/><code>Done!</code></td>\n</tr>\n<tr>\n<td colspan=\"7\" align=\"center\">\n<strong>Total Time: 2-3 hours</strong> (vs 3-5 days manual) = <strong>40-60x faster!</strong>\n</td>\n</tr>\n</table>\n\n**⚠️ Permissions Note:**\n- **Windows:** No special permissions required (npm installs to your user directory)\n- **macOS/Linux:** Use one of these methods to avoid sudo:\n  - **Recommended:** Use [nvm](https://github.com/nvm-sh/nvm) (Node Version Manager)\n  - **Alternative:** Configure npm for user-level installations (see [docs/installation/MACOS-QUICKSTART.md](docs/installation/MACOS-QUICKSTART.md#permission-denied-or-eacces-errors))\n  - **Not recommended:** Using `sudo npm install -g` can cause permission issues later\n\n**Alternative Methods:**\n\n**Windows PowerShell:**\n```powershell\nirm https://raw.githubusercontent.com/Kandil7/prprompts-flutter-generator/master/scripts/setup-gist.ps1 | iex\n```\n\n**Linux / macOS / Git Bash:**\n```bash\ncurl -sSL https://raw.githubusercontent.com/Kandil7/prprompts-flutter-generator/master/scripts/smart-install.sh | bash\n```\n\n**📌 Git Bash on Windows:** All bash scripts work natively in Git Bash! The postinstall script automatically detects Git Bash and uses the correct installer. [Learn more](#git-bash-windows)\n\n[📦 Quick Install](#installation) • [🪟 Windows Guide](docs/installation/WINDOWS-QUICKSTART.md) • [✨ v4.1 Features](#v41-enterprise-features-new) • [📖 Docs](docs/PRPROMPTS-SPECIFICATION.md)\n\n</div>\n\n---\n\n## ⚡ Quick Reference Card\n\n<div align=\"center\">\n\n**One-Liner Install:**\n```bash\nnpm install -g prprompts-flutter-generator && prprompts interactive\n```\n\n</div>\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🚀 Essential Commands\n\n```bash\n# Core workflow\nprprompts create         # Create PRD\nprprompts generate       # Generate 32 files\nprprompts interactive    # Launch menu UI\n\n# Diagnostics\nprprompts doctor         # Check setup\nprprompts validate-keys  # Validate APIs\nprprompts rate-status    # Check limits\n```\n\n</td>\n<td width=\"50%\">\n\n### 🔗 Quick Links\n\n**Setup Guides:**\n- [Windows](docs/installation/WINDOWS-QUICKSTART.md) 🪟\n- [macOS](docs/installation/MACOS-QUICKSTART.md) 🍎\n- [Troubleshooting](docs/TROUBLESHOOTING.md) 🔧\n\n**AI Guides:**\n- [Claude](docs/CLAUDE-USER-GUIDE.md)\n- [Qwen](QWEN.md)\n- [Gemini](GEMINI.md)\n\n</td>\n</tr>\n<tr>\n<td colspan=\"2\">\n\n### 🎯 Complete Workflow (2-3 hours)\n\n```bash\n# 1️⃣ Setup (30 seconds)\nnpm install -g prprompts-flutter-generator\nprprompts setup-keys claude\n\n# 2️⃣ Generate PRPROMPTS (60 seconds)\ncd your-flutter-project\nprprompts create && prprompts generate\n\n# 3️⃣ Automate Development (1-2 hours)\nclaude                                    # Start AI\n/automation/bootstrap                     # Setup project (2 min)\n/automation/full-cycle                    # Implement features (1-2 hours)\n# Input: 10 features\n\n# 4️⃣ Quality Check (2 minutes)\n/automation/qa-check                      # Compliance audit\n\n# ✅ Result: Production-ready app with 70%+ test coverage!\n```\n\n</td>\n</tr>\n</table>\n\n---\n\n## 📋 System Requirements\n\n<div align=\"center\">\n\n### Software Requirements\n\n| Component | Minimum | Recommended | Notes |\n|-----------|---------|-------------|-------|\n| **Node.js** | v20.0.0 | v20 LTS (20.11.0+) | LTS recommended • [Download](https://nodejs.org) |\n| **npm** | v9.0.0 | v10.0.0+ | Included with Node.js |\n| **Operating System** | Windows 10, macOS 10.15, Ubuntu 20.04 | Windows 11, macOS 14+, Latest LTS | Full cross-platform support |\n| **Shell** | Any | PowerShell 7+ / zsh | PowerShell, CMD, Git Bash, bash, zsh, WSL all supported |\n| **AI CLI** | Any one | Claude Code | At least one: Claude Code, Qwen Code, or Gemini CLI |\n| **Flutter** | 3.24+ | 3.27+ | For development only (not required for PRPROMPTS generation) |\n\n### Hardware Requirements\n\n| Resource | Minimum | Recommended | Notes |\n|----------|---------|-------------|-------|\n| **RAM** | 2 GB free | 4 GB+ free | More for large projects |\n| **Disk Space** | 500 MB | 1 GB+ | Includes npm dependencies |\n| **CPU** | Any | Multi-core | Faster generation with more cores |\n| **Network** | Required | Broadband | For AI API calls (Claude/Qwen/Gemini) |\n| **Internet Speed** | 1 Mbps+ | 10 Mbps+ | Faster API responses |\n\n</div>\n\n### Platform-Specific Notes\n\n**Windows:**\n- ✅ Full support for PowerShell, CMD, and Git Bash\n- ✅ WSL (Windows Subsystem for Linux) supported\n- ✅ No administrator privileges required\n- 📖 [Windows Quick Start Guide](docs/installation/WINDOWS-QUICKSTART.md)\n\n**macOS:**\n- ✅ Full support for Intel and Apple Silicon (M1/M2/M3)\n- ✅ Works with Homebrew, nvm, or official Node.js\n- ✅ Both zsh and bash shells supported\n- ✅ No sudo required (use nvm recommended)\n- 📖 [macOS Quick Start Guide](docs/installation/MACOS-QUICKSTART.md)\n\n**Linux:**\n- ✅ Tested on Ubuntu, Debian, Fedora, Arch\n- ✅ Works with system npm, nvm, or Node Version Manager\n- ✅ All major distributions supported\n- 💡 Use nvm to avoid permission issues\n\n**Git Bash (Windows):**\n- ✅ Fully supported with automatic detection\n- ✅ All `.sh` scripts work natively\n- ✅ postinstall automatically uses bash installer\n- 💡 Recommended for Windows developers familiar with Unix commands\n\n### ✨ Recent Cross-Platform Improvements (v4.1.0+)\n\n**Installation Enhancements:**\n- ✅ **No mandatory parameters**: All installer scripts now work without arguments (defaults to `--global`)\n- ✅ **Smart shell detection**: Automatically detects PowerShell, CMD, Git Bash, and WSL on Windows\n- ✅ **Improved error handling**: Better error messages with platform-specific solutions\n- ✅ **Path auto-detection**: Works with standard npm, Homebrew, nvm, and custom npm configurations\n\n**Documentation Improvements:**\n- 📖 New [macOS Quick Start Guide](docs/installation/MACOS-QUICKSTART.md) with Apple Silicon notes\n- 📖 Enhanced [Windows Quick Start Guide](docs/installation/WINDOWS-QUICKSTART.md) with Git Bash support\n- 📖 Platform-specific verification commands (CMD, PowerShell, bash/zsh)\n- 📖 Clear permission guidance (no more sudo confusion)\n- 📖 Comprehensive troubleshooting for all platforms\n\n**Verification Commands:**\n```bash\n# Check your setup works correctly\nprprompts doctor              # Comprehensive diagnostics\nprprompts validate-keys       # Validate API keys\n\n# Platform-specific checks available in each guide\n```\n\n---\n\n## 🔑 Configure AI Providers\n\nPRPROMPTS works with three AI assistants. Choose one (or install all for flexibility):\n\n<div align=\"center\">\n\n| AI Provider | Installation | Authentication |\n|-------------|--------------|----------------|\n| **Claude Code** | `npm install -g @anthropic-ai/claude-code` | [Get API Key](https://console.anthropic.com/settings/keys) |\n| **Qwen Code** | `npm install -g @qwenlm/qwen-code` | [Get API Key](https://dashscope.aliyun.com/) |\n| **Gemini CLI** | `npm install -g @google/gemini-cli` | [Get API Key](https://aistudio.google.com/app/apikey) |\n\n</div>\n\n### Quick Setup\n\n**1. Install an AI CLI** (pick one or install all):\n\n```bash\n# Option 1: Claude Code (by Anthropic)\nnpm install -g @anthropic-ai/claude-code\n\n# Option 2: Qwen Code (by Alibaba Cloud)\nnpm install -g @qwenlm/qwen-code\n\n# Option 3: Gemini CLI (by Google)\nnpm install -g @google/gemini-cli\n```\n\n**💡 Permissions:** On macOS/Linux, avoid `sudo` - use [nvm](https://github.com/nvm-sh/nvm) or configure npm user-level installs. See [docs/installation/MACOS-QUICKSTART.md](docs/installation/MACOS-QUICKSTART.md) for details.\n\n**2. Configure API Keys**:\n\n**NEW in v4.1 - Interactive Setup:**\n```bash\n# Easy interactive setup (Recommended!)\nprprompts setup-keys claude\nprprompts setup-keys gemini\nprprompts setup-keys qwen\n\n# Validate all keys\nprprompts validate-keys\n```\n\n**Or manual setup:**\n```bash\n# Copy environment template\ncp .env.example .env\n\n# Edit .env and add your API key(s):\n# ANTHROPIC_API_KEY=sk-ant-api03-xxxxx\n# DASHSCOPE_API_KEY=sk-xxxxx\n# GOOGLE_API_KEY=AIzaSyxxxxx\n```\n\n**3. Verify Setup**:\n\n```bash\n# Check installation and API keys\nprprompts doctor         # Comprehensive diagnostics\nprprompts validate-keys  # Validate API keys\n\n# Launch interactive mode (easiest!)\nprprompts interactive\n\n# Or test with commands\nprprompts --version      # Should show 5.0.0\n```\n\n**🔒 Security:** See [`.env.example`](.env.example) for detailed API key setup and [SECURITY.md](SECURITY.md#api-key-management) for best practices on API key management, rotation, and incident response.\n\n\n---\n\n## 🤖 v4.0: Full Automation (NEW!)\n\n<div align=\"center\">\n\n**🚀 Go from PRD to working code automatically!**\n\n**Zero-touch automation with PRPROMPTS-guided implementation**\n\n**✨ NEW: Claude Code Skills System - 30 Specialized Automation Skills**\n\n</div>\n\n### Complete Automation Pipeline\n\n```bash\n# 1. Generate PRPROMPTS (60 seconds)\nprprompts auto && prprompts generate\n\n# 2. Start AI assistant\nclaude  # or qwen, or gemini\n\n# 3. Bootstrap project (2 minutes) - Using Skills\n@claude use skill automation/flutter-bootstrapper\n\n# 4. Auto-implement features (1-2 hours) - Using Skills\n@claude use skill automation/automation-orchestrator\n# Input: feature_count: 10\n\n# 5. Code review - Using Skills\n@claude use skill automation/code-reviewer\n\n# 6. QA audit (2 minutes) - Using Skills\n@claude use skill automation/qa-auditor\n# Input: audit_type: \"pre-production\"\n```\n\n### 🎯 Claude Code Skills System (NEW!)\n\n**PRPROMPTS now includes a comprehensive skills system with 30+ specialized automation skills across 5 categories:**\n\n<table>\n<tr>\n<th>Category</th>\n<th>Skills</th>\n<th>Status</th>\n<th>Use Cases</th>\n</tr>\n<tr>\n<td><strong>🤖 Automation (100%)</strong></td>\n<td>\n• flutter-bootstrapper<br/>\n• feature-implementer<br/>\n• automation-orchestrator<br/>\n• code-reviewer<br/>\n• qa-auditor\n</td>\n<td>✅ 5/5 Complete</td>\n<td>\nComplete automation pipeline from bootstrap to production audit\n</td>\n</tr>\n<tr>\n<td><strong>📝 PRPROMPTS Core (80%)</strong></td>\n<td>\n• prd-creator<br/>\n• prprompts-generator<br/>\n• phase-generator<br/>\n• single-file-generator<br/>\n• prd-analyzer (planned)\n</td>\n<td>✅ 4/5 Complete</td>\n<td>\nPRD creation and PRPROMPTS generation\n</td>\n</tr>\n<tr>\n<td><strong>✅ Validation (0%)</strong></td>\n<td>\n• architecture-validator<br/>\n• security-validator<br/>\n• compliance-checker<br/>\n• test-validator\n</td>\n<td>⏳ Planned</td>\n<td>\nDeep validation of architecture, security, compliance, tests\n</td>\n</tr>\n<tr>\n<td><strong>🛠️ Utilities (0%)</strong></td>\n<td>\n• api-validator<br/>\n• rate-monitor<br/>\n• progress-tracker<br/>\n• state-manager\n</td>\n<td>⏳ Planned</td>\n<td>\nAPI validation, rate limiting, progress tracking\n</td>\n</tr>\n<tr>\n<td><strong>🎨 Workflow (100%)</strong></td>\n<td>\n• flutter-flavors\n</td>\n<td>✅ 1/1 Complete</td>\n<td>\nMulti-environment configuration (dev/staging/prod)\n</td>\n</tr>\n</table>\n\n**Overall Progress: 10/23 skills (43.5% complete)**\n\n**How Skills Work:**\n\n**Claude Code:**\n```bash\n# Invoke any skill in Claude Code\n@claude use skill automation/code-reviewer\n\n# Skills prompt for inputs if needed\n# Input: review_type: \"security\"\n# Input: target_path: \"lib/features/auth\"\n\n# Skills execute autonomously with detailed output\n# Example output: Comprehensive review report with scoring\n```\n\n**Qwen Code (NEW!):**\n```bash\n# Skills available as global TOML slash commands\nqwen\n\n# Use skills with smart defaults\n/skills/automation/code-reviewer\n# > Review type? (full): [Just press Enter]\n# ✅ Using defaults: review_type='full', target_path='lib/'\n\n# Complete automation workflow\n/skills/automation/flutter-bootstrapper\n/skills/automation/automation-orchestrator\n# > Feature count? 10\n/skills/automation/qa-auditor\n# > Generate cert? y\n```\n\n📖 **[Qwen Skills Complete Guide](docs/QWEN-SKILLS-GUIDE.md)** - Comprehensive usage guide with smart defaults, workflows, and examples\n\n**Key Skills Capabilities:**\n\n**automation-orchestrator:**\n- Orchestrates 1-10 feature implementations\n- Topological sort for dependency resolution\n- Circular dependency detection\n- Execution time: 1-2 hours for 10 features\n\n**code-reviewer:**\n- 7-step review process (architecture, security, testing, style)\n- Weighted scoring system (0-100)\n- Auto-fix capability for common issues\n- Multiple output formats (markdown/json/html)\n\n**qa-auditor:**\n- Comprehensive audit across 6 categories\n- Compliance certification (HIPAA, PCI-DSS, GDPR, SOC2, COPPA, FERPA)\n- Pass/fail with configurable threshold (default 75/100)\n- Certificate generation with expiration dates\n\n📖 **Documentation:**\n- **[Claude Skills](\\.claude\\skills\\index.md)** - Claude Code skills documentation\n- **[Qwen Skills](docs/QWEN-SKILLS-GUIDE.md)** - Qwen Code TOML slash commands guide (NEW!)\n- **[Qwen Setup](QWEN.md)** - Complete Qwen Code setup with skills installation\n- **[Gemini Skills](docs/GEMINI-SKILLS-GUIDE.md)** - Gemini CLI TOML slash commands guide (NEW!)\n- **[Gemini Setup](GEMINI.md)** - Complete Gemini CLI setup with skills installation\n\n**Gemini CLI (NEW!):**\n```bash\n# Skills available as global TOML slash commands with colon separator\ngemini\n\n# Inline arguments (Gemini-specific feature!)\n/skills:automation:code-reviewer security lib/features/auth true\n# No prompts - arguments parsed automatically!\n\n# Leverage 1M token context\n/skills:automation:code-reviewer full lib/\n# Loads entire codebase (150 files) in single pass!\n\n# Complete automation workflow\n/skills:automation:flutter-bootstrapper . true true true true hipaa\n/skills:automation:automation-orchestrator 10\n/skills:automation:qa-auditor . hipaa,pci-dss true true QA_REPORT.md 85\n```\n\n**Gemini-Specific Advantages:**\n- ✅ **1M Token Context** - Analyze entire codebases (5x larger than Claude)\n- ✅ **{{args}} Support** - Inline arguments for streamlined workflows\n- ✅ **ReAct Agent Mode** - Autonomous reasoning and acting loops\n- ✅ **Free Tier** - 60 req/min, 1,000/day (no credit card required)\n- ✅ **Colon Separator** - `/skills:automation:code-reviewer` syntax (vs. Qwen's slash separator)\n\n📖 **[Gemini Skills Complete Guide](docs/GEMINI-SKILLS-GUIDE.md)** - Comprehensive usage guide with Gemini-specific features, workflows, and benchmarks\n\n### New Automation Commands\n\n<table>\n<tr>\n<td width=\"50%\">\n\n**`/bootstrap-from-prprompts`**\nComplete project setup in 2-5 minutes:\n- ✅ Clean Architecture structure\n- ✅ Design system (Material 3)\n- ✅ Security infrastructure (JWT, encryption)\n- ✅ Test infrastructure\n- ✅ ARCHITECTURE.md & IMPLEMENTATION_PLAN.md\n\n</td>\n<td width=\"50%\">\n\n**`/implement-next`**\nAuto-implement next task:\n- ✅ Follows PRPROMPTS patterns\n- ✅ Generates comprehensive tests\n- ✅ Security validation (JWT, PCI-DSS, HIPAA)\n- ✅ Code quality checks\n- ✅ Automatic staging\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n**`/review-and-commit`**\nValidate and commit:\n- ✅ PRPROMPTS compliance check\n- ✅ Security validation\n- ✅ Test coverage verification\n- ✅ Code formatting\n- ✅ Conventional commit messages\n\n</td>\n<td width=\"50%\">\n\n**`/full-cycle`**\nComplete automation loop:\n- ✅ Implement multiple tasks (1-10)\n- ✅ Auto-test each task\n- ✅ Auto-commit with validation\n- ✅ Progress tracking\n- ✅ Quality gate at end\n\n</td>\n</tr>\n<tr>\n<td colspan=\"2\">\n\n**`/qa-check`**\nComprehensive PRPROMPTS compliance audit:\n- ✅ Architecture validation (Clean Architecture, BLoC)\n- ✅ Security patterns (JWT verification, PII encryption, PCI-DSS)\n- ✅ Test coverage (>70%)\n- ✅ Static analysis (flutter analyze)\n- ✅ Generates QA_REPORT.md with compliance score\n\n</td>\n</tr>\n</table>\n\n### Example: Healthcare App Automation\n\n```bash\n# Complete healthcare app in 2-3 hours (vs 2-3 days manual)\ncd ~/projects/healthtrack-pro\nflutter create .\n\n# Generate PRPROMPTS with HIPAA compliance\ncp templates/healthcare.md project_description.md\nprprompts auto && prprompts generate\n\n# Auto-bootstrap\nclaude\n/bootstrap-from-prprompts\n\n# Auto-implement 15 features\n/full-cycle\n15\n\n# Security audit\n/qa-check\n\n# Result: Production-ready HIPAA-compliant app!\n# - JWT verification (RS256)\n# - PHI encryption (AES-256-GCM)\n# - Audit logging\n# - 85% test coverage\n# - Zero security violations\n```\n\n### What Gets Automated\n\n<table>\n<tr>\n<th>Manual (3-5 days)</th>\n<th>Automated with v4.0 (2-3 hours)</th>\n</tr>\n<tr>\n<td>\n\n- Set up folder structure\n- Configure dependencies\n- Create design system\n- Implement security\n- Write features\n- Generate tests\n- Fix bugs\n- Run QA\n- Make commits\n\n</td>\n<td>\n\n**All of this happens automatically:**\n- `/bootstrap-from-prprompts` - Setup (2 min)\n- `/full-cycle` - Implement & test (1-2 hours)\n- `/qa-check` - Validate (2 min)\n\n**Every line follows PRPROMPTS patterns**\n**Security built-in (JWT, encryption, compliance)**\n**Tests auto-generated and passing**\n\n</td>\n</tr>\n</table>\n\n### Installation\n\n```bash\n# Install automation commands (works with existing installation)\n./scripts/install-automation-commands.sh --global\n\n# Verify commands available\nclaude  # In Claude Code, you'll see all 5 automation commands\n```\n\n**Works with:**\n- ✅ Claude Code\n- ✅ Qwen Code\n- ✅ Gemini CLI\n\n📖 **[Complete Automation Guide](docs/AUTOMATION-GUIDE.md)** - Full workflow examples, troubleshooting, security validation\n\n---\n\n## ✨ v3.0 New Features\n\n<div align=\"center\">\n\n**🎉 Major update with powerful installation improvements!**\n\n</div>\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🤖 Smart Unified Installer\n**One command to install everything**\n- Auto-detects your OS and AI assistants\n- Offers to install missing AIs\n- Installs commands for all detected AIs\n- Creates unified configuration\n- Beautiful interactive prompts\n\n</td>\n<td width=\"50%\">\n\n### 🔧 Unified CLI (`prprompts` command)\n**Single interface for all AIs**\n```bash\nprprompts create     # Instead of claude/qwen/gemini\nprprompts generate   # Uses your preferred AI\nprprompts switch ai  # Change default AI\nprprompts doctor     # Diagnose issues\n```\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n### 🔄 Auto-Update System\n**Stay current effortlessly**\n- One-command updates from npm registry\n- Automatic backup before update\n- Background update notifications\n- Version tracking per AI\n- Rollback capability\n\n```bash\nprprompts update         # Update to latest\nprprompts check-updates  # Check for new versions\n```\n\n**Auto-notifications:** Updates are checked automatically once per day (configurable).\n\n</td>\n<td width=\"50%\">\n\n### 📦 Project Templates\n**Quick start for common projects**\n- Healthcare (HIPAA-compliant)\n- Fintech (PCI-DSS compliant)\n- E-Commerce\n- Generic apps\n\nPre-configured with best practices!\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n### 🐚 Shell Completions\n**Tab completion for faster workflow**\n- Bash, Zsh, Fish support\n- Command completion\n- AI name completion\n- File name completion\n\n</td>\n<td width=\"50%\">\n\n### 🩺 Doctor Command\n**Instant diagnostics**\n```bash\nprprompts doctor\n```\nChecks Node.js, npm, Git, AIs, configs, and more!\n\n</td>\n</tr>\n</table>\n\n<div align=\"center\">\n\n**[📖 Read Full v3.0 Feature Guide](docs/NEW-FEATURES-V3.md)**\n\n</div>\n\n---\n\n## 📦 v4.0.0 - Full Extension Ecosystem\n\n<div align=\"center\">\n\n**🚀 Now published on npm with complete AI extension support!**\n\n**✨ 3 Official Extensions • 5 Automation Commands • 14 Commands Per AI**\n\n</div>\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🎁 Complete Extension Ecosystem\n**All 3 AI extensions included!**\n\n**Claude Code Extension:**\n- 9.5/10 accuracy\n- Production-quality\n- Official Anthropic support\n\n**Qwen Code Extension:**\n- 256K-1M token context\n- Extended context analysis\n- Cost-effective\n\n**Gemini CLI Extension:**\n- 1M token context\n- 60 req/min FREE tier\n- **NEW: Slash commands in `/help`**\n- Best for MVPs\n- Native TOML command integration\n\n</td>\n<td width=\"50%\">\n\n### 🤖 Full Automation (v4.0)\n**40-60x faster development!**\n\n**5 Automation Commands:**\n1. `/bootstrap-from-prprompts` - Setup (2 min)\n2. `/implement-next` - Auto-code (10 min)\n3. `/full-cycle` - 1-10 features (1-2 hours)\n4. `/review-and-commit` - Validate\n5. `/qa-check` - Compliance audit\n\n**Result:** Production-ready app in 2-3 hours vs 3-5 days!\n\n</td>\n</tr>\n<tr>\n<td colspan=\"2\">\n\n### 📦 One Command Installation\n```bash\n# Install everything at once (30 seconds)\nnpm install -g prprompts-flutter-generator\n```\n\n**What gets installed:**\n- ✅ All 3 AI extensions (Claude, Qwen, Gemini)\n- ✅ **21 commands per AI** (6 PRD + 4 Planning + 5 PRPROMPTS + 6 Automation)\n- ✅ 32 security-audited development guides\n- ✅ Project templates (Healthcare, Fintech, E-commerce)\n- ✅ Unified CLI (`prprompts` command)\n- ✅ Auto-configuration for detected AIs\n- ✅ Shell completions (Bash/Zsh/Fish)\n\n**Then use anywhere:**\n```bash\ncd your-flutter-project\nprprompts create && prprompts generate  # Generate PRPROMPTS (60 sec)\n\n# Use any AI assistant (all 21 commands available)\nclaude bootstrap-from-prprompts         # Setup project (2 min)\nclaude full-cycle                       # Auto-implement (1-2 hours)\n\n# Or with Gemini (same commands)\ngemini bootstrap-from-prprompts         # Setup project (2 min)\ngemini full-cycle                       # Auto-implement (1-2 hours)\n\n# Or with Qwen (same commands)\nqwen bootstrap-from-prprompts           # Setup project (2 min)\nqwen full-cycle                         # Auto-implement (1-2 hours)\n```\n\n</td>\n</tr>\n</table>\n\n**Upgrade from previous versions:**\n```bash\n# Update to v5.0.0 with React-to-Flutter refactoring\nnpm update -g prprompts-flutter-generator\n\n# Verify\nprprompts --version  # Should show 5.0.0\nprprompts doctor     # Check extension status\n\n# Verify TOML files generated correctly (Qwen/Gemini users)\nls ~/.config/qwen/commands/*.toml     # Should show 21 .toml files\nls ~/.config/gemini/commands/*.toml   # Should show 21 .toml files\n```\n\n---\n\n## 💬 v4.4: Slash Commands (NEW!)\n\n<div align=\"center\">\n\n**🚀 Use all 21 PRPROMPTS commands directly in your AI chat!**\n\n**No more switching between terminal and chat - everything in one place**\n\n</div>\n\n### 🎯 What Are Slash Commands?\n\nSlash commands let you run PRPROMPTS commands **directly in your AI assistant's chat interface** instead of using the terminal. Just type `/` and start typing to see available commands!\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 📝 **Before v4.4: Terminal Only**\n\n```bash\n# Switch to terminal\nprprompts create\n\n# Back to chat to ask AI for help\n# Switch to terminal again\nprprompts generate\n\n# Back to chat...\n```\n\n**❌ Constant context switching**\n**❌ Hard to remember commands**\n**❌ Separate from AI conversation**\n\n</td>\n<td width=\"50%\">\n\n### ✨ **After v4.4: In-Chat Commands**\n\n```\n# Everything in one chat session:\n/prd/create\n\n# AI helps you fill it out\n# Then continue:\n/prprompts/generate-all\n\n# Keep working in the same context!\n```\n\n**✅ Stay in the conversation**\n**✅ Discoverable with autocomplete**\n**✅ AI context maintained**\n\n</td>\n</tr>\n</table>\n\n### 📚 All 21 Slash Commands (Perfect Multi-AI Parity!)\n\nCommands are organized by category for easy discovery. **ALL 21 commands work identically on Claude Code, Qwen Code, and Gemini CLI:**\n\n<table>\n<tr>\n<td width=\"50%\">\n\n#### **📝 PRD Commands** (`/prd/...`)\n\n| Command | Description |\n|---------|-------------|\n| `/prd/create` | Interactive PRD wizard |\n| `/prd/auto-generate` | Auto-generate from description |\n| `/prd/from-files` | Generate from markdown files |\n| `/prd/auto-from-project` | Auto-discover project files |\n| `/prd/analyze` | Validate and analyze PRD |\n| `/prd/refine` | AI-guided refinement |\n\n#### **📊 Planning Commands** (`/planning/...`)\n\n| Command | Description |\n|---------|-------------|\n| `/planning/estimate-cost` | Cost breakdown analysis |\n| `/planning/analyze-dependencies` | Feature dependency mapping |\n| `/planning/stakeholder-review` | Generate review checklists |\n| `/planning/implementation-plan` | Sprint-based planning |\n\n</td>\n<td width=\"50%\">\n\n#### **📚 PRPROMPTS Commands** (`/prprompts/...`)\n\n| Command | Description |\n|---------|-------------|\n| `/prprompts/generate-all` | Generate all 32 files |\n| `/prprompts/phase-1` | Core Architecture (10 files) |\n| `/prprompts/phase-2` | Quality & Security (12 files) |\n| `/prprompts/phase-3` | Demo & Learning (10 files) |\n| `/prprompts/single-file` | Generate one specific file |\n\n#### **🤖 Automation Commands** (`/automation/...`)\n\n| Command | Description |\n|---------|-------------|\n| `/automation/bootstrap` | Complete project setup |\n| `/automation/implement-next` | Auto-implement next feature |\n| `/automation/update-plan` | Re-plan based on progress |\n| `/automation/full-cycle` | Auto-implement 1-10 features |\n| `/automation/review-commit` | Validate and commit changes |\n| `/automation/qa-check` | Compliance audit |\n\n</td>\n</tr>\n</table>\n\n### 🚀 Quick Start with Slash Commands\n\n```bash\n# 1. Install (one time)\nnpm install -g prprompts-flutter-generator\n\n# 2. Open your AI assistant (Claude Code, Qwen Code, or Gemini CLI)\nclaude\n\n# 3. Use slash commands in chat:\n/prd/create                    # Create your PRD\n/prprompts/generate-all        # Generate 32 files\n/automation/bootstrap          # Setup project\n/automation/implement-next     # Start implementing!\n```\n\n### 💡 Tips & Best Practices\n\n- **Discoverability**: Type `/` to see all available commands\n- **Category Organization**: Commands grouped by purpose (prd/, planning/, prprompts/, automation/)\n- **Context Maintained**: AI remembers your conversation while running commands\n- **Still Works in Terminal**: Traditional `prprompts create` still works if you prefer CLI\n- **Multi-AI Support**: Same slash commands work in Claude Code, Qwen Code, and Gemini CLI\n\n### 🔄 Comparison: CLI vs Slash Commands\n\n| Method | Example | Best For |\n|--------|---------|----------|\n| **Terminal CLI** | `prprompts create` | Scripting, automation, CI/CD |\n| **Slash Commands** | `/prd/create` | Interactive development, learning |\n| **Interactive Mode** | `prprompts interactive` | Menu-driven workflows |\n\n**💡 Pro Tip**: Use slash commands for interactive work and CLI for automation scripts!\n\n---\n\n## 🌟 v4.1: Enterprise Features (NEW!)\n\n<div align=\"center\">\n\n**🚀 Transform PRPROMPTS into an enterprise-grade development powerhouse!**\n\n**Interactive Mode • API Validation • Rate Limiting • Progress Tracking • Command History**\n\n</div>\n\n### 🎯 New Enterprise Features\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🎮 Interactive Mode\n**Menu-driven interface for easier usage**\n\n```bash\nprprompts interactive\n```\n\nNavigate through hierarchical menus:\n- 📝 Create PRD & Generate PRPROMPTS\n- 🤖 Automation Pipeline\n- 🔧 AI Configuration\n- 🛠️ Project Tools\n- ⚙️ Settings & Help\n\nNo more remembering commands!\n\n</td>\n<td width=\"50%\">\n\n### 🔑 API Key Validation\n**Pre-flight validation & setup**\n\n```bash\n# Validate all API keys\nprprompts validate-keys\n\n# Interactive setup\nprprompts setup-keys claude\n```\n\nFeatures:\n- ✅ Multi-location detection\n- ✅ Online validation\n- ✅ Interactive wizard\n- ✅ Secure storage\n\n</td>\n</tr>\n<tr>\n<td width=\"50%\">\n\n### 📊 Rate Limit Management\n**Never hit API limits again**\n\n```bash\nprprompts rate-status\n```\n\nVisual usage tracking:\n```\nCLAUDE (free tier):\n  Per minute: [████████░░] 80% 4/5\n  Per day:    [██░░░░░░░░] 20% 20/100\n  Tokens:     [████░░░░░░] 40% 4K/10K\n```\n\n- 🎯 AI recommendation based on availability\n- ⏳ Automatic backoff & retry\n- 📈 Tier-based tracking\n\n</td>\n<td width=\"50%\">\n\n### 📈 Progress Indicators\n**Visual feedback for all operations**\n\nReal-time progress bars:\n```\nProcessing: [████████████░░░░] 75% ETA: 20s\nLoading: ⠸ Loading data (15/30)\nConnecting...\n✓ Initialize project\n→ Install dependencies\n○ Generate PRPROMPTS\n```\n\nMultiple indicator types:\n- Progress bars with ETA\n- Spinners for async tasks\n- Step indicators\n- Parallel progress\n\n</td>\n</tr>\n<tr>\n<td colspan=\"2\">\n\n### 📚 Command History System\n**Intelligent command tracking & suggestions**\n\n```bash\n# Browse history interactively\nprprompts history\n\n# Search previous commands\nprprompts history-search create\n\n# Get suggestions (auto-complete coming soon!)\n```\n\nFeatures:\n- 🔍 Search & filter capabilities\n- 📊 Frequency tracking\n- 🏷️ Auto-tagging\n- 💡 Context-aware suggestions\n- 📤 Export/import for team sharing\n\n</td>\n</tr>\n</table>\n\n### 🚀 Quick Start with v5.0.0\n\n```bash\n# 1. Install/Update to v5.0.0 (React-to-Flutter + TOML auto-generation)\nnpm install -g prprompts-flutter-generator@latest\n\n# 2. Setup API keys interactively\nprprompts setup-keys claude\n\n# 3. Launch interactive mode\nprprompts interactive\n\n# 4. Or use new commands directly\nprprompts validate-keys      # Check API keys\nprprompts rate-status        # View usage\nprprompts history            # Browse history\n\n# 5. Verify multi-AI parity (all should show 21 commands)\nqwen /help                   # Qwen Code\ngemini /help                 # Gemini CLI\nclaude /help                 # Claude Code\n```\n\n### 📋 Complete v5.0.0 Command Reference (21 Commands + 8 Skills + React-to-Flutter)\n\n<table>\n<tr>\n<th>Category</th>\n<th>Command</th>\n<th>Description</th>\n</tr>\n<tr>\n<td rowspan=\"3\"><b>Interactive</b></td>\n<td><code>prprompts interactive</code></td>\n<td>Launch menu-driven interface</td>\n</tr>\n<tr>\n<td><code>prprompts history</code></td>\n<td>Browse command history</td>\n</tr>\n<tr>\n<td><code>prprompts history-search [query]</code></td>\n<td>Search command history</td>\n</tr>\n<tr>\n<td rowspan=\"3\"><b>API Management</b></td>\n<td><code>prprompts validate-keys</code></td>\n<td>Validate all API keys</td>\n</tr>\n<tr>\n<td><code>prprompts setup-keys [ai]</code></td>\n<td>Interactive API key setup</td>\n</tr>\n<tr>\n<td><code>prprompts rate-status</code></td>\n<td>Check rate limit usage</td>\n</tr>\n<tr>\n<td rowspan=\"6\"><b>Automation</b></td>\n<td><code>prprompts auto-status</code></td>\n<td>Show automation progress</td>\n</tr>\n<tr>\n<td><code>prprompts auto-validate</code></td>\n<td>Validate code quality</td>\n</tr>\n<tr>\n<td><code>prprompts auto-bootstrap</code></td>\n<td>Bootstrap project structure</td>\n</tr>\n<tr>\n<td><code>prprompts auto-implement N</code></td>\n<td>Implement N features</td>\n</tr>\n<tr>\n<td><code>prprompts auto-test</code></td>\n<td>Run tests with coverage</td>\n</tr>\n<tr>\n<td><code>prprompts auto-reset</code></td>\n<td>Reset automation state</td>\n</tr>\n</table>\n\n### 🔧 Environment Variables (v4.1)\n\n```bash\n# Core Configuration\nexport PRPROMPTS_DEFAULT_AI=claude    # Default AI (claude/qwen/gemini)\nexport PRPROMPTS_VERBOSE=true         # Verbose output\nexport PRPROMPTS_TIMEOUT=300000       # Command timeout (ms)\nexport PRPROMPTS_RETRY_COUNT=5        # Retry attempts\n\n# API Keys\nexport CLAUDE_API_KEY=sk-ant-...      # Claude API key\nexport GEMINI_API_KEY=AIzaSy...       # Gemini API key\nexport QWEN_API_KEY=...                # Qwen API key\n\n# Rate Limiting Tiers\nexport CLAUDE_TIER=pro                 # free/starter/pro\nexport GEMINI_TIER=free                # free/pro\nexport QWEN_TIER=plus                  # free/plus/pro\n```\n\n### 📊 v4.1 Impact Metrics\n\n| Feature | Before v4.1 | After v4.1 | Improvement |\n|---------|------------|------------|-------------|\n| **API Setup** | Manual config files | Interactive wizard | 5x easier |\n| **Rate Limits** | Hit 429 errors | Smart prevention | 0 blocks |\n| **Command Discovery** | Read docs | Interactive menus | 10x faster |\n| **Progress Visibility** | Text only | Visual indicators | Clear ETA |\n| **Command Memory** | None | Full history | 100% recall |\n| **Error Recovery** | Manual retry | Auto retry 3x | 70% fewer fails |\n| **Test Coverage** | 60% | 85% | +41% quality |\n\n---\n\n## 📊 At a Glance\n\n<table>\n<tr>\n<td width=\"33%\" align=\"center\">\n\n### 🎮 Interactive Mode (v4.1)\nMenu-driven interface<br/>No command memorization\n\n</td>\n<td width=\"33%\" align=\"center\">\n\n### 32 Files Generated\nComplete development guides<br/>covering all aspects\n\n</td>\n<td width=\"33%\" align=\"center\">\n\n### 3 AI Assistants\nClaude • Qwen • Gemini<br/>With API validation\n\n</td>\n</tr>\n<tr>\n<td width=\"33%\" align=\"center\">\n\n### 6 Compliance Standards\nHIPAA • PCI-DSS • GDPR<br/>SOC2 • COPPA • FERPA\n\n</td>\n<td width=\"33%\" align=\"center\">\n\n### 13+ New Commands\nInteractive • Validation • History<br/>Rate Limiting • Progress\n\n</td>\n<td width=\"33%\" align=\"center\">\n\n### 3 Platforms\nWind",
  "bytes": 60000,
  "sha": "99f5d1f8863b3114b69dedb895d4f31a0bd5ea9da54d74207f1715b9c9cccecb",
  "repo_slug": "kandil7/prprompts-flutter-generator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_kandil7_prprompts_flutter_generator_8383a701/readme"
}