🎯 flutter_blueprint #

Enterprise-grade Flutter app scaffolding CLI — generates production-ready Flutter projects with 43+ professional files, complete architecture, and best practices.

📱 Note: CLI runs on desktop (Windows/Linux/macOS) to generate Flutter projects that support all platforms (Android, iOS, Web, Desktop).

🎉 What's New in v2.0 #

Major architectural improvements and production-ready features:

See CHANGELOG.md for complete details.

🚀 Quick Start #

Installation #

# Windows (PowerShell)
iex (irm 'https://rawgit.flutter-io.cn/chirag640/flutter_blueprint-Package/main/scripts/install.ps1')

# macOS / Linux
dart pub global activate flutter_blueprint

Create a Project #

# Interactive wizard (recommended)
flutter_blueprint init

# Quick mode with options
flutter_blueprint init my_app --state riverpod --api --theme --tests

✨ Key Features #

🎯 Production-Ready Features #

When you generate a project with --api flag, you get complete working features with zero placeholders:

🏠 Home Feature #

• API Integration: Real data from JSONPlaceholder demo API
• Pagination: Load more with infinite scroll
• Caching: 1-hour TTL with offline-first pattern
• UI: Pull-to-refresh, loading states, error handling

🔐 Authentication Feature (with --api) #

• Login & Register: Complete forms with validation
• Token Management: JWT access + refresh tokens, secure storage
• Auto-login: Checks auth status on app startup
• UI: Beautiful login/register pages, error messages, loading states

👤 Profile Feature (with --api) #

• View Profile: Display user info with avatar
• Edit Profile: Update name, bio, phone, location
• Avatar Upload: Image picker integration (demo mode)
• Caching: Offline-first with 1-hour TTL

⚙️ Settings Feature (always included) #

• Theme Switcher: Light, Dark, System modes
• Notifications: Toggle push notifications
• Biometrics: Enable/disable biometric login
• Account: Profile link, Logout (if auth enabled)
• About: Version, Terms, Privacy Policy
• Data Management: Clear all cached data

🔒 Security Features (v2.0+) #

flutter_blueprint generates enterprise-grade security out of the box:

🛡️ Security Headers #

• X-Content-Type-Options: Prevents MIME-sniffing attacks
• X-Frame-Options: Clickjacking protection (DENY)
• X-XSS-Protection: Legacy XSS protection layer
• Strict-Transport-Security: Forces HTTPS (1 year + subdomains)
• Cache-Control: Prevents sensitive data caching

🔐 Certificate Pinning #

Prevent MITM attacks with SHA-256 fingerprint validation:

final dio = ApiClient(
  baseUrl: 'https://api.example.com',
  certificatePins: ['sha256/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA='],
).dio;

🚦 Rate Limiting #

Client-side protection with 60 requests/minute per endpoint:

• Automatic retry-after calculation
• Rolling window tracking
• Prevents API abuse

🧹 Error Sanitization #

Security interceptor automatically removes:

• File paths (Windows/Unix)
• IP addresses (IPv4/IPv6)
• Long tokens (32+ characters)
• SSRF prevention (blocks localhost in production)

✅ Security Validation #

Built-in security audit helper:

final result = SecurityConfig.checkSecurityConfiguration(dio);
print('Security checks: ${result.passed} passed, ${result.issues.length} issues');

🛠️ CLI Commands #

init - Create New Project #

flutter_blueprint init <app_name> [options]

🔌 API Backend Presets #

When --api is enabled, choose from built-in presets:

• Modern REST - HTTP 200 + JSON data
• Legacy .NET - success: true/false pattern
• Laravel - data wrapper, message field
• Django REST - results array, detail errors
• Custom - manual configuration

add feature - Add Features to Existing Project #

flutter_blueprint add feature <name> [--api] [--no-data] [--no-domain]

📁 Generated Structure #

my_app/
├── lib/
│   ├── main.dart
│   ├── app/app.dart
│   ├── core/
│   │   ├── api/          # API client + interceptors
│   │   ├── config/       # App config + env loader
│   │   ├── errors/       # Exceptions + failures
│   │   ├── routing/      # Router + guards
│   │   ├── storage/      # Local + secure storage
│   │   ├── theme/        # Colors, typography, themes
│   │   ├── utils/        # Logger, validators, extensions
│   │   └── widgets/      # Reusable UI components
│   └── features/         # Feature modules
├── test/                 # Test scaffolding
└── pubspec.yaml

💾 Data Layer Features (v2.0+) #

Smart Caching #

Production-ready cache implementation with SharedPreferences:

// Auto-generated cache methods
final items = await localDataSource.getCached();  // Returns List<T> or null
await localDataSource.cache(items);              // JSON serialization
await localDataSource.clearCache();              // Clear cache

• Automatic JSON serialization/deserialization
• Error recovery (auto-clears corrupted cache)
• Type-safe operations

Auth Token Management #

Flexible token handling with callback-based interceptors:

final dio = ApiClient(
  baseUrl: 'https://api.example.com',
  getToken: () async => await storage.getToken(),
  refreshToken: () async => await authService.refresh(),
).dio;

• Automatic 401 handling with token refresh
• Request retry after refresh
• Works with any auth strategy (OAuth, JWT, custom)

Offline Sync #

Hive-based offline support with API synchronization:

• Queue changes while offline
• Auto-sync when connection restored
• Conflict resolution strategies

🤝 Team Collaboration #

Share configurations across your team:

# Import team config
flutter_blueprint share import ./company_standard.yaml

# Create project from config
flutter_blueprint init my_app --from-config company_standard

📚 Documentation #

• Architecture Guide - Deep dive into v2.0 architecture
• Example Usage - Programmatic API examples
• Contributing Guide - How to contribute
• Changelog - Version history

📄 License #

MIT License - see LICENSE

💬 Support #

• 📧 Email: chaudharychirag640@gmail.com
• 🐛 GitHub Issues
• 💬 Discussions

Made with ❤️ for the Flutter community ⭐