
Product
Introducing Manifest Alerts
Socket now detects supply chain risks in project manifests, starting with missing lockfiles that can make dependency installs non-reproducible.
prprompts-flutter-generator
Advanced tools
AI-powered Flutter development with full automation + official extension support - Generate 32 security-audited guides & auto-implement in 2-3 hours. NEW v5.1: Official Claude Code plugin with hooks, Gemini TOML commands, Qwen MCP settings. Features: Comp
Production Ready! v5.1 delivers official extension support for all three AI platforms with native integration, hooks automation, and TOML command format.
npm run sync-versions keeps all manifests aligned1. Claude Code Official Plugin
.claude-plugin/plugin.json)dart format after every edit2. Gemini CLI TOML Commands
GEMINI.md) for AI understanding3. Qwen Code MCP Configuration
settings.json)# 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
โ
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
Choose the best AI assistant for your needs:
| 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 |
Claude Code:
Qwen Code:
Gemini CLI:
All platforms support the same npm installation:
# 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
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.
# 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)
Run refactoring commands directly in your AI assistant chat:
# 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.
| React/React Native | โ | Flutter |
|---|---|---|
| โก |
|
Color(0xFFRRGGBB)Row/Column/FlexBoxDecoration.borderBoxShadowLinearGradient/RadialGradientTextStyleMediaQueryExample:
/* 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;
}
// 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),
Example:
// 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 };
};
// 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;
});
}
});
}
}
Example:
// React HOC
const withAuth = (Component) => {
return (props) => {
const { user } = useAuth();
if (!user) return <Login />;
return <Component {...props} user={user} />;
};
};
// 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);
}
Automatically generates complete Clean Architecture structure:
lib/
โโโ domain/
โ โโโ entities/
โ โโโ repositories/
โ โโโ usecases/
โโโ data/
โ โโโ datasources/
โ โโโ models/
โ โโโ repositories/
โโโ presentation/
โโโ bloc/
โโโ pages/
โโโ widgets/
Full BLoC/Cubit generation with events and states:
// 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});
}
Optional AI-powered code optimization (Claude/Qwen/Gemini):
# Enable AI enhancement
prprompts refactor ./my-app ./flutter-app --ai claude --enhance
5 specialized validators with detailed reports:
Output: VALIDATION_REPORT.md with actionable recommendations
Healthcare App (React Native โ Flutter)
E-Commerce App (React โ Flutter)
๐ Ready for production! Convert your React apps to Flutter with confidence.
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
๐ v5.0.0 - Production-Ready React-to-Flutter Conversion + Perfect Multi-AI Parity!
# 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!
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
| ๐ PRD Your requirements 60 sec | โ | ๐ PRPROMPTS 32 secure guides Instant | โ | ๐ค AI Code Auto-implementation 1-2 hours | โ | ๐ Production Ready to deploy Done! |
| Total Time: 2-3 hours (vs 3-5 days manual) = 40-60x faster! |
โ ๏ธ Permissions Note:
sudo npm install -g can cause permission issues laterAlternative Methods:
Windows PowerShell:
irm https://raw.githubusercontent.com/Kandil7/prprompts-flutter-generator/master/scripts/setup-gist.ps1 | iex
Linux / macOS / Git 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
๐ฆ Quick Install โข ๐ช Windows Guide โข โจ v4.1 Features โข ๐ Docs
One-Liner Install:
npm install -g prprompts-flutter-generator && prprompts interactive
๐ Essential Commands
|
๐ Quick LinksSetup Guides:
AI Guides: |
๐ฏ Complete Workflow (2-3 hours)
|
| Component | Minimum | Recommended | Notes |
|---|---|---|---|
| Node.js | v20.0.0 | v20 LTS (20.11.0+) | LTS recommended โข Download |
| 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) |
| 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 |
Windows:
macOS:
Linux:
Git Bash (Windows):
.sh scripts work nativelyInstallation Enhancements:
--global)Documentation Improvements:
Verification Commands:
# Check your setup works correctly
prprompts doctor # Comprehensive diagnostics
prprompts validate-keys # Validate API keys
# Platform-specific checks available in each guide
PRPROMPTS works with three AI assistants. Choose one (or install all for flexibility):
| AI Provider | Installation | Authentication |
|---|---|---|
| Claude Code | npm install -g @anthropic-ai/claude-code | Get API Key |
| Qwen Code | npm install -g @qwenlm/qwen-code | Get API Key |
| Gemini CLI | npm install -g @google/gemini-cli | Get API Key |
1. Install an AI CLI (pick one or install all):
# 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 or configure npm user-level installs. See docs/installation/MACOS-QUICKSTART.md for details.
2. Configure API Keys:
NEW in v4.1 - Interactive Setup:
# 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:
# 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:
# 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 for detailed API key setup and SECURITY.md for best practices on API key management, rotation, and incident response.
๐ Go from PRD to working code automatically!
Zero-touch automation with PRPROMPTS-guided implementation
โจ NEW: Claude Code Skills System - 30 Specialized Automation Skills
# 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"
PRPROMPTS now includes a comprehensive skills system with 30+ specialized automation skills across 5 categories:
| Category | Skills | Status | Use Cases |
|---|---|---|---|
| ๐ค Automation (100%) |
โข flutter-bootstrapper โข feature-implementer โข automation-orchestrator โข code-reviewer โข qa-auditor | โ 5/5 Complete | Complete automation pipeline from bootstrap to production audit |
| ๐ PRPROMPTS Core (80%) |
โข prd-creator โข prprompts-generator โข phase-generator โข single-file-generator โข prd-analyzer (planned) | โ 4/5 Complete | PRD creation and PRPROMPTS generation |
| โ Validation (0%) |
โข architecture-validator โข security-validator โข compliance-checker โข test-validator | โณ Planned | Deep validation of architecture, security, compliance, tests |
| ๐ ๏ธ Utilities (0%) |
โข api-validator โข rate-monitor โข progress-tracker โข state-manager | โณ Planned | API validation, rate limiting, progress tracking |
| ๐จ Workflow (100%) | โข flutter-flavors | โ 1/1 Complete | Multi-environment configuration (dev/staging/prod) |
Overall Progress: 10/23 skills (43.5% complete)
How Skills Work:
Claude Code:
# 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!):
# 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 - Comprehensive usage guide with smart defaults, workflows, and examples
Key Skills Capabilities:
automation-orchestrator:
code-reviewer:
qa-auditor:
๐ Documentation:
Gemini CLI (NEW!):
# 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:
/skills:automation:code-reviewer syntax (vs. Qwen's slash separator)๐ Gemini Skills Complete Guide - Comprehensive usage guide with Gemini-specific features, workflows, and benchmarks
|
|
|
|
|
|
|
|
# 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
| Manual (3-5 days) | Automated with v4.0 (2-3 hours) |
|---|---|
|
All of this happens automatically:
Every line follows PRPROMPTS patterns Security built-in (JWT, encryption, compliance) Tests auto-generated and passing |
# 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:
๐ Complete Automation Guide - Full workflow examples, troubleshooting, security validation
๐ Major update with powerful installation improvements!
๐ค Smart Unified InstallerOne command to install everything
|
๐ง Unified CLI (
|
๐ Auto-Update SystemStay current effortlessly
Auto-notifications: Updates are checked automatically once per day (configurable). |
๐ฆ Project TemplatesQuick start for common projects
Pre-configured with best practices! |
๐ Shell CompletionsTab completion for faster workflow
|
๐ฉบ Doctor CommandInstant diagnostics
Checks Node.js, npm, Git, AIs, configs, and more! |
๐ Now published on npm with complete AI extension support!
โจ 3 Official Extensions โข 5 Automation Commands โข 14 Commands Per AI
๐ Complete Extension EcosystemAll 3 AI extensions included! Claude Code Extension:
Qwen Code Extension:
Gemini CLI Extension:
|
๐ค Full Automation (v4.0)40-60x faster development! 5 Automation Commands:
Result: Production-ready app in 2-3 hours vs 3-5 days! |
๐ฆ One Command Installation
What gets installed:
Then use anywhere:
|
Upgrade from previous versions:
# 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
๐ Use all 21 PRPROMPTS commands directly in your AI chat!
No more switching between terminal and chat - everything in one place
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!
๐ Before v4.4: Terminal Only
โ Constant context switching โ Hard to remember commands โ Separate from AI conversation |
โจ After v4.4: In-Chat Commands
โ Stay in the conversation โ Discoverable with autocomplete โ AI context maintained |
Commands are organized by category for easy discovery. ALL 21 commands work identically on Claude Code, Qwen Code, and Gemini CLI:
๐ PRD Commands (
|
| 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/...)| 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 |
/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/...)| 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 |
# 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!
/ to see all available commandsprprompts create still works if you prefer CLI| 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!
๐ Transform PRPROMPTS into an enterprise-grade development powerhouse!
Interactive Mode โข API Validation โข Rate Limiting โข Progress Tracking โข Command History
๐ฎ Interactive ModeMenu-driven interface for easier usage
Navigate through hierarchical menus:
No more remembering commands! |
๐ API Key ValidationPre-flight validation & setup
Features:
|
๐ Rate Limit ManagementNever hit API limits again
Visual usage tracking:
|
๐ Progress IndicatorsVisual feedback for all operations Real-time progress bars:
Multiple indicator types:
|
๐ Command History SystemIntelligent command tracking & suggestions
Features:
|
# 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
| Category | Command | Description |
|---|---|---|
| Interactive | prprompts interactive | Launch menu-driven interface |
prprompts history | Browse command history | |
prprompts history-search [query] | Search command history | |
| API Management | prprompts validate-keys | Validate all API keys |
prprompts setup-keys [ai] | Interactive API key setup | |
prprompts rate-status | Check rate limit usage | |
| Automation | prprompts auto-status | Show automation progress |
prprompts auto-validate | Validate code quality | |
prprompts auto-bootstrap | Bootstrap project structure | |
prprompts auto-implement N | Implement N features | |
prprompts auto-test | Run tests with coverage | |
prprompts auto-reset | Reset automation state |
# 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
| 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 |
๐ฎ Interactive Mode (v4.1)Menu-driven interface |
32 Files GeneratedComplete development guides |
3 AI AssistantsClaude โข Qwen โข Gemini |
6 Compliance StandardsHIPAA โข PCI-DSS โข GDPR |
13+ New CommandsInteractive โข Validation โข History |
3 PlatformsWindows โข macOS โข Linux |
graph LR
A[๐ Your PRD] --> B{Generator}
B --> C[๐๏ธ Phase 1: Architecture<br/>10 files]
B --> D[๐ Phase 2: Quality & Security<br/>12 files]
B --> E[๐ Phase 3: Demo & Learning<br/>10 files]
C --> F[โจ 32 Custom Guides]
D --> F
E --> F
F --> G[๐ Start Building]
The Process:
๐ฏ v5.0.0 Achievement: Complete React-to-Flutter + Perfect Multi-AI Parity
With v5.0.0, you get production-ready React/React Native โ Flutter conversion PLUS ALL 21 commands (6 PRD + 4 Planning + 5 PRPROMPTS + 6 Automation) work identically across Claude Code, Qwen Code, and Gemini CLI. Choose your AI based on what matters to YOUโaccuracy, context size, or costโnot based on which features are available.
Same commands. Same workflows. Same results. Zero manual configuration.
| Feature | ๐ต Claude Code | ๐ Qwen Code | ๐ข Gemini CLI |
|---|---|---|---|
| Context Window | 200K tokens | 256K-1M tokens | โจ 1M tokens |
| Free Tier | 20 messages/day | Self-host | โจ 60 req/min 1,000/day |
| API Cost | $3-15/1M tokens | $0.60-3/1M tokens | โจ FREE (preview) |
| Accuracy | โญโญโญโญโญ 9.5/10 | โญโญโญโญ 9.0/10 | โญโญโญโญ 8.5/10 |
| Best For | Production apps | Large codebases | MVPs, Free tier |
| Commands | โ
Perfect Parity (v5.0.0): ALL 21 commands + 8 skills + React-to-Flutter work identically everywhere! Just replace claude with qwen or gemini |
Installation:
# Install one or all
./scripts/install-commands.sh --global # Claude Code
./scripts/install-qwen-commands.sh --global # Qwen Code
./scripts/install-gemini-commands.sh --global # Gemini CLI
./scripts/install-all.sh --global # All 3 at once ๐
๐ Detailed Comparison: Claude vs Qwen vs Gemini
Each AI assistant now has a dedicated extension! Install PRPROMPTS as a proper extension with optimized configurations:
| ๐ต Claude Code | ๐ Qwen Code | ๐ข Gemini CLI |
|---|---|---|
|
Production-Quality Extension Install:
Best For:
Highlights:
|
Extended-Context Extension ๐ฆ qwen-extension.json Install:
Best For:
Highlights:
|
Free-Tier Extension Install:
Best For:
Highlights:
Using Slash Commands:
All commands tagged with |
|
๐ Full Documentation: Claude Code Guide โข Qwen Code Guide โข Gemini CLI Guide All extensions include: v4.0 automation โข 14 commands โข Extension manifest โข Optimized configs โข Quick Start guides |
โ Extension Manifest - Proper extension.json with full metadata โ Dedicated Installer - AI-specific installation scripts โ Optimized Configs - Tuned for each AI's strengths โ v4.0 Automation - All 5 automation commands included โ Complete Docs - Full setup & usage guides โ npm Support - Auto-install via postinstall script โ TOML Slash Commands - Native command integration (Gemini CLI)
NEW in v4.0.0: PRPROMPTS commands now appear directly in Gemini's /help output using TOML command files!
How it works:
commands/*.toml filesdescription and prompt fields/help in Gemini REPL[prprompts] for easy identificationAvailable Commands:
/create-prd # [prprompts] Interactive PRD creation wizard (10 questions)
/gen-prprompts # [prprompts] Generate all 32 PRPROMPTS files from PRD
/bootstrap-from-prprompts # [prprompts] Complete project setup from PRPROMPTS (2 min)
/full-cycle # [prprompts] Auto-implement 1-10 features automatically (1-2 hours)
/qa-check # [prprompts] Comprehensive compliance audit - generates QA_REPORT.md with score
Installation:
# Via PowerShell (Windows)
irm https://raw.githubusercontent.com/Kandil7/prprompts-flutter-generator/master/scripts/setup-gist.ps1 | iex
# Or via npm
npm install -g prprompts-flutter-generator
Usage Example:
# Start Gemini REPL
gemini
# See all available commands (PRPROMPTS commands will be listed!)
/help
# Create PRD interactively
/create-prd
# Generate all 32 PRPROMPTS files
/gen-prprompts
# Bootstrap entire project
/bootstrap-from-prprompts
# Auto-implement 5 features
/full-cycle
5
# Run compliance audit
/qa-check
TOML Format Example:
description = "[prprompts] Interactive PRD creation wizard (10 questions)"
prompt = """
Generate a comprehensive Product Requirements Document...
[Full prompt instructions here]
"""
Benefits:
/help alongside other extensions (like Flutter)/ + command nameOption 1: npm (Easiest)
# Automatically installs extension for detected AIs
npm install -g prprompts-flutter-generator
Option 2: Extension Script (AI-specific)
# Clone repo once
git clone https://github.com/Kandil7/prprompts-flutter-generator.git
cd prprompts-flutter-generator
# Install extension for your AI
bash install-claude-extension.sh # Claude Code
bash install-qwen-extension.sh # Qwen Code
bash install-gemini-extension.sh # Gemini CLI
Option 3: Install All Extensions
# Install extensions for all 3 AIs at once
bash install-claude-extension.sh
bash install-qwen-extension.sh
bash install-gemini-extension.sh
Most Flutter projects face these challenges:
| Challenge | Impact | Cost |
|---|---|---|
| No security guidelines | Critical vulnerabilities (JWT signing in Flutter, storing credit cards) | High risk |
| Inconsistent patterns | Every developer does things differently | Slow onboarding |
| Missing compliance docs | HIPAA/PCI-DSS violations discovered late | Project delays |
| Junior developer confusion | No explanation of "why" behind decisions | Low productivity |
| Scattered best practices | Hours wasted searching StackOverflow | Wasted time |
PRPROMPTS Generator creates 32 customized, security-audited guides that:
|
๐ก๏ธ Security First
|
๐ Team-Friendly
|
|
โก Time-Saving
|
๐ง Tool-Integrated
|
โ WRONG (Security Vulnerability):
// NEVER do this - exposes private key!
final token = JWT({'user': 'john'}).sign(SecretKey('my-secret'));
โ CORRECT (Secure Pattern):
// Flutter only verifies tokens (public key only!)
Future<bool> verifyToken(String token) async {
final jwt = JWT.verify(
token,
RSAPublicKey(publicKey), // Public key only!
audience: Audience(['my-app']),
issuer: 'api.example.com',
);
return jwt.payload['exp'] > DateTime.now().millisecondsSinceEpoch / 1000;
}
Why? Backend signs with private key (RS256), Flutter verifies with public key. This prevents token forgery.
โ WRONG (PCI-DSS Violation):
// NEVER store full card numbers!
await db.insert('cards', {'number': '4242424242424242'});
โ CORRECT (PCI-DSS Compliant):
// Use tokenization (Stripe, PayPal, etc.)
final token = await stripe.createToken(cardNumber);
await db.insert('cards', {
'last4': cardNumber.substring(cardNumber.length - 4),
'token': token, // Only store token
});
Why? Storing full card numbers requires PCI-DSS Level 1 certification. Tokenization reduces your scope.
โ WRONG (HIPAA Violation):
// NEVER log PHI!
print('Patient SSN: ${patient.ssn}');
โ CORRECT (HIPAA Compliant):
// Encrypt PHI at rest (AES-256-GCM)
final encrypted = await _encryptor.encrypt(
patientData,
key: await _secureStorage.read(key: 'encryption_key'),
);
await db.insert('patients', {'encrypted_data': encrypted});
// Safe logging (no PHI)
print('Patient record updated: ${patient.id}');
Why? HIPAA ยง164.312(a)(2)(iv) requires encryption of ePHI at rest.
| Standard | What Gets Generated | Use Case |
|---|---|---|
| HIPAA | PHI encryption, audit logging, HTTPS-only | Healthcare apps |
| PCI-DSS | Payment tokenization, TLS 1.2+, SAQ checklist | E-commerce, Fintech |
| GDPR | Consent management, right to erasure, data portability | EU users |
| SOC2 | Access controls, encryption, audit trails | Enterprise SaaS |
| COPPA | Parental consent, age verification | Apps for children |
| FERPA | Student records protection | Education apps |
๐ v3.1 - One command for all platforms!
npm install -g prprompts-flutter-generator
That's it! The postinstall script automatically:
~/.prprompts/config.jsonprprompts CLI globallyThen use anywhere:
prprompts create # Create PRD
prprompts generate # Generate all 32 files
claude create-prd # Or use AI-specific commands
Why npm install is better:
| Feature | npm Install | Script Install |
|---|---|---|
| Setup Time | โ 30 seconds | 60 seconds |
| Prerequisites | โ Node.js only | Git, bash required |
| Windows Support | โ Native (cmd/PowerShell) | Requires PowerShell or Git Bash |
| Updates | โ npm update -g | Manual git pull |
| Uninstall | โ npm uninstall -g | Manual cleanup |
| Version Management | โ npm handles it | Manual git checkout |
Don't have an AI assistant yet?
# Install Claude Code (Recommended for production)
npm install -g @anthropic-ai/claude-code
# OR install Gemini CLI (Best free tier)
npm install -g @google/gemini-cli
# OR install Qwen Code (Best for large codebases)
npm install -g @qwenlm/qwen-code
# Then install PRPROMPTS
npm install -g prprompts-flutter-generator
Complete Setup Example:
# Full installation (30 seconds total)
npm install -g @anthropic-ai/claude-code prprompts-flutter-generator
# Verify installation
prprompts doctor
# Start using it
cd your-flutter-project
prprompts create
prprompts generate
๐ v3.0 Smart Installer - Auto-detects everything:
| Platform | Command | Notes |
|---|---|---|
| ๐ช Windows PowerShell |
| ๐ Full Windows Guide |
| ๐ช Windows (Alternative) |
| One-click installer included! |
| ๐ง Linux / ๐ macOS |
| Auto-detects OS & AIs |
| Git Bash (Windows) |
| If you have Git Bash |
โ ๏ธ Windows Users: Don't use bash commands in PowerShell! Use the PowerShell method above. See Windows Guide
That's it! Now run prprompts create or claude create-prd from any directory.
๐ v3.0 Unified CLI:
# Add to PATH (one-time)
echo 'export PATH="$HOME/.prprompts/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# Use unified commands
prprompts create # Create PRD with your default AI
prprompts generate # Generate all 32 PRPROMPTS
prprompts doctor # Diagnose any issues
# 1. Clone repository
git clone https://github.com/Kandil7/prprompts-flutter-generator.git
cd prprompts-flutter-generator
# 2. Install commands globally
./scripts/install-commands.sh --global
# 3. Verify installation
claude create-prd --help
Windows users: See WINDOWS.md for detailed Windows installation.
# Test commands
claude create-prd --help
qwen gen-prprompts --help
gemini analyze-prd --help
# Run test suite
npm test
npm run test:commands
| I have... | Command | Time | Accuracy |
|---|---|---|---|
| ๐ Existing docs | claude prd-from-files | 2 min | 90% |
| ๐ Project discovery | claude auto-prd-from-project | 1 min | 95% |
| ๐ญ Simple idea | claude auto-gen-prd | 1 min | 85% |
| ๐ฏ 10 minutes | claude create-prd | 5 min | 95% |
| โ๏ธ Full control | Copy template | 30 min | 100% |
๐ With npm install (v3.1):
# 1. Install (30 seconds)
npm install -g @anthropic-ai/claude-code prprompts-flutter-generator
# 2. Create project description (10 sec)
cat > project_description.md << 'EOF'
# HealthTrack Pro
Diabetes tracking app for patients to log blood glucose and
message their doctor. Must comply with HIPAA and work offline.
## Users
- Diabetes patients
- Endocrinologists
## Features
1. Blood glucose tracking
2. Medication reminders
3. Secure messaging
4. Health reports
EOF
# 3. Auto-generate PRD & PRPROMPTS (20 sec)
prprompts auto && prprompts generate
# Done! Start coding
cat PRPROMPTS/README.md
Without npm (v3.0 method):
# 1. Clone and install (60 sec)
git clone https://github.com/Kandil7/prprompts-flutter-generator.git
cd prprompts-flutter-generator
bash scripts/smart-install.sh
# 2. Create project description (30 sec)
cat > project_description.md << 'EOF'
# HealthTrack Pro
...
EOF
# 3. Auto-generate PRD (10 sec)
claude auto-gen-prd
# 4. Generate all 32 PRPROMPTS (50 sec)
claude gen-prprompts
# Done!
cat PRPROMPTS/README.md
What gets auto-inferred:
๐ Full Guides:
All 21 commands now work as slash commands inside Claude Code, Qwen Code, and Gemini CLI chat sessions!
| Method | Example | Use Case |
|---|---|---|
| Terminal (traditional) | claude create-prd | Scripting, automation, CI/CD |
| Chat (new slash commands) | /prd/create | Interactive development, in-session workflows |
In chat, type / to explore commands:
/prd/create # Interactive PRD wizard
/prd/auto-generate # Auto from description file
/prd/analyze # Validate PRD with quality scoring
/planning/estimate-cost # Cost breakdown
/planning/implementation-plan # Sprint-based planning
/prprompts/generate-all # All 32 PRPROMPTS files
/prprompts/phase-1 # Phase 1 only
/automation/bootstrap # Complete project setup (2 min)
/automation/implement-next # Auto-implement next feature (10 min)
/automation/update-plan # Re-plan based on velocity (30 sec)
Benefits:
/prd/create vs claude create-prd/ in chat to exploreWorks with all 3 AI assistants:
/prd/create in chat/prd/create in chat/prd/create in chat๐ Full Documentation: See CLAUDE.md, QWEN.md, GEMINI.md
your-flutter-project/
โโโ lib/
โโโ test/
โโโ docs/
โ โโโ PRD.md โ Your requirements
โโโ PRPROMPTS/ โ 33 generated files
โโโ 01-feature_scaffold.md
โโโ 02-responsive_layout.md
โโโ 03-bloc_implementation.md
โโโ 04-api_integration.md
โโโ ...
โโโ 32-lessons_learned_engine.md
โโโ README.md โ Index & usage guide
Every file follows this 6-section structure:
## FEATURE
What this guide helps you accomplish
## EXAMPLES
Real code with actual Flutter file paths
## CONSTRAINTS
โ
DO / โ DON'T rules
## VALIDATION GATES
Pre-commit checklist + CI/CD automation
## BEST PRACTICES
Junior-friendly "Why?" explanations
## REFERENCES
Official docs, compliance guides, ADRs
HealthTrack Pro - Patient Management System
Complete HIPAA-compliant implementation guide with full code examples:
๐ Complete Healthcare Example โ (847 lines, production-ready code)
What you get:
// PHI encryption pattern
@JsonKey(fromJson: _decryptString, toJson: _encryptString)
required String ssn, // Encrypted in database
// HIPAA audit logging
await auditLogger.log(
action: AuditAction.patientView,
userId: requesterId,
resourceId: patientId,
);
ShopFlow - E-Commerce Platform
Complete PCI-DSS Level 1 compliant implementation:
๐ Complete E-Commerce Example โ (832 lines, PCI-DSS compliant)
What you get:
// Payment tokenization (PCI-DSS compliant)
final result = await stripe.confirmPayment(
clientSecret: clientSecret,
params: paymentMethod, // Card data goes directly to Stripe
);
// GDPR data export
await userRepository.exportUserData(userId); // Complete data package
EduConnect - Learning Management System
Complete FERPA and COPPA compliant implementation:
๐ Complete Education Example โ (1,006 lines, FERPA/COPPA compliant)
What you get:
// FERPA access control
await ferpaAccess.canAccessStudentRecord(
userId: userId,
studentId: studentId,
requiredLevel: FerpaPermissionLevel.fullAccess,
);
// COPPA parental consent
if (student.requiresCoppaConsent) {
await parentalConsentService.requestConsent(parent, student);
}
claude create-prd # Interactive wizard with template selection (NEW v4.1)
claude auto-gen-prd # Auto from description file
claude prd-from-files # From existing markdown docs
claude auto-prd-from-project # Auto-discover all .md files (NEW v4.1)
claude analyze-prd # Validate PRD structure + quality scoring (ENHANCED v4.1)
claude refine-prd # Interactive quality improvement loop (NEW v4.1)
NEW in v4.1: Industry Starter Templates
create-prd now offers 6 pre-configured templates with industry best practices:
| Template | Compliance | Features | Use Case |
|---|---|---|---|
| ๐ฅ Healthcare | HIPAA, GDPR | Patient portal, PHI encryption, audit logs | Telemedicine, EHR, patient apps |
| ๐ฐ Fintech | PCI-DSS, SOX | Payment security, KYC, fraud detection | Banking, payments, trading |
| ๐ Education | COPPA, FERPA | Parental consent, student privacy | K-12 learning, LMS, student portals |
| ๐ E-commerce | PCI-DSS | Stripe, shopping cart, secure checkout | Online stores, marketplaces |
| ๐ Logistics | GDPR | GPS tracking, route optimization, offline | Delivery, fleet management |
| ๐ผ SaaS/B2B | GDPR, SOX | Multi-tenancy, enterprise SSO, billing | Business tools, productivity apps |
Benefits:
Before generating code, use strategic planning tools for budget and timeline:
claude estimate-cost # Generate cost breakdown (60 sec)
claude analyze-dependencies # Map feature dependencies (45 sec)
claude generate-stakeholder-review # Create review checklists (30 sec)
claude generate-implementation-plan # Create sprint-based implementation plan (90 sec) - NEW v4.1 Phase 3
claude update-plan # Re-plan based on actual progress (30 sec) - NEW v4.1 Phase 3
Cost Estimator (estimate-cost)
docs/COST_ESTIMATE.mdDependency Analyzer (analyze-dependencies)
docs/FEATURE_DEPENDENCIES.mdStakeholder Review (generate-stakeholder-review)
docs/STAKEHOLDER_REVIEW.mdImplementation Planner (generate-implementation-plan) NEW v4.1 Phase 3
docs/IMPLEMENTATION_PLAN.md (850+ lines)Adaptive Re-Planner (update-plan) NEW v4.1 Phase 3
Typical workflow:
# 1. Create PRD with template
claude create-prd
# 2. Get cost estimate
claude estimate-cost # Budget planning
# 3. Analyze dependencies
claude analyze-dependencies # Timeline planning
# 4. Generate implementation plan (NEW v4.1 Phase 3)
claude generate-implementation-plan # Sprint planning
# 5. Generate stakeholder review
claude generate-stakeholder-review
# 6. Get approvals, then generate PRPROMPTS
claude gen-prprompts
# 7. Start development (uses implementation plan)
claude bootstrap-from-prprompts
claude implement-next # Auto-implements next task
# 8. After each sprint (every 2 weeks)
claude update-plan # Re-plan based on actual progress
claude gen-prprompts # All 32 files (60 sec)
claude gen-phase-1 # Phase 1 only (20 sec)
claude gen-phase-2 # Phase 2 only (25 sec)
claude gen-phase-3 # Phase 3 only (20 sec)
claude gen-file <name> # Single file
# From existing docs โ PRPROMPTS (2 min)
claude prd-from-files && claude gen-prprompts
# From idea โ PRPROMPTS (1 min)
claude auto-gen-prd && claude gen-prprompts
# From all project docs โ PRPROMPTS (1 min) - NEW v4.1
claude auto-prd-from-project && claude gen-prprompts
# Interactive โ PRPROMPTS (5 min)
claude create-prd && claude gen-prprompts
Replace claude with qwen or gemini to use different AI assistants!
๐ Full Command Reference: docs/API.md
๐ v3.1 - Fastest way for new users!
# Day 1: Complete Setup (90 seconds)
cd ~/projects
mkdir healthtrack-pro && cd healthtrack-pro
# Install everything at once
npm install -g @anthropic-ai/claude-code prprompts-flutter-generator
# Initialize Flutter project
flutter create .
# Use healthcare template
cat templates/healthcare.md > project_description.md
# Generate PRD and all 32 PRPROMPTS
prprompts auto && prprompts generate
# Verify installation
prprompts doctor
# Result: Ready to start coding with 32 security-audited guides!
# Day 1: Setup (2 minutes)
cd ~/projects
mkdir healthtrack-pro && cd healthtrack-pro
# Initialize Flutter project
flutter create .
# Use healthcare template
cat > project_description.md < templates/healthcare.md
# Generate PRD with unified CLI
prprompts auto
# Generate all guides
prprompts generate
# Result: Ready to start coding with 32 security-audited guides!
# Navigate to your existing Flutter project
cd ~/projects/my-existing-app
# Create PRD from existing documentation
prprompts from-files
# Enter your existing docs when prompted:
# docs/requirements.md
# docs/architecture.md
# docs/api-spec.md
# Review the generated PRD
cat docs/PRD.md
# Generate PRPROMPTS for existing codebase
prprompts generate
# Now you have comprehensive guides for your team!
# Check current AI
prprompts which
# Output: Current AI: claude
# Try Gemini for faster free generation
prprompts switch gemini
# Output: โ Default AI set to: gemini
# Generate with Gemini
prprompts generate
# Switch back to Claude for production
prprompts switch claude
# Regenerate specific file with Claude
prprompts gen-file security_and_compliance
# New developer joins the team
# 1. Quick diagnosis
prprompts doctor
# Checks: Node.js โ, npm โ, Claude โ, Qwen โ, Gemini โ
# 2. View project guides
cd PRPROMPTS
cat README.md
# 3. Read junior onboarding guide
cat 07-junior_onboarding.md
# 4. Check security requirements
cat 16-security_and_compliance.md
# Team member is now productive in < 30 minutes!
# Client now requires PCI-DSS compliance
# 1. Update PRD
vim docs/PRD.md
# Add: compliance: ["hipaa", "pci-dss", "gdpr"]
# 2. Regenerate affected files
prprompts gen-file security_and_compliance
prprompts gen-file api_integration
prprompts gen-file security_audit
# 3. Review changes
git diff PRPROMPTS/
# Now you have PCI-DSS patterns integrated!
# Originally mobile-only, now adding Web
# 1. Update PRD platforms
vim docs/PRD.md
# Change: platforms: ["ios", "android", "web"]
# 2. Regenerate responsive layout guide
prprompts gen-file responsive_layout
# 3. Regenerate design system
prprompts gen-file design_system
# 4. Check web-specific considerations
cat PRPROMPTS/02-responsive_layout.md | grep -i "web"
# Before releasing to production
# 1. Run security audit checklist
cat PRPROMPTS/14-security_audit_checklist.md
# 2. Verify compliance
cat PRPROMPTS/16-security_and_compliance.md
# 3. Check JWT implementation
grep -r "JWT" lib/ --include="*.dart"
# 4. Validate against PRPROMPTS patterns
# Review: Are we verifying tokens with public key only?
# Review: Are we using RS256, not HS256?
# Ship with confidence!
# Starting a fintech app
# Use pre-configured template
cp templates/fintech.md project_description.md
# Customize for your needs
vim project_description.md
# Auto-generate PRD
prprompts auto
# Generate PRPROMPTS
prprompts generate
# You now have PCI-DSS compliant guides ready!
| Command | Description | Example |
|---|---|---|
prprompts init | Initialize PRPROMPTS in project | prprompts init |
prprompts create | Interactive PRD wizard | prprompts create |
prprompts auto | Auto-generate from description | prprompts auto |
prprompts from-files | Generate from existing docs | prprompts from-files |
prprompts analyze | Validate PRD structure | prprompts analyze |
prprompts generate | Generate all 32 files | prprompts generate |
prprompts gen-phase-1 | Generate Phase 1 only | prprompts gen-phase-1 |
prprompts gen-file | Generate single file | prprompts gen-file bloc_implementation |
prprompts config | Show configuration | prprompts config |
prprompts switch | Change default AI | prprompts switch gemini |
prprompts which | Show current AI | prprompts which |
prprompts doctor | Diagnose issues | prprompts doctor |
prprompts update | Update to latest version | prprompts update |
prprompts check-updates | Check for available updates | prprompts check-updates |
prprompts version | Show version info | prprompts version |
prprompts help | Show help | prprompts help |
๐ Complete Setup with npm (30 seconds):
npm install -g @anthropic-ai/claude-code prprompts-flutter-generator
prprompts auto && prprompts generate
Healthcare App:
cp templates/healthcare.md project_description.md
prprompts auto && prprompts generate
Fintech App:
cp templates/fintech.md project_description.md
prprompts auto && prprompts generate
From Existing Docs:
prprompts from-files && prprompts generate
Regenerate Security File:
prprompts gen-file security_and_compliance
Switch to Gemini (Free Tier):
prprompts switch gemini && prprompts generate
Check Installation:
prprompts doctor
Update to Latest:
# Check for updates first
prprompts check-updates
# Install update
prprompts update
# Or use npm directly
npm update -g prprompts-flutter-generator
Auto-updates: PRPROMPTS automatically checks for updates once per day and notifies you when a new version is available.
๐ From npm (easiest):
# Update to latest
npm update -g prprompts-flutter-generator
# Verify
prprompts --version
prprompts doctor
From git clone (v3.0):
# Pull latest
cd prprompts-flutter-generator
git pull origin master
# Run smart installer
bash scripts/smart-install.sh
# Test unified CLI
prprompts --version
prprompts doctor
Migrate from git to npm:
# Remove old installation (optional)
rm -rf ~/prprompts-flutter-generator
# Install via npm
npm install -g prprompts-flutter-generator
# Verify
prprompts doctor
๐ Install Everything at Once: Use npm to install AI + PRPROMPTS together
npm install -g @anthropic-ai/claude-code prprompts-flutter-generator
Quick Updates: Check for updates regularly
npm update -g prprompts-flutter-generator
# or use built-in updater
prprompts update
Tab Completion: Install shell completions for faster typing
sudo cp completions/prprompts.bash /etc/bash_completion.d/
Quick Template: Use templates for common project types
ls templates/ # See all available templates
cp templates/healthcare.md project_description.md
Selective Regeneration: Only regenerate files that changed
prprompts gen-file security_and_compliance
prprompts gen-file api_integration
Multiple AIs: Install all 3 AIs and switch based on task
npm install -g @anthropic-ai/claude-code @qwenlm/qwen-code @google/gemini-cli
prprompts switch gemini # For free tier
prprompts switch claude # For production quality
prprompts switch qwen # For large codebases
Diagnose Issues: Use doctor command first
prprompts doctor # Shows what's installed and configured
| Issue | Solution |
|---|---|
command not found: prprompts |
Run: npm install -g prprompts-flutter-generatorCheck PATH: echo $PATH (should include npm bin)Restart terminal after installation |
command not found: claude/qwen/gemini |
Install AI CLI first:npm install -g @anthropic-ai/claude-codeVerify: claude --version
|
EACCES: permission denied |
macOS/Linux: Use nvm instead of sudocurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashWindows: No admin needed (should work by default) |
| API key not found/invalid |
Run setup wizard: prprompts setup-keys claudeOr set manually: export ANTHROPIC_API_KEY=sk-ant-...Validate: prprompts validate-keys
|
| Rate limit errors (429) |
Check usage: prprompts rate-statusSwitch AI: prprompts switch gemini (free tier)Wait for reset or upgrade plan |
| Git Bash not working on Windows |
Use PowerShell installer:.\scripts\install-commands.ps1Or use npm (works everywhere): npm install -g prprompts-flutter-generator
|
| Generated files empty/incomplete |
Check PRD exists: cat docs/PRD.mdRegenerate: prprompts generate --forceCheck AI connection: prprompts validate-keys
|
Still stuck?
prprompts doctorA: No! Pick one based on YOUR needsโv5.0.0 achieved perfect command parity + React-to-Flutter:
ALL 21 commands + 8 skills work identically across all 3. Choose by power/cost, not by features!
A: Yes! Use claude auto-prd-from-project to auto-discover all .md files, or claude prd-from-files to select specific docs, then generate PRPROMPTS. Works great for legacy projects needing standardization.
A: Edit the generated PRPROMPTS files directly. Add team-specific examples, internal wiki links, or custom validation gates. See Customization Guide.
A: Currently yes. The generator is optimized for Flutter with Clean Architecture + BLoC. You can fork and customize for React Native, SwiftUI, etc.
A: Regenerate when:
A: Partially. Qwen Code can run locally (offline). Claude Code and Gemini CLI require internet. All generated files work offline once created.
A: Please report security issues privately to the maintainers. See CONTRIBUTING.md for contact info.
A: Try these steps:
Check Node.js version:
node --version # Should be v20 or higher
Clear npm cache:
npm cache clean --force
npm install -g prprompts-flutter-generator
Use sudo on macOS/Linux (if permission error):
sudo npm install -g prprompts-flutter-generator
On Windows (permission error):
Check installation:
prprompts doctor # Diagnoses all issues
A: Yes, but global install is recommended:
# Local install (in project)
npm install prprompts-flutter-generator
npx prprompts create
# Global install (anywhere) - Recommended
npm install -g prprompts-flutter-generator
prprompts create
A: v4.1 adds enterprise features:
Run prprompts interactive to explore all new features!
A: Simple:
# Check current version
prprompts version
# Update to latest
npm update -g prprompts-flutter-generator
# Or use built-in updater
prprompts update
A: Clean uninstall:
# Uninstall package
npm uninstall -g prprompts-flutter-generator
# Remove config (optional)
rm -rf ~/.prprompts
rm -rf ~/.config/claude/prompts/*prprompts*
rm -rf ~/.config/qwen/prompts/*prprompts*
rm -rf ~/.config/gemini/prompts/*prprompts*
Contributions welcome! See CONTRIBUTING.md for guidelines.
git clone https://github.com/Kandil7/prprompts-flutter-generator.git
cd prprompts-flutter-generator
npm install
./scripts/setup.sh
# Run tests
npm test # Full validation
npm run test:commands # Command availability
/bootstrap-from-prprompts - Complete project setup (2 min)/implement-next - Auto-implement features (10 min each)/full-cycle - Implement 1-10 features automatically/review-and-commit - Validate & commit/qa-check - Comprehensive compliance auditprprompts command)
๐ Documentation |
๐ Issues |
๐ฌ Discussions |
MIT License - see LICENSE file for details.
Full version history: CHANGELOG.md
Made with โค๏ธ for Flutter developers
๐ Major Release: Complete React/React Native to Flutter Conversion
v5.0.0 delivers a production-ready, fully-tested React-to-Flutter refactoring system with intelligent style conversion, complete hooks support, advanced JSX pattern handling, and comprehensive validation.
Major Features:
Quality Metrics:
Deliverables:
Usage:
# Convert React app to Flutter
prprompts refactor ./my-react-app ./my-flutter-app --state-mgmt bloc --ai claude
# What 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, memo โ const)
# โ
BLoC state management
# โ
Comprehensive validation report
# โ
AI-enhanced code (optional)
Bug Fixes:
Status: โ Production Ready - Ready for real-world React-to-Flutter migrations!
The Breakthrough: v4.4.3 achieves perfect multi-AI command parity through automatic TOML file generation. ALL 21 commands (6 PRD + 4 Planning + 5 PRPROMPTS + 6 Automation) now work identically across Claude Code, Qwen Code, and Gemini CLI with zero manual configuration.
New Features:
generate-qwen-command-toml.js and generate-gemini-command-toml.jsTechnical Implementation:
scripts/generate-qwen-command-toml.js - Converts 21 .md files to Qwen .toml formatscripts/generate-gemini-command-toml.js - Converts 21 .md files to Gemini .toml formatscripts/postinstall.js to call generation scripts before file copying/help and Gemini CLI /helpImpact:
What Was Fixed:
v4.4.1 had manifest files but Qwen/Gemini require .toml format for command visibility. v4.4.3 automatically generates these files from markdown sources during installation, ensuring perfect parity without manual maintenance.
Verification:
# After npm install, all 3 AIs show identical output:
qwen /help # Shows all 21 commands
gemini /help # Shows all 21 commands
claude /help # Shows all 21 commands
Documentation:
New Features:
Improvements:
update-plan to both extension manifestsCommands Fixed:
auto-prd-from-project - Now visible in Qwen/Gemini helprefine-prd - Now visible in Qwen/Gemini helpestimate-cost - Now visible in Qwen/Gemini helpanalyze-dependencies - Now visible in Qwen/Gemini helpgenerate-stakeholder-review - Now visible in Qwen/Gemini helpgenerate-implementation-plan - Now visible in Qwen/Gemini helpupdate-plan - Now visible in Qwen/Gemini helpDocumentation:
New Features:
Improvements:
Commands Added:
prprompts interactive - Launch interactive modeprprompts validate-keys - Validate all API keysprprompts setup-keys [ai] - Interactive API key setupprprompts rate-status - Check rate limit usageprprompts history - Browse command historyprprompts history-search - Search previous commands๐ Quick Start โข ๐ฆ Install โข ๐ Docs โข ๐งช Test โข ๐ค AI Guides โข ๐ฌ Support
Powered by Claude Code โข Qwen Code โข Gemini CLI
Built for Flutter with โค๏ธ
FAQs
AI-powered Flutter development with full automation + official extension support - Generate 32 security-audited guides & auto-implement in 2-3 hours. NEW v5.1: Official Claude Code plugin with hooks, Gemini TOML commands, Qwen MCP settings. Features: Comp
The npm package prprompts-flutter-generator receives a total of 18 weekly downloads. As such, prprompts-flutter-generator popularity was classified as not popular.
We found that prprompts-flutter-generator demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.ย It has 1 open source maintainer collaborating on the project.
Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Product
Socket now detects supply chain risks in project manifests, starting with missing lockfiles that can make dependency installs non-reproducible.

Research
/Security News
The trojanized extensions use TinyGo-compiled WebAssembly and Solana transaction memos to resolve command-and-control infrastructure.

Security News
Anthropic says the directive cited national security concerns over a narrow jailbreak, but offered no specific technical details.