prprompts-flutter-generator

AI-powered Flutter development with full automation + React-to-Flutter refactoring - Generate 32 security-audited guides & auto-implement in
Open source Open in the app JSON README (API)
About

AI-powered Flutter development with full automation + React-to-Flutter refactoring - Generate 32 security-audited guides & auto-implement in 2-3 hours (40-60x faster). Convert React/React Native apps to Flutter with intelligent hooks, JSX patterns, and style conversion.
Details

Kind: Plugins
Topic: No topic detected
Publisher: kandil7
Origin: gemini
Category: ferramentas
Version: 5.2.0
Stars: 11
Forks: 3
Last push: 2025-11-27T20:21:32Z
Repository state: ativo
Language: JavaScript
License: MIT
Added: 2026-08-30 14:13:39
Updated: 2026-08-30 14:13:39
Origin id: kandil7/prprompts-flutter-generator
README

# PRD-to-PRPROMPTS Generator

<div align="center">

[![npm version](https://img.shields.io/npm/v/prprompts-flutter-generator.svg)](https://www.npmjs.com/package/prprompts-flutter-generator)
[![npm downloads](https://img.shields.io/npm/dt/prprompts-flutter-generator.svg)](https://www.npmjs.com/package/prprompts-flutter-generator)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/Version-5.1.3-brightgreen)](CHANGELOG.md)
[![Status](https://img.shields.io/badge/Status-Production-brightgreen)](CHANGELOG.md#513)
[![PRD Methods](https://img.shields.io/badge/PRD%20Methods-6-brightgreen)](#creating-your-prd)
[![PRPROMPTS](https://img.shields.io/badge/PRPROMPTS-32%20Files-orange)](#what-gets-generated)
[![Commands](https://img.shields.io/badge/Commands-23%20Total-blue)](#available-commands)
[![Security](https://img.shields.io/badge/Security-HIPAA%20%7C%20PCI--DSS%20%7C%20GDPR-red)](#security--compliance)
[![New](https://img.shields.io/badge/NEW-v5.1%20Official%20Extensions-purple)](#-new-in-v510-official-ai-extension-support)
[![Speed](https://img.shields.io/badge/Speed-40--60x%20Faster-green)](#v40-full-automation-new)

[![Claude Code](https://img.shields.io/badge/Claude_Code-Extension-blue)](CLAUDE.md)
[![Qwen Code](https://img.shields.io/badge/Qwen_Code-Extension-orange)](QWEN.md)
[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-Extension-green)](GEMINI.md)
[![Flutter](https://img.shields.io/badge/Flutter-3.24+-blue)](https://flutter.dev)

[![Windows](https://img.shields.io/badge/Windows-Supported-0078D6?logo=windows)](docs/installation/WINDOWS-QUICKSTART.md)
[![macOS](https://img.shields.io/badge/macOS-Supported-000000?logo=apple)](docs/installation/MACOS-QUICKSTART.md)
[![Linux](https://img.shields.io/badge/Linux-Supported-FCC624?logo=linux&logoColor=black)](#system-requirements)
[![Cross-Platform](https://img.shields.io/badge/Cross--Platform-PowerShell%20%7C%20CMD%20%7C%20Bash%20%7C%20WSL-blue)](#platform-specific-notes)

</div>

---

## 🎉 NEW IN v5.1: Official AI Extension Support

**Production Ready!** v5.1 delivers official extension support for all three AI platforms with native integration, hooks automation, and TOML command format.

### ✨ v5.1.3 Latest Improvements

- ✅ **Perfect Multi-AI Integration** - All 23 commands synchronized across Claude, Qwen, and Gemini
- ✅ **Automated Version Sync** - `npm run sync-versions` keeps all manifests aligned
- ✅ **Universal Installer** - One-command setup for all AIs with progress bars
- ✅ **Integration Testing** - 32 comprehensive tests ensure quality
- ✅ **Enhanced Manifests** - Professional metadata, benchmarks, and capabilities

### ✨ What's New

**1. Claude Code Official Plugin**
- ✅ Official plugin manifest (`.claude-plugin/plugin.json`)
- ✅ Hooks automation system (4 event types)
- ✅ Auto-formatting with `dart format` after every edit
- ✅ Quality gates prompt (analyze, test, commit)
- ✅ Flutter SDK verification at session start
- ✅ Activity logging for analytics

**2. Gemini CLI TOML Commands**
- ✅ All 23 commands in native TOML format
- ✅ Context file (`GEMINI.md`) for AI understanding
- ✅ Enhanced extension manifest with settings
- ✅ Inline command arguments support

**3. Qwen Code MCP Configuration**
- ✅ Optional MCP server settings (`settings.json`)
- ✅ OAuth support configuration
- ✅ Feature toggles for automation
- ✅ Flutter/Dart SDK path settings

### 🚀 Installation

```bash
# Install from npm (auto-detects all AIs)
npm install -g prprompts-flutter-generator

# What gets installed:
# - Claude Code → Plugin + Hooks + 23 Commands
# - Gemini CLI → TOML Commands + Context + Extension
# - Qwen Code → Commands + Settings + MCP Config

# Verify installation
prprompts doctor
```

### 🎯 Benefits

✅ **Native Integration** - No manual configuration needed
✅ **Auto-Format** - Dart code formatted automatically (Claude)
✅ **Quality Gates** - Prompted to run tests before committing
✅ **Environment Checks** - Flutter SDK verified at startup
✅ **Discoverable** - All commands visible in `/help`
✅ **Official Distribution** - Install via package managers

---

## 🤖 AI Platform Comparison Matrix

Choose the best AI assistant for your needs:

<div align="center">

| Feature | Claude Code | Qwen Code | Gemini CLI |
|---------|------------|-----------|------------|
| **Version** | v5.1.2 | v5.1.2 | v5.1.2 |
| **Commands** | ✅ 23 | ✅ 23 | ✅ 23 |
| **Context Window** | 200K tokens | 256K-1M tokens | 1M tokens |
| **Slash Commands** | ✅ Native (`/command`) | ✅ Native (`:command`) | ✅ Native (`:command`) |
| **TOML Commands** | ❌ | ✅ 31 files | ✅ 31 files |
| **Plugin Support** | ✅ Official Plugin | ✅ Extension | ✅ Extension |
| **Hooks Automation** | ✅ 4 event types | ❌ | ❌ |
| **Skills System** | ✅ 17 skills | ✅ 15 skills | ✅ 15 skills |
| **Auto-formatting** | ✅ Dart format on save | ❌ | ❌ |
| **MCP Settings** | ❌ | ✅ Full MCP config | ❌ |
| **ReAct Agent Mode** | ❌ | ❌ | ✅ Native |
| **Cost** | $$$ | $ (Free tier) | $$ |
| **Best For** | Premium features, hooks | Large codebases, cost-effective | 1M context, ReAct mode |

</div>

### 🎯 Platform-Specific Advantages

**Claude Code:**
- ✅ Official plugin with automatic updates
- ✅ Hooks for workflow automation (auto-format, quality checks)
- ✅ Premium model accuracy
- ✅ Best documentation and support

**Qwen Code:**
- ✅ Extended context (up to 1M tokens) for monorepos
- ✅ Free tier available
- ✅ MCP configuration for advanced settings
- ✅ Open source and community-driven

**Gemini CLI:**
- ✅ Largest context window (1M tokens)
- ✅ ReAct agent mode for complex reasoning
- ✅ Native TOML command integration
- ✅ Google ecosystem integration

### 📦 Installation

All platforms support the same npm installation:

```bash
# Install PRPROMPTS (works for all AIs)
npm install -g prprompts-flutter-generator

# NEW: Universal installer for all detected AIs
bash install-all-extensions.sh

# Or install for specific AI
bash install-claude-extension.sh
bash install-qwen-extension.sh
bash install-gemini-extension.sh

# Verify installation
prprompts doctor

# Commands automatically available in your AI:
# Claude: /create-prd, /generate-all, /bootstrap
# Qwen: :create-prd, :generate-all, :bootstrap
# Gemini: :create-prd, :generate-all, :bootstrap
```

---

## 🔄 v5.0 Feature: Complete React-to-Flutter Refactoring

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

### 🚀 Quick Start - Convert in 3 Commands

```bash
# 1. Install
npm install -g prprompts-flutter-generator

# 2. Convert your React app to Flutter
prprompts refactor ./my-react-app ./my-flutter-app --state-mgmt bloc --ai claude

# 3. Done! You get:
# ✅ Complete Flutter project with Clean Architecture
# ✅ All styles converted (CSS → Flutter)
# ✅ All hooks converted (useState → state, useEffect → lifecycle)
# ✅ All patterns converted (HOCs → mixins, React.memo → const)
# ✅ BLoC state management with events/states
# ✅ Comprehensive validation report
# ✅ AI-enhanced code (optional)
```

### 🎯 Slash Commands (UPDATED in v5.0.6)

Run refactoring commands directly in your AI assistant chat:

```bash
# Claude Code (use forward slash)
claude
/refactoring/convert-react-to-flutter
/refactoring/validate-flutter

# Qwen Code (use colon separator)
qwen
/refactoring:convert-react-to-flutter
/refactoring:validate-flutter

# Gemini CLI (use colon separator)
gemini
/refactoring:convert-react-to-flutter
/refactoring:validate-flutter

# Or use the unified CLI from terminal
prprompts refactor ./my-react-app ./my-flutter-app
```

**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`.

### 🔄 What Gets Converted

<table>
<tr>
<th>React/React Native</th>
<th>→</th>
<th>Flutter</th>
</tr>
<tr>
<td>

```jsx
const Counter = () => {
  const [count, setCount] = useState(0);

  useEffect(() => {
    console.log('Count:', count);
    return () => cleanup();
  }, [count]);

  return (
    <View style={styles.container}>
      <Text style={styles.title}>
        Count: {count}
      </Text>
      <TouchableOpacity
        onPress={() => setCount(count + 1)}
      >
        <Text>Increment</Text>
      </TouchableOpacity>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    padding: 20,
    backgroundColor: '#f5f5f5'
  },
  title: {
    fontSize: 24,
    fontWeight: 'bold',
    color: '#333'
  }
});
```

</td>
<td>⚡</td>
<td>

```dart
class Counter extends StatefulWidget {
  @override
  _CounterState createState() => _CounterState();
}

class _CounterState extends State<Counter> {
  int count = 0;

  @override
  void didUpdateWidget(Counter oldWidget) {
    super.didUpdateWidget(oldWidget);
    print('Count: $count');
  }

  @override
  void dispose() {
    cleanup();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Container(
      decoration: BoxDecoration(
        color: Color(0xFFF5F5F5),
      ),
      padding: EdgeInsets.all(20),
      child: Column(
        children: [
          Text(
            'Count: $count',
            style: TextStyle(
              fontSize: 24,
              fontWeight: FontWeight.bold,
              color: Color(0xFF333333),
            ),
          ),
          GestureDetector(
            onTap: () => setState(() => count++),
            child: Text('Increment'),
          ),
        ],
      ),
    );
  }
}
```

</td>
</tr>
</table>

### ✨ Complete Feature Set

<details>
<summary><strong>🎨 Intelligent Style Conversion</strong> (780 lines, 100% tested)</summary>

- **CSS → Flutter Transformation**
  - Colors: hex/rgb/rgba → `Color(0xFFRRGGBB)`
  - Layouts: flexbox → `Row`/`Column`/`Flex`
  - Borders: CSS borders → `BoxDecoration.border`
  - Shadows: box-shadow → `BoxShadow`
  - Gradients: linear/radial → `LinearGradient`/`RadialGradient`
  - Typography: font styles → `TextStyle`
  - Responsive: media queries → `MediaQuery`

**Example:**
```css
/* React CSS */
.button {
  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
  box-shadow: 0 10px 20px rgba(0,0,0,0.2);
  border-radius: 8px;
  padding: 16px 32px;
}
```
```dart
// Flutter Output
decoration: BoxDecoration(
  gradient: LinearGradient(
    begin: Alignment.topLeft,
    end: Alignment.bottomRight,
    colors: [Color(0xFF667EEA), Color(0xFF764BA2)],
  ),
  boxShadow: [
    BoxShadow(
      color: Color(0x33000000),
      offset: Offset(0, 10),
      blurRadius: 20,
    ),
  ],
  borderRadius: BorderRadius.circular(8),
),
padding: EdgeInsets.symmetric(horizontal: 32, vertical: 16),
```
</details>

<details>
<summary><strong>🪝 Complete Hooks Conversion</strong> (780 lines, 38 tests)</summary>

- **useState** → StatefulWidget state management
- **useEffect** → Lifecycle methods (initState, dispose, didUpdateWidget)
- **useContext** → Provider pattern integration
- **useReducer** → BLoC pattern transformation
- **useRef** → Controllers and GlobalKey
- **useMemo/useCallback** → Widget caching strategies
- **Custom hooks** → Mixins with shared logic

**Example:**
```jsx
// React Hook
const useAuth = () => {
  const [user, setUser] = useState(null);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    fetchUser().then(u => {
      setUser(u);
      setLoading(false);
    });
  }, []);

  return { user, loading };
};
```
```dart
// Flutter Mixin
mixin AuthMixin<T extends StatefulWidget> on State<T> {
  User? user;
  bool loading = true;

  @override
  void initState() {
    super.initState();
    fetchUser().then((u) {
      if (mounted) {
        setState(() {
          user = u;
          loading = false;
        });
      }
    });
  }
}
```
</details>

<details>
<summary><strong>🎭 Advanced JSX Pattern Conversion</strong> (655 lines, 29 tests)</summary>

- **Higher-Order Components (HOCs)** → Mixins
- **React.memo** → const constructors (performance optimization)
- **forwardRef** → GlobalKey pattern
- **Render props** → Builder widgets
- **Fragments** → Column/Row
- **Lists** → ListView.builder with keys
- **Conditional rendering** → Ternary operators
- **Dynamic children** → Builder patterns

**Example:**
```jsx
// React HOC
const withAuth = (Component) => {
  return (props) => {
    const { user } = useAuth();
    if (!user) return <Login />;
    return <Component {...props} user={user} />;
  };
};
```
```dart
// Flutter Mixin
mixin WithAuthMixin<T extends StatefulWidget> on State<T> {
  User? user;

  @override
  Widget build(BuildContext context) {
    if (user == null) return Login();
    return buildAuthenticated(context);
  }

  Widget buildAuthenticated(BuildContext context);
}
```
</details>

<details>
<summary><strong>🏗️ Clean Architecture Generation</strong></summary>

Automatically generates complete Clean Architecture structure:

```
lib/
├── domain/
│   ├── entities/
│   ├── repositories/
│   └── usecases/
├── data/
│   ├── datasources/
│   ├── models/
│   └── repositories/
└── presentation/
    ├── bloc/
    ├── pages/
    └── widgets/
```

- **Domain Layer**: Pure business logic (entities, use cases)
- **Data Layer**: Repository implementations, data sources
- **Presentation Layer**: UI components, state management
- **Dependency Injection**: GetIt setup with proper scoping
</details>

<details>
<summary><strong>📊 BLoC State Management</strong></summary>

Full BLoC/Cubit generation with events and states:

```dart
// Auto-generated BLoC
class CounterBloc extends Bloc<CounterEvent, CounterState> {
  CounterBloc() : super(CounterInitial()) {
    on<IncrementEvent>(_onIncrement);
    on<DecrementEvent>(_onDecrement);
  }

  void _onIncrement(IncrementEvent event, Emitter<CounterState> emit) {
    emit(CounterUpdated(count: state.count + 1));
  }
}

// Auto-generated Events
abstract class CounterEvent {}
class IncrementEvent extends CounterEvent {}

// Auto-generated States
abstract class CounterState {
  final int count;
  CounterState({required this.count});
}
```
</details>

<details>
<summary><strong>🤖 AI Enhancement Layer</strong></summary>

Optional AI-powered code optimization (Claude/Qwen/Gemini):

- **Code Quality**: Refactoring suggestions
- **Performance**: Optimization recommendations
- **Best Practices**: Flutter idioms and patterns
- **Security**: Vulnerability detection
- **Accessibility**: A11y improvements

```bash
# Enable AI enhancement
prprompts refactor ./my-app ./flutter-app --ai claude --enhance
```
</details>

<details>
<summary><strong>✅ Comprehensive Validation</strong></summary>

5 specialized validators with detailed reports:

1. **Code Validator**: Syntax, imports, unused code
2. **Architecture Validator**: Layer separation, dependencies
3. **Security Validator**: Vulnerabilities, best practices
4. **Performance Validator**: Widget rebuilds, memory leaks
5. **Accessibility Validator**: Semantics, contrast, focus

Output: `VALIDATION_REPORT.md` with actionable recommendations
</details>

### 📊 Quality Metrics

- **Test Coverage:** 623/691 passing (90%)
- **Core Modules:** 100% coverage (hooks, JSX, styles)
- **Performance:** <50ms per component conversion
- **Zero Critical Bugs**
- **Production Ready:** ✅

### 📚 Complete Documentation

- **[React-to-Flutter Guide](REACT_TO_FLUTTER_GUIDE.md)** - 860-line comprehensive guide with examples, troubleshooting, FAQ
- **[Architecture Documentation](ARCHITECTURE.md)** - Deep dive into refactoring system design
- **[Development Guide](DEVELOPMENT.md)** - Contributing to the refactoring system

### 🎯 Real-World Use Cases

**Healthcare App (React Native → Flutter)**
- Converted 15 components, 3,000 lines of code
- HIPAA compliance maintained
- Performance improved by 40%
- Bundle size reduced by 60%

**E-Commerce App (React → Flutter)**
- Converted 25 components, 5,000 lines of code
- Shopping cart, checkout, payment flow
- Integrated with Stripe (PCI-DSS compliant)
- 85% test coverage achieved

**🚀 Ready for production!** Convert your React apps to Flutter with confidence.

---

## 🌍 v5.2 Feature: Flutter App Localization

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

### 🚀 Quick Start - Localize in One Command

```bash
# Navigate to your Flutter project
cd your-flutter-project

# Run localization command
gemini localize

# Or use CLI directly
gemini-localize

# With AI translation
gemini-localize --ai gemini

# Multi-language
gemini-localize --languages en,ar,fr
```

### ✨ What You Get

**Generated Files:**
```
lib/l10n/
├── app_en.arb              # English master template
├── app_ar.arb              # Arabic translations  
└── integration_guide.md   # Step-by-step setup
l10n.yaml                   # Flutter l10n config
pubspec.yaml                # Updated dependencies
```

**Features:**
- ✅ **Automatic String Extraction**: Scans all `.dart` files for hardcoded strings
- ✅ **ARB File Generation**: Creates master template and target language files
- ✅ **ICU MessageFormat**: Handles plurals, placeholders, and string interpolation
- ✅ **RTL Support**: Configures Right-to-Left layout for Arabic
- ✅ **AI Translation**: Optional AI-powered Arabic translations
- ✅ **Validation**: Comprehensive validation of ARB files and configuration
- ✅ **Integration Guide**: Auto-generated step-by-step instructions

### 🎯 Example Conversion

<table>
<tr>
<th>Before (Hardcoded)</th>
<th>→</th>
<th>After (Localized)</th>
</tr>
<tr>
<td>

```dart
// main.dart
Text('Welcome to App')
AppBar(title: Text('Home'))
TextField(hintText: 'Enter email')
```

</td>
<td>⚡</td>
<td>

```dart
// Generated ARB files
// lib/l10n/app_en.arb
{
  "@@locale": "en",
  "welcomeMessage": "Welcome to App",
  "titleHome": "Home",
  "hintEnterEmail": "Enter email"
}

// lib/l10n/app_ar.arb
{
  "@@locale": "ar",
  "textDirection": "rtl",
  "welcomeMessage": "مرحباً بك في التطبيق",
  "titleHome": "الرئيسية",
  "hintEnterEmail": "أدخل البريد الإلكتروني"
}
```

</td>
</tr>
</table>

### 🌍 Complete Feature Set

<details>
<summary><strong>📖 Automatic String Extraction</strong></summary>

Scans your entire Flutter project for hardcoded strings in:
- `Text()` widgets
- `AppBar(title:)` 
- `TextField(hintText:, labelText:)`
- `ElevatedButton(child:)`
- `AlertDialog()` messages
- `SnackBar()` content

**String Interpolation Handling:**
```dart
// Dart code:
Text('Hello $userName')  
Text('Total: ${cart.total}')

// Generated ARB:
"greeting": "Hello {userName}",
"totalAmount": "Total: {total}"
```

**Generates semantic camelCase keys:**
- "Welcome to App" → `welcomeToApp`
- "Enter email" → `hintEnterEmail`  
- "Login Button" → `buttonLogin`

</details>

<details>
<summary><strong>📝 ARB File Generation</strong></summary>

Creates proper Application Resource Bundle files with:

**Master Template (app_en.arb):**
- All extracted strings
- Metadata for translators
- Placeholder definitions with types
- ICU MessageFormat for plurals

**Target Language (app_ar.arb):**
- Arabic translations (AI-powered optional)
- RTL text direction indicator
- Proper Arabic typography
- ICU plural forms for Arabic

**Example:**
```json
{
  "@@locale": "en",
  "welcomeMessage": "Welcome, {userName}!",
  "@welcomeMessage": {
    "description": "Personalized greeting on home screen",
    "placeholders": {
      "userName": {
        "type": "String",
        "example": "Ahmed"
      }
    }
  },
  "itemCount": "{count, plural, =0{No items} =1{One item} other{{count} items}}"
}
```

</details>

<details>
<summary><strong>🔄 ICU MessageFormat Support</strong></summary>

Full support for complex localization patterns:

**Plurals:**
```json
"itemCount": "{count, plural, =0{لا توجد عناصر} =1{عنصر واحد} other{{count} عناصر}}"
```

**Gender:**
```json
"greeting": "{gender, select, male{مرحباً} female{مرحباً} other{مرحباً}}"
```

**Placeholders with Types:**
- `String` - Text values
- `int` - Integer counts
- `double` - Decimal numbers
- `DateTime` - Date/time values

</details>

<details>
<summary><strong>↔️ RTL Layout Configuration</strong></summary>

Automatic RTL (Right-to-Left) setup for Arabic:

**Generated Integration Guide includes:**
- MaterialApp RTL configuration
- EdgeInsetsDirectional usage
- Directionality handling
- Common RTL mistakes to avoid

**Best Practices:**
```dart
// ✅ DO:
EdgeInsetsDirectional.only(start: 16)  // Adapts to RTL
Directionality.of(context)              // Uses locale direction

// ❌ DON'T:
EdgeInsets.only(left: 16)  // Hardcoded LTR
TextDirection.ltr          // Ignores locale
```

**Arabic Typography:**
- Font configuration guidance
- Proper line height (1.5+)
- Diacritic support
- Regional variations (Gulf, Egyptian, Levantine)

</details>

<details>
<summary><strong>🤖 AI-Powered Translation</strong></summary>

Optional AI translation with Gemini, Claude, or Qwen:

```bash
gemini-localize --ai gemini
```

**AI Translation Features:**
- Context-aware translations
- Placeholder preservation
- Culturally appropriate phrasing
- ICU MessageFormat handling
- Batch translation for efficiency

**Quality:**
- Natural, native-sounding Arabic
- Proper grammar and diacritics
- Mobile UI optimized (concise)
- RTL context aware

</details>

<details>
<summary><strong>✅ Comprehensive Validation</strong></summary>

8 validation checks ensure quality:
1. ✅ ARB files are valid JSON
2. ✅ All keys in master exist in all languages
3. ✅ ICU MessageFormat syntax correct
4. ✅ Placeholder types match across files
5. ✅ `@@locale` keys present and correct
6. ✅ `l10n.yaml` is valid YAML
7. ✅ `pubspec.yaml` has required dependencies
8. ✅ `flutter.generate = true` in pubspec

**Output:**
```
✅ Validation: All checks passed (2 warnings)

⚠️  Warnings:
  1. Consider native speaker review for Arabic
  2. Test RTL layout on real device
```

</details>

### 📊 Command Options

```bash
Usage: gemini-localize [options]

Options:
  -l, --languages <codes>   Comma-separated language codes (default: "en,ar")
  --ai <provider>           AI provider (gemini|claude|qwen|none)
  --dry-run                 Preview without writing files
  --validate                Run validation (default: true)
  -v, --verbose             Verbose logging
  -o, --output-dir <path>   ARB output directory (default: "lib/l10n")
  -h, --help                Display help

Examples:
  gemini-localize                        # en-ar localization
  gemini-localize --languages en,ar,fr   # Add French
  gemini-localize --ai gemini            # AI-powered translation
  gemini-localize --dry-run              # Preview only
```

### 🎯 Real-World Example

**Healthcare App Localization:**
- Extracted 47 strings from 12 files
- Generated ar-en ARB files
- AI-translated with cultural sensitivity
- RTL layout tested on real device
- HIPAA compliance maintained
- **Time:** < 2 minutes

### 🚀 Usage Workflow

1. **Run Localization:**
   ```bash
   gemini-localize
   ```

2. **Generated Files:**
   - `lib/l10n/app_en.arb` - Master template
   - `lib/l10n/app_ar.arb` - Arabic translations
   - `l10n.yaml` - Configuration
   - `lib/l10n/integration_guide.md` - Instructions

3. **Generate Flutter Code:**
   ```bash
   flutter pub get
   flutter gen-l10n
   ```

4. **Update MaterialApp:**
   ```dart
   import 'package:flutter_localizations/flutter_localizations.dart';
   import 'package:flutter_gen/gen_l10n/app_localizations.dart';

   MaterialApp(
     localizationsDelegates: [
       AppLocalizations.delegate,
       GlobalMaterialLocalizations.delegate,
       GlobalWidgetsLocalizations.delegate,
       GlobalCupertinoLocalizations.delegate,
     ],
     supportedLocales: [
       Locale('en'),
       Locale('ar'),
     ],
   )
   ```

5. **Use Localized Strings:**
   ```dart
   Text(AppLocalizations.of(context)!.welcomeMessage)
   ```

### 📚 Documentation

- **[Complete Localization Guide](docs/LOCALIZATION.md)** - Full feature documentation
- **[Implementation Summary](LOCALIZATION-IMPLEMENTATION.md)** - Technical details
- **[Examples](examples/localization/)** - Sample ARB files

### 🎯 Benefits

✅ **Zero Manual Work** - Fully automated string extraction  
✅ **RTL Ready** - Complete Arabic layout support  
✅ **AI Enhanced** - Optional AI-powered translation  
✅ **Production Quality** - Comprehensive validation  
✅ **Time Saved** - 2 minutes vs 2-3 hours manual  
✅ **Best Practices** - Follows Flutter i18n guidelines  

**🌍 Ready to localize your Flutter app!** Support multiple languages with one command.

---

## 📑 Table of Contents

<details>
<summary><strong>Click to expand</strong></summary>

- [Quick Start](#one-command-complete-setup)
  - [Quick Reference Card](#quick-reference-card)
  - [Visual Workflow](#how-it-works---visual-workflow)
- [System Requirements](#system-requirements)
  - [Software Requirements](#software-requirements)
  - [Hardware Requirements](#hardware-requirements)
  - [Platform-Specific Notes](#platform-specific-notes)
  - [Recent Improvements](#recent-cross-platform-improvements-v410)
- [Configure AI Providers](#configure-ai-providers)
- [Features](#features)
  - [v4.4 Slash Commands](#v44-slash-commands-new)
  - [v4.1 Enterprise Features](#v41-enterprise-features-new)
  - [v4.0 Full Automation](#v40-full-automation-new)
  - [v3.0 Features](#v30-new-features)
- [What Gets Generated](#what-gets-generated)
- [Creating Your PRD](#creating-your-prd)
- [Security & Compliance](#security--compliance)
- [Quick Troubleshooting](#quick-troubleshooting)
- [FAQ](#faq)
- [Documentation](#documentation)
- [Contributing](#contributing)
- [Roadmap](#roadmap)
- [Support & Community](#support--community)
- [Changelog](#changelog)

</details>

---

<div align="center">

## **Transform Your PRD into 32 Secure, Production-Ready Development Guides**

**Enterprise-grade Flutter development automation with slash commands, interactive mode, API validation, rate limiting, and intelligent command management.**

**⏱️ Setup: 30 seconds** • **🔄 NEW v5.0: React→Flutter** • **💬 v4.4: Slash Commands** • **🎮 v4.1: Interactive Mode** • **⚡ 40-60x Faster** • **🔒 Security Audited**

</div>

<div align="center">

### **🚀 One Command. Complete Setup.**

**🆕 v5.0.0 - Production-Ready React-to-Flutter Conversion + Perfect Multi-AI Parity!**
```bash
# Install via npm (works on Windows/macOS/Linux)
npm install -g prprompts-flutter-generator

# ALL 21 commands now work identically across all 3 AIs!
prprompts interactive  # Launch interactive mode!
prprompts create       # Create PRD
prprompts generate     # Generate all 32 files

# Or use slash commands in AI chat (29 total: 21 commands + 8 skills):
/prd:create            # Create PRD in-chat
/prprompts:generate-all # Generate all 32 files in-chat
/automation:bootstrap  # Complete project setup (2 min)
```

**✨ NEW v5.0.0: Complete React-to-Flutter refactoring system with production-ready conversion!**
**✨ v4.4: Slash commands for in-chat usage + TOML auto-generation for perfect parity!**
**✨ v4.1: Interactive mode, API validation, rate limiting, progress indicators, and command history!**

### 📊 How It Works - Visual Workflow

```mermaid
graph LR
    A[📝 PRD Document] -->|60 seconds| B[32 PRPROMPTS Files]
    B -->|Instant| C[🤖 AI Assistant]
    C -->|1-2 hours| D[✅ Flutter Code]
    D -->|Ready| E[🚀 Production App]

    style A fill:#e1f5ff
    style B fill:#fff9c4
    style C fill:#f3e5f5
    style D fill:#e8f5e9
    style E fill:#c8e6c9
```

<table>
<tr>
<td align="center" width="20%"><strong>📝 PRD</strong><br/>Your requirements<br/><code>60 sec</code></td>
<td align="center" width="5%">→</td>
<td align="center" width="20%"><strong>📚 PRPROMPTS</strong><br/>32 secure guides<br/><code>Instant</code></td>
<td align="center" width="5%">→</td>
<td align="center" width="20%"><strong>🤖 AI Code</strong><br/>Auto-implementation<br/><code>1-2 hours</code></td>
<td align="center" width="5%">→</td>
<td align="center" width="20%"><strong>🚀 Production</strong><br/>Ready to deploy<br/><code>Done!</code></td>
</tr>
<tr>
<td colspan="7" align="center">
<strong>Total Time: 2-3 hours</strong> (vs 3-5 days manual) = <strong>40-60x faster!</strong>
</td>
</tr>
</table>

**⚠️ Permissions Note:**
- **Windows:** No special permissions required (npm installs to your user directory)
- **macOS/Linux:** Use one of these methods to avoid sudo:
  - **Recommended:** Use [nvm](https://github.com/nvm-sh/nvm) (Node Version Manager)
  - **Alternative:** Configure npm for user-level installations (see [docs/installation/MACOS-QUICKSTART.md](docs/installation/MACOS-QUICKSTART.md#permission-denied-or-eacces-errors))
  - **Not recommended:** Using `sudo npm install -g` can cause permission issues later

**Alternative Methods:**

**Windows PowerShell:**
```powershell
irm https://raw.githubusercontent.com/Kandil7/prprompts-flutter-generator/master/scripts/setup-gist.ps1 | iex
```

**Linux / macOS / Git Bash:**
```bash
curl -sSL https://raw.githubusercontent.com/Kandil7/prprompts-flutter-generator/master/scripts/smart-install.sh | bash
```

**📌 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)

[📦 Quick Install](#installation) • [🪟 Windows Guide](docs/installation/WINDOWS-QUICKSTART.md) • [✨ v4.1 Features](#v41-enterprise-features-new) • [📖 Docs](docs/PRPROMPTS-SPECIFICATION.md)

</div>

---

## ⚡ Quick Reference Card

<div align="center">

**One-Liner Install:**
```bash
npm install -g prprompts-flutter-generator && prprompts interactive
```

</div>

<table>
<tr>
<td width="50%">

### 🚀 Essential Commands

```bash
# Core workflow
prprompts create         # Create PRD
prprompts generate       # Generate 32 files
prprompts interactive    # Launch menu UI

# Diagnostics
prprompts doctor         # Check setup
prprompts validate-keys  # Validate APIs
prprompts rate-status    # Check limits
```

</td>
<td width="50%">

### 🔗 Quick Links

**Setup Guides:**
- [Windows](docs/installation/WINDOWS-QUICKSTART.md) 🪟
- [macOS](docs/installation/MACOS-QUICKSTART.md) 🍎
- [Troubleshooting](docs/TROUBLESHOOTING.md) 🔧

**AI Guides:**
- [Claude](docs/CLAUDE-USER-GUIDE.md)
- [Qwen](QWEN.md)
- [Gemini](GEMINI.md)

</td>
</tr>
<tr>
<td colspan="2">

### 🎯 Complete Workflow (2-3 hours)

```bash
# 1️⃣ Setup (30 seconds)
npm install -g prprompts-flutter-generator
prprompts setup-keys claude

# 2️⃣ Generate PRPROMPTS (60 seconds)
cd your-flutter-project
prprompts create && prprompts generate

# 3️⃣ Automate Development (1-2 hours)
claude                                    # Start AI
/automation/bootstrap                     # Setup project (2 min)
/automation/full-cycle                    # Implement features (1-2 hours)
# Input: 10 features

# 4️⃣ Quality Check (2 minutes)
/automation/qa-check                      # Compliance audit

# ✅ Result: Production-ready app with 70%+ test coverage!
```

</td>
</tr>
</table>

---

## 📋 System Requirements

<div align="center">

### Software Requirements

| Component | Minimum | Recommended | Notes |
|-----------|---------|-------------|-------|
| **Node.js** | v20.0.0 | v20 LTS (20.11.0+) | LTS recommended • [Download](https://nodejs.org) |
| **npm** | v9.0.0 | v10.0.0+ | Included with Node.js |
| **Operating System** | Windows 10, macOS 10.15, Ubuntu 20.04 | Windows 11, macOS 14+, Latest LTS | Full cross-platform support |
| **Shell** | Any | PowerShell 7+ / zsh | PowerShell, CMD, Git Bash, bash, zsh, WSL all supported |
| **AI CLI** | Any one | Claude Code | At least one: Claude Code, Qwen Code, or Gemini CLI |
| **Flutter** | 3.24+ | 3.27+ | For development only (not required for PRPROMPTS generation) |

### Hardware Requirements

| Resource | Minimum | Recommended | Notes |
|----------|---------|-------------|-------|
| **RAM** | 2 GB free | 4 GB+ free | More for large projects |
| **Disk Space** | 500 MB | 1 GB+ | Includes npm dependencies |
| **CPU** | Any | Multi-core | Faster generation with more cores |
| **Network** | Required | Broadband | For AI API calls (Claude/Qwen/Gemini) |
| **Internet Speed** | 1 Mbps+ | 10 Mbps+ | Faster API responses |

</div>

### Platform-Specific Notes

**Windows:**
- ✅ Full support for PowerShell, CMD, and Git Bash
- ✅ WSL (Windows Subsystem for Linux) supported
- ✅ No administrator privileges required
- 📖 [Windows Quick Start Guide](docs/installation/WINDOWS-QUICKSTART.md)

**macOS:**
- ✅ Full support for Intel and Apple Silicon (M1/M2/M3)
- ✅ Works with Homebrew, nvm, or official Node.js
- ✅ Both zsh and bash shells supported
- ✅ No sudo required (use nvm recommended)
- 📖 [macOS Quick Start Guide](docs/installation/MACOS-QUICKSTART.md)

**Linux:**
- ✅ Tested on Ubuntu, Debian, Fedora, Arch
- ✅ Works with system npm, nvm, or Node Version Manager
- ✅ All major distributions supported
- 💡 Use nvm to avoid permission issues

**Git Bash (Windows):**
- ✅ Fully supported with automatic detection
- ✅ All `.sh` scripts work natively
- ✅ postinstall automatically uses bash installer
- 💡 Recommended for Windows developers familiar with Unix commands

### ✨ Recent Cross-Platform Improvements (v4.1.0+)

**Installation Enhancements:**
- ✅ **No mandatory parameters**: All installer scripts now work without arguments (defaults to `--global`)
- ✅ **Smart shell detection**: Automatically detects PowerShell, CMD, Git Bash, and WSL on Windows
- ✅ **Improved error handling**: Better error messages with platform-specific solutions
- ✅ **Path auto-detection**: Works with standard npm, Homebrew, nvm, and custom npm configurations

**Documentation Improvements:**
- 📖 New [macOS Quick Start Guide](docs/installation/MACOS-QUICKSTART.md) with Apple Silicon notes
- 📖 Enhanced [Windows Quick Start Guide](docs/installation/WINDOWS-QUICKSTART.md) with Git Bash support
- 📖 Platform-specific verification commands (CMD, PowerShell, bash/zsh)
- 📖 Clear permission guidance (no more sudo confusion)
- 📖 Comprehensive troubleshooting for all platforms

**Verification Commands:**
```bash
# Check your setup works correctly
prprompts doctor              # Comprehensive diagnostics
prprompts validate-keys       # Validate API keys

# Platform-specific checks available in each guide
```

---

## 🔑 Configure AI Providers

PRPROMPTS works with three AI assistants. Choose one (or install all for flexibility):

<div align="center">

| AI Provider | Installation | Authentication |
|-------------|--------------|----------------|
| **Claude Code** | `npm install -g @anthropic-ai/claude-code` | [Get API Key](https://console.anthropic.com/settings/keys) |
| **Qwen Code** | `npm install -g @qwenlm/qwen-code` | [Get API Key](https://dashscope.aliyun.com/) |
| **Gemini CLI** | `npm install -g @google/gemini-cli` | [Get API Key](https://aistudio.google.com/app/apikey) |

</div>

### Quick Setup

**1. Install an AI CLI** (pick one or install all):

```bash
# Option 1: Claude Code (by Anthropic)
npm install -g @anthropic-ai/claude-code

# Option 2: Qwen Code (by Alibaba Cloud)
npm install -g @qwenlm/qwen-code

# Option 3: Gemini CLI (by Google)
npm install -g @google/gemini-cli
```

**💡 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.

**2. Configure API Keys**:

**NEW in v4.1 - Interactive Setup:**
```bash
# Easy interactive setup (Recommended!)
prprompts setup-keys claude
prprompts setup-keys gemini
prprompts setup-keys qwen

# Validate all keys
prprompts validate-keys
```

**Or manual setup:**
```bash
# Copy environment template
cp .env.example .env

# Edit .env and add your API key(s):
# ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
# DASHSCOPE_API_KEY=sk-xxxxx
# GOOGLE_API_KEY=AIzaSyxxxxx
```

**3. Verify Setup**:

```bash
# Check installation and API keys
prprompts doctor         # Comprehensive diagnostics
prprompts validate-keys  # Validate API keys

# Launch interactive mode (easiest!)
prprompts interactive

# Or test with commands
prprompts --version      # Should show 5.0.0
```

**🔒 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.


---

## 🤖 v4.0: Full Automation (NEW!)

<div align="center">

**🚀 Go from PRD to working code automatically!**

**Zero-touch automation with PRPROMPTS-guided implementation**

**✨ NEW: Claude Code Skills System - 30 Specialized Automation Skills**

</div>

### Complete Automation Pipeline

```bash
# 1. Generate PRPROMPTS (60 seconds)
prprompts auto && prprompts generate

# 2. Start AI assistant
claude  # or qwen, or gemini

# 3. Bootstrap project (2 minutes) - Using Skills
@claude use skill automation/flutter-bootstrapper

# 4. Auto-implement features (1-2 hours) - Using Skills
@claude use skill automation/automation-orchestrator
# Input: feature_count: 10

# 5. Code review - Using Skills
@claude use skill automation/code-reviewer

# 6. QA audit (2 minutes) - Using Skills
@claude use skill automation/qa-auditor
# Input: audit_type: "pre-production"
```

### 🎯 Claude Code Skills System (NEW!)

**PRPROMPTS now includes a comprehensive skills system with 30+ specialized automation skills across 5 categories:**

<table>
<tr>
<th>Category</th>
<th>Skills</th>
<th>Status</th>
<th>Use Cases</th>
</tr>
<tr>
<td><strong>🤖 Automation (100%)</strong></td>
<td>
• flutter-bootstrapper<br/>
• feature-implementer<br/>
• automation-orchestrator<br/>
• code-reviewer<br/>
• qa-auditor
</td>
<td>✅ 5/5 Complete</td>
<td>
Complete automation pipeline from bootstrap to production audit
</td>
</tr>
<tr>
<td><strong>📝 PRPROMPTS Core (80%)</strong></td>
<td>
• prd-creator<br/>
• prprompts-generator<br/>
• phase-generator<br/>
• single-file-generator<br/>
• prd-analyzer (planned)
</td>
<td>✅ 4/5 Complete</td>
<td>
PRD creation and PRPROMPTS generation
</td>
</tr>
<tr>
<td><strong>✅ Validation (0%)</strong></td>
<td>
• architecture-validator<br/>
• security-validator<br/>
• compliance-checker<br/>
• test-validator
</td>
<td>⏳ Planned</td>
<td>
Deep validation of architecture, security, compliance, tests
</td>
</tr>
<tr>
<td><strong>🛠️ Utilities (0%)</strong></td>
<td>
• api-validator<br/>
• rate-monitor<br/>
• progress-tracker<br/>
• state-manager
</td>
<td>⏳ Planned</td>
<td>
API validation, rate limiting, progress tracking
</td>
</tr>
<tr>
<td><strong>🎨 Workflow (100%)</strong></td>
<td>
• flutter-flavors
</td>
<td>✅ 1/1 Complete</td>
<td>
Multi-environment configuration (dev/staging/prod)
</td>
</tr>
</table>

**Overall Progress: 10/23 skills (43.5% complete)**

**How Skills Work:**

**Claude Code:**
```bash
# Invoke any skill in Claude Code
@claude use skill automation/code-reviewer

# Skills prompt for inputs if needed
# Input: review_type: "security"
# Input: target_path: "lib/features/auth"

# Skills execute autonomously with detailed output
# Example output: Comprehensive review report with scoring
```

**Qwen Code (NEW!):**
```bash
# Skills available as global TOML slash commands
qwen

# Use skills with smart defaults
/skills/automation/code-reviewer
# > Review type? (full): [Just press Enter]
# ✅ Using defaults: review_type='full', target_path='lib/'

# Complete automation workflow
/skills/automation/flutter-bootstrapper
/skills/automation/automation-orchestrator
# > Feature count? 10
/skills/automation/qa-auditor
# > Generate cert? y
```

📖 **[Qwen Skills Complete Guide](docs/QWEN-SKILLS-GUIDE.md)** - Comprehensive usage guide with smart defaults, workflows, and examples

**Key Skills Capabilities:**

**automation-orchestrator:**
- Orchestrates 1-10 feature implementations
- Topological sort for dependency resolution
- Circular dependency detection
- Execution time: 1-2 hours for 10 features

**code-reviewer:**
- 7-step review process (architecture, security, testing, style)
- Weighted scoring system (0-100)
- Auto-fix capability for common issues
- Multiple output formats (markdown/json/html)

**qa-auditor:**
- Comprehensive audit across 6 categories
- Compliance certification (HIPAA, PCI-DSS, GDPR, SOC2, COPPA, FERPA)
- Pass/fail with configurable threshold (default 75/100)
- Certificate generation with expiration dates

📖 **Documentation:**
- **[Claude Skills](\.claude\skills\index.md)** - Claude Code skills documentation
- **[Qwen Skills](docs/QWEN-SKILLS-GUIDE.md)** - Qwen Code TOML slash commands guide (NEW!)
- **[Qwen Setup](QWEN.md)** - Complete Qwen Code setup with skills installation
- **[Gemini Skills](docs/GEMINI-SKILLS-GUIDE.md)** - Gemini CLI TOML slash commands guide (NEW!)
- **[Gemini Setup](GEMINI.md)** - Complete Gemini CLI setup with skills installation

**Gemini CLI (NEW!):**
```bash
# Skills available as global TOML slash commands with colon separator
gemini

# Inline arguments (Gemini-specific feature!)
/skills:automation:code-reviewer security lib/features/auth true
# No prompts - arguments parsed automatically!

# Leverage 1M token context
/skills:automation:code-reviewer full lib/
# Loads entire codebase (150 files) in single pass!

# Complete automation workflow
/skills:automation:flutter-bootstrapper . true true true true hipaa
/skills:automation:automation-orchestrator 10
/skills:automation:qa-auditor . hipaa,pci-dss true true QA_REPORT.md 85
```

**Gemini-Specific Advantages:**
- ✅ **1M Token Context** - Analyze entire codebases (5x larger than Claude)
- ✅ **{{args}} Support** - Inline arguments for streamlined workflows
- ✅ **ReAct Agent Mode** - Autonomous reasoning and acting loops
- ✅ **Free Tier** - 60 req/min, 1,000/day (no credit card required)
- ✅ **Colon Separator** - `/skills:automation:code-reviewer` syntax (vs. Qwen's slash separator)

📖 **[Gemini Skills Complete Guide](docs/GEMINI-SKILLS-GUIDE.md)** - Comprehensive usage guide with Gemini-specific features, workflows, and benchmarks

### New Automation Commands

<table>
<tr>
<td width="50%">

**`/bootstrap-from-prprompts`**
Complete project setup in 2-5 minutes:
- ✅ Clean Architecture structure
- ✅ Design system (Material 3)
- ✅ Security infrastructure (JWT, encryption)
- ✅ Test infrastructure
- ✅ ARCHITECTURE.md & IMPLEMENTATION_PLAN.md

</td>
<td width="50%">

**`/implement-next`**
Auto-implement next task:
- ✅ Follows PRPROMPTS patterns
- ✅ Generates comprehensive tests
- ✅ Security validation (JWT, PCI-DSS, HIPAA)
- ✅ Code quality checks
- ✅ Automatic staging

</td>
</tr>
<tr>
<td width="50%">

**`/review-and-commit`**
Validate and commit:
- ✅ PRPROMPTS compliance check
- ✅ Security validation
- ✅ Test coverage verification
- ✅ Code formatting
- ✅ Conventional commit messages

</td>
<td width="50%">

**`/full-cycle`**
Complete automation loop:
- ✅ Implement multiple tasks (1-10)
- ✅ Auto-test each task
- ✅ Auto-commit with validation
- ✅ Progress tracking
- ✅ Quality gate at end

</td>
</tr>
<tr>
<td colspan="2">

**`/qa-check`**
Comprehensive PRPROMPTS compliance audit:
- ✅ Architecture validation (Clean Architecture, BLoC)
- ✅ Security patterns (JWT verification, PII encryption, PCI-DSS)
- ✅ Test coverage (>70%)
- ✅ Static analysis (flutter analyze)
- ✅ Generates QA_REPORT.md with compliance score

</td>
</tr>
</table>

### Example: Healthcare App Automation

```bash
# Complete healthcare app in 2-3 hours (vs 2-3 days manual)
cd ~/projects/healthtrack-pro
flutter create .

# Generate PRPROMPTS with HIPAA compliance
cp templates/healthcare.md project_description.md
prprompts auto && prprompts generate

# Auto-bootstrap
claude
/bootstrap-from-prprompts

# Auto-implement 15 features
/full-cycle
15

# Security audit
/qa-check

# Result: Production-ready HIPAA-compliant app!
# - JWT verification (RS256)
# - PHI encryption (AES-256-GCM)
# - Audit logging
# - 85% test coverage
# - Zero security violations
```

### What Gets Automated

<table>
<tr>
<th>Manual (3-5 days)</th>
<th>Automated with v4.0 (2-3 hours)</th>
</tr>
<tr>
<td>

- Set up folder structure
- Configure dependencies
- Create design system
- Implement security
- Write features
- Generate tests
- Fix bugs
- Run QA
- Make commits

</td>
<td>

**All of this happens automatically:**
- `/bootstrap-from-prprompts` - Setup (2 min)
- `/full-cycle` - Implement & test (1-2 hours)
- `/qa-check` - Validate (2 min)

**Every line follows PRPROMPTS patterns**
**Security built-in (JWT, encryption, compliance)**
**Tests auto-generated and passing**

</td>
</tr>
</table>

### Installation

```bash
# Install automation commands (works with existing installation)
./scripts/install-automation-commands.sh --global

# Verify commands available
claude  # In Claude Code, you'll see all 5 automation commands
```

**Works with:**
- ✅ Claude Code
- ✅ Qwen Code
- ✅ Gemini CLI

📖 **[Complete Automation Guide](docs/AUTOMATION-GUIDE.md)** - Full workflow examples, troubleshooting, security validation

---

## ✨ v3.0 New Features

<div align="center">

**🎉 Major update with powerful installation improvements!**

</div>

<table>
<tr>
<td width="50%">

### 🤖 Smart Unified Installer
**One command to install everything**
- Auto-detects your OS and AI assistants
- Offers to install missing AIs
- Installs commands for all detected AIs
- Creates unified configuration
- Beautiful interactive prompts

</td>
<td width="50%">

### 🔧 Unified CLI (`prprompts` command)
**Single interface for all AIs**
```bash
prprompts create     # Instead of claude/qwen/gemini
prprompts generate   # Uses your preferred AI
prprompts switch ai  # Change default AI
prprompts doctor     # Diagnose issues
```

</td>
</tr>
<tr>
<td width="50%">

### 🔄 Auto-Update System
**Stay current effortlessly**
- One-command updates from npm registry
- Automatic backup before update
- Background update notifications
- Version tracking per AI
- Rollback capability

```bash
prprompts update         # Update to latest
prprompts check-updates  # Check for new versions
```

**Auto-notifications:** Updates are checked automatically once per day (configurable).

</td>
<td width="50%">

### 📦 Project Templates
**Quick start for common projects**
- Healthcare (HIPAA-compliant)
- Fintech (PCI-DSS compliant)
- E-Commerce
- Generic apps

Pre-configured with best practices!

</td>
</tr>
<tr>
<td width="50%">

### 🐚 Shell Completions
**Tab completion for faster workflow**
- Bash, Zsh, Fish support
- Command completion
- AI name completion
- File name completion

</td>
<td width="50%">

### 🩺 Doctor Command
**Instant diagnostics**
```bash
prprompts doctor
```
Checks Node.js, npm, Git, AIs, configs, and more!

</td>
</tr>
</table>

<div align="center">

**[📖 Read Full v3.0 Feature Guide](docs/NEW-FEATURES-V3.md)**

</div>

---

## 📦 v4.0.0 - Full Extension Ecosystem

<div align="center">

**🚀 Now published on npm with complete AI extension support!**

**✨ 3 Official Extensions • 5 Automation Commands • 14 Commands Per AI**

</div>

<table>
<tr>
<td width="50%">

### 🎁 Complete Extension Ecosystem
**All 3 AI extensions included!**

**Claude Code Extension:**
- 9.5/10 accuracy
- Production-quality
- Official Anthropic support

**Qwen Code Extension:**
- 256K-1M token context
- Extended context analysis
- Cost-effective

**Gemini CLI Extension:**
- 1M token context
- 60 req/min FREE tier
- **NEW: Slash commands in `/help`**
- Best for MVPs
- Native TOML command integration

</td>
<td width="50%">

### 🤖 Full Automation (v4.0)
**40-60x faster development!**

**5 Automation Commands:**
1. `/bootstrap-from-prprompts` - Setup (2 min)
2. `/implement-next` - Auto-code (10 min)
3. `/full-cycle` - 1-10 features (1-2 hours)
4. `/review-and-commit` - Validate
5. `/qa-check` - Compliance audit

**Result:** Production-ready app in 2-3 hours vs 3-5 days!

</td>
</tr>
<tr>
<td colspan="2">

### 📦 One Command Installation
```bash
# Install everything at once (30 seconds)
npm install -g prprompts-flutter-generator
```

**What gets installed:**
- ✅ All 3 AI extensions (Claude, Qwen, Gemini)
- ✅ **21 commands per AI** (6 PRD + 4 Planning + 5 PRPROMPTS + 6 Automation)
- ✅ 32 security-audited development guides
- ✅ Project templates (Healthcare, Fintech, E-commerce)
- ✅ Unified CLI (`prprompts` command)
- ✅ Auto-configuration for detected AIs
- ✅ Shell completions (Bash/Zsh/Fish)

**Then use anywhere:**
```bash
cd your-flutter-project
prprompts create && prprompts generate  # Generate PRPROMPTS (60 sec)

# Use any AI assistant (all 21 commands available)
claude bootstrap-from-prprompts         # Setup project (2 min)
claude full-cycle                       # Auto-implement (1-2 hours)

# Or with Gemini (same commands)
gemini bootstrap-from-prprompts         # Setup project (2 min)
gemini full-cycle                       # Auto-implement (1-2 hours)

# Or with Qwen (same commands)
qwen bootstrap-from-prprompts           # Setup project (2 min)
qwen full-cycle                         # Auto-implement (1-2 hours)
```

</td>
</tr>
</table>

**Upgrade from previous versions:**
```bash
# Update to v5.0.0 with React-to-Flutter refactoring
npm update -g prprompts-flutter-generator

# Verify
prprompts --version  # Should show 5.0.0
prprompts doctor     # Check extension status

# Verify TOML files generated correctly (Qwen/Gemini users)
ls ~/.config/qwen/commands/*.toml     # Should show 21 .toml files
ls ~/.config/gemini/commands/*.toml   # Should show 21 .toml files
```

---

## 💬 v4.4: Slash Commands (NEW!)

<div align="center">

**🚀 Use all 21 PRPROMPTS commands directly in your AI chat!**

**No more switching between terminal and chat - everything in one place**

</div>

### 🎯 What Are Slash Commands?

Slash 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!

<table>
<tr>
<td width="50%">

### 📝 **Before v4.4: Terminal Only**

```bash
# Switch to terminal
prprompts create

# Back to chat to ask AI for help
# Switch to terminal again
prprompts generate

# Back to chat...
```

**❌ Constant context switching**
**❌ Hard to remember commands**
**❌ Separate from AI conversation**

</td>
<td width="50%">

### ✨ **After v4.4: In-Chat Commands**

```
# Everything in one chat session:
/prd/create

# AI helps you fill it out
# Then continue:
/prprompts/generate-all

# Keep working in the same context!
```

**✅ Stay in the conversation**
**✅ Discoverable with autocomplete**
**✅ AI context maintained**

</td>
</tr>
</table>

### 📚 All 21 Slash Commands (Perfect Multi-AI Parity!)

Commands are organized by category for easy discovery. **ALL 21 commands work identically on Claude Code, Qwen Code, and Gemini CLI:**

<table>
<tr>
<td width="50%">

#### **📝 PRD Commands** (`/prd/...`)

| Command | Description |
|---------|-------------|
| `/prd/create` | Interactive PRD wizard |
| `/prd/auto-generate` | Auto-generate from description |
| `/prd/from-files` | Generate from markdown files |
| `/prd/auto-from-project` | Auto-discover project files |
| `/prd/analyze` | Validate and analyze PRD |
| `/prd/refine` | AI-guided refinement |

#### **📊 Planning Commands** (`/planning/...`)

| Command | Description |
|---------|-------------|
| `/planning/estimate-cost` | Cost breakdown analysis |
| `/planning/analyze-dependencies` | Feature dependency mapping |
| `/planning/stakeholder-review` | Generate review checklists |
| `/planning/implementation-plan` | Sprint-based planning |

</td>
<td width="50%">

#### **📚 PRPROMPTS Commands** (`/prprompts/...`)

| Command | Description |
|---------|-------------|
| `/prprompts/generate-all` | Generate all 32 files |
| `/prprompts/phase-1` | Core Architecture (10 files) |
| `/prprompts/phase-2` | Quality & Security (12 files) |
| `/prprompts/phase-3` | Demo & Learning (10 files) |
| `/prprompts/single-file` | Generate one specific file |

#### **🤖 Automation Commands** (`/automation/...`)

| Command | Description |
|---------|-------------|
| `/automation/bootstrap` | Complete project setup |
| `/automation/implement-next` | Auto-implement next feature |
| `/automation/update-plan` | Re-plan based on progress |
| `/automation/full-cycle` | Auto-implement 1-10 features |
| `/automation/review-commit` | Validate and commit changes |
| `/automation/qa-check` | Compliance audit |

</td>
</tr>
</table>

### 🚀 Quick Start with Slash Commands

```bash
# 1. Install (one time)
npm install -g prprompts-flutter-generator

# 2. Open your AI assistant (Claude Code, Qwen Code, or Gemini CLI)
claude

# 3. Use slash commands in chat:
/prd/create                    # Create your PRD
/prprompts/generate-all        # Generate 32 files
/automation/bootstrap          # Setup project
/automation/implement-next     # Start implementing!
```

### 💡 Tips & Best Practices

- **Discoverability**: Type `/` to see all available commands
- **Category Organization**: Commands grouped by purpose (prd/, planning/, prprompts/, automation/)
- **Context Maintained**: AI remembers your conversation while running commands
- **Still Works in Terminal**: Traditional `prprompts create` still works if you prefer CLI
- **Multi-AI Support**: Same slash commands work in Claude Code, Qwen Code, and Gemini CLI

### 🔄 Comparison: CLI vs Slash Commands

| Method | Example | Best For |
|--------|---------|----------|
| **Terminal CLI** | `prprompts create` | Scripting, automation, CI/CD |
| **Slash Commands** | `/prd/create` | Interactive development, learning |
| **Interactive Mode** | `prprompts interactive` | Menu-driven workflows |

**💡 Pro Tip**: Use slash commands for interactive work and CLI for automation scripts!

---

## 🌟 v4.1: Enterprise Features (NEW!)

<div align="center">

**🚀 Transform PRPROMPTS into an enterprise-grade development powerhouse!**

**Interactive Mode • API Validation • Rate Limiting • Progress Tracking • Command History**

</div>

### 🎯 New Enterprise Features

<table>
<tr>
<td width="50%">

### 🎮 Interactive Mode
**Menu-driven interface for easier usage**

```bash
prprompts interactive
```

Navigate through hierarchical menus:
- 📝 Create PRD & Generate PRPROMPTS
- 🤖 Automation Pipeline
- 🔧 AI Configuration
- 🛠️ Project Tools
- ⚙️ Settings & Help

No more remembering commands!

</td>
<td width="50%">

### 🔑 API Key Validation
**Pre-flight validation & setup**

```bash
# Validate all API keys
prprompts validate-keys

# Interactive setup
prprompts setup-keys claude
```

Features:
- ✅ Multi-location detection
- ✅ Online validation
- ✅ Interactive wizard
- ✅ Secure storage

</td>
</tr>
<tr>
<td width="50%">

### 📊 Rate Limit Management
**Never hit API limits again**

```bash
prprompts rate-status
```

Visual usage tracking:
```
CLAUDE (free tier):
  Per minute: [████████░░] 80% 4/5
  Per day:    [██░░░░░░░░] 20% 20/100
  Tokens:     [████░░░░░░] 40% 4K/10K
```

- 🎯 AI recommendation based on availability
- ⏳ Automatic backoff & retry
- 📈 Tier-based tracking

</td>
<td width="50%">

### 📈 Progress Indicators
**Visual feedback for all operations**

Real-time progress bars:
```
Processing: [████████████░░░░] 75% ETA: 20s
Loading: ⠸ Loading data (15/30)
Connecting...
✓ Initialize project
→ Install dependencies
○ Generate PRPROMPTS
```

Multiple indicator types:
- Progress bars with ETA
- Spinners for async tasks
- Step indicators
- Parallel progress

</td>
</tr>
<tr>
<td colspan="2">

### 📚 Command History System
**Intelligent command tracking & suggestions**

```bash
# Browse history interactively
prprompts history

# Search previous commands
prprompts history-search create

# Get suggestions (auto-complete coming soon!)
```

Features:
- 🔍 Search & filter capabilities
- 📊 Frequency tracking
- 🏷️ Auto-tagging
- 💡 Context-aware suggestions
- 📤 Export/import for team sharing

</td>
</tr>
</table>

### 🚀 Quick Start with v5.0.0

```bash
# 1. Install/Update to v5.0.0 (React-to-Flutter + TOML auto-generation)
npm install -g prprompts-flutter-generator@latest

# 2. Setup API keys interactively
prprompts setup-keys claude

# 3. Launch interactive mode
prprompts interactive

# 4. Or use new commands directly
prprompts validate-keys      # Check API keys
prprompts rate-status        # View usage
prprompts history            # Browse history

# 5. Verify multi-AI parity (all should show 21 commands)
qwen /help                   # Qwen Code
gemini /help                 # Gemini CLI
claude /help                 # Claude Code
```

### 📋 Complete v5.0.0 Command Reference (21 Commands + 8 Skills + React-to-Flutter)

<table>
<tr>
<th>Category</th>
<th>Command</th>
<th>Description</th>
</tr>
<tr>
<td rowspan="3"><b>Interactive</b></td>
<td><code>prprompts interactive</code></td>
<td>Launch menu-driven interface</td>
</tr>
<tr>
<td><code>prprompts history</code></td>
<td>Browse command history</td>
</tr>
<tr>
<td><code>prprompts history-search [query]</code></td>
<td>Search command history</td>
</tr>
<tr>
<td rowspan="3"><b>API Management</b></td>
<td><code>prprompts validate-keys</code></td>
<td>Validate all API keys</td>
</tr>
<tr>
<td><code>prprompts setup-keys [ai]</code></td>
<td>Interactive API key setup</td>
</tr>
<tr>
<td><code>prprompts rate-status</code></td>
<td>Check rate limit usage</td>
</tr>
<tr>
<td rowspan="6"><b>Automation</b></td>
<td><code>prprompts auto-status</code></td>
<td>Show automation progress</td>
</tr>
<tr>
<td><code>prprompts auto-validate</code></td>
<td>Validate code quality</td>
</tr>
<tr>
<td><code>prprompts auto-bootstrap</code></td>
<td>Bootstrap project structure</td>
</tr>
<tr>
<td><code>prprompts auto-implement N</code></td>
<td>Implement N features</td>
</tr>
<tr>
<td><code>prprompts auto-test</code></td>
<td>Run tests with coverage</td>
</tr>
<tr>
<td><code>prprompts auto-reset</code></td>
<td>Reset automation state</td>
</tr>
</table>

### 🔧 Environment Variables (v4.1)

```bash
# Core Configuration
export PRPROMPTS_DEFAULT_AI=claude    # Default AI (claude/qwen/gemini)
export PRPROMPTS_VERBOSE=true         # Verbose output
export PRPROMPTS_TIMEOUT=300000       # Command timeout (ms)
export PRPROMPTS_RETRY_COUNT=5        # Retry attempts

# API Keys
export CLAUDE_API_KEY=sk-ant-...      # Claude API key
export GEMINI_API_KEY=AIzaSy...       # Gemini API key
export QWEN_API_KEY=...                # Qwen API key

# Rate Limiting Tiers
export CLAUDE_TIER=pro                 # free/starter/pro
export GEMINI_TIER=free                # free/pro
export QWEN_TIER=plus                  # free/plus/pro
```

### 📊 v4.1 Impact Metrics

| Feature | Before v4.1 | After v4.1 | Improvement |
|---------|------------|------------|-------------|
| **API Setup** | Manual config files | Interactive wizard | 5x easier |
| **Rate Limits** | Hit 429 errors | Smart prevention | 0 blocks |
| **Command Discovery** | Read docs | Interactive menus | 10x faster |
| **Progress Visibility** | Text only | Visual indicators | Clear ETA |
| **Command Memory** | None | Full history | 100% recall |
| **Error Recovery** | Manual retry | Auto retry 3x | 70% fewer fails |
| **Test Coverage** | 60% | 85% | +41% quality |

---

## 📊 At a Glance

<table>
<tr>
<td width="33%" align="center">

### 🎮 Interactive Mode (v4.1)
Menu-driven interface<br/>No command memorization

</td>
<td width="33%" align="center">

### 32 Files Generated
Complete development guides<br/>covering all aspects

</td>
<td width="33%" align="center">

### 3 AI Assistants
Claude • Qwen • Gemini<br/>With API validation

</td>
</tr>
<tr>
<td width="33%" align="center">

### 6 Compliance Standards
HIPAA • PCI-DSS • GDPR<br/>SOC2 • COPPA • FERPA

</td>
<td width="33%" align="center">

### 13+ New Commands
Interactive • Validation • History<br/>Rate Limiting • Progress

</td>
<td width="33%" align="center">

### 3 Platforms
Wind