flutlock 1.0.0 copy "flutlock: ^1.0.0" to clipboard
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.

2
likes
150
points
21
downloads

Publisher

unverified uploader

Weekly Downloads

A high-performance command-line tool to automate Android app signing for Flutter applications with 8 architecture patterns, keystore management, and CI/CD support.

Repository (GitHub)
View/report issues

Topics

#flutter #android #signing #automation #cli

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

args, json_schema, logging, meta, path, yaml

More

Packages that depend on flutlock