flutlock 1.0.0
flutlock: ^1.0.0 copied to clipboard
A high-performance command-line tool to automate Android app signing for Flutter applications with 8 architecture patterns, keystore management, and CI/CD support.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2025-07-30 #
Added #
π Core Features
- Complete Android app signing automation for Flutter applications
- Keystore management with generation and validation capabilities
- Key properties file generation with automatic configuration
- Gradle integration for app-level build.gradle and build.gradle.kts files
- Flutter build automation for APK and App Bundle (AAB) generation
- Signature verification using Android SDK tools
- Cross-platform support for Windows, macOS, and Linux
ποΈ Architecture Generation System
- 8 Flutter architecture patterns with complete project structure generation:
- Flat/Simple Structure: Basic lib/ organization with minimal folder structure
- Layered Architecture: Organized by technical layers with GetX integration
- Feature-First Architecture: Vertical slicing by features with Provider and HTTP
- BLoC Architecture: Business Logic Component pattern with state management
- MVVM Architecture: Model-View-ViewModel pattern with Provider
- Clean Architecture: Domain-driven design with clear layer separation
- Feature Wise Clean Architecture: Hybrid approach combining Feature-First with Clean Architecture (36 folders, 43 files)
- Redux Architecture: Redux pattern with actions, reducers, and store
- Automatic dependency management with pubspec.yaml updates
- Template system with 43+ boilerplate files and proper imports
- CLI integration with
--architecture
and--list-architectures
options
π§ Project Setup & Analysis
- Interactive project setup with guided configuration
- Project structure analysis and validation
- Automatic file generation using 5 built-in templates
- Safety features with automatic backup of existing files
- Structure validation and repair capabilities
- Template management with CLI commands
β‘ Performance & Developer Experience
- 70x faster startup compared to Python implementation (7ms cold start)
- 40% less memory usage with native Dart compilation (~15MB memory footprint)
- 164 comprehensive tests ensuring reliability and stability
- Strong type safety with Dart's advanced type system
- Rich CLI interface with 25+ command-line options
- JSON schema validation for configuration files
- Comprehensive error handling with clear, actionable messages
π οΈ CLI Features
- Non-interactive mode for CI/CD pipelines
- Environment variable support for secure credential management
- Dry-run capabilities for safe testing
- Verbose logging with multiple log levels
- Configuration templates (basic, environment, minimal)
- Dependency checking with
--check-deps
command - Template validation with
--validate-templates
command
Technical Details #
Dependencies
- args: ^2.4.2 - Command-line argument parsing
- path: ^1.8.3 - Cross-platform path manipulation
- json_schema: ^5.1.1 - JSON schema validation
- logging: ^1.2.0 - Structured logging
- yaml: ^3.1.2 - YAML file processing
- meta: ^1.9.1 - Dart metadata annotations
Development Dependencies
- test: ^1.24.0 - Testing framework
- lints: ^2.1.0 - Dart linting rules
System Requirements
- Dart SDK: >=2.17.0 <4.0.0
- Flutter SDK: Latest stable version
- JDK: 8+ (for keystore operations)
- Android SDK: Optional (for signature verification)
Performance Metrics #
- Startup time: 7ms (vs 500ms Python implementation)
- Memory usage: ~15MB (vs 25MB Python implementation)
- Test coverage: 164 tests covering all functionality
- Build time: <2 seconds for complete project setup
Breaking Changes #
- This is the initial release, no breaking changes from previous versions
Migration Guide #
- From Python FlutLock: All commands and options are compatible
- New users: Follow the installation guide in README.md
Known Issues #
- None reported in this release
Contributors #
- Initial implementation and architecture design
- Comprehensive testing and validation
- Documentation and examples
For more information about each release, see the GitHub releases page.