Skip to content

Releases: KalybosPro/env_builder_cli

Release v1.1.6+1

07 Dec 22:04

Choose a tag to compare

Release Notes - Env Builder CLI

v1.1.6+1 (Latest)

Release Date: 12/07/2025

🚀 New Features

  • Assets Command: New env_builder assets command for encrypting and embedding assets directly into Dart code
    • Asset Discovery: Automatically scans assets/ directory for supported files
    • Multi-format Support: Images (PNG, JPG, JPEG, GIF, WebP), Videos (MP4, WebM, MOV, AVI, MKV), and SVGs
    • Compression & Optimization: Automatic image compression and SVG minification (configurable)
    • Encryption Options: XOR (fast, default) and AES (secure) encryption methods
    • Zero Runtime Dependencies: Assets embedded as constants, no pubspec.yaml changes needed

🔧 Generated APIs

  • Raw Access: Direct access to encrypted asset data (Uint8List/String)
  • Widget Helpers: Pre-built widgets for images, SVGs, and video controllers
  • Flutter_gen Compatible: Drop-in replacement API with the same structure as flutter_gen

📖 Usage Examples

# Encrypt and embed assets with XOR encryption (default)
env_builder assets

# Use AES encryption for sensitive assets
env_builder assets --encrypt=aes

# Skip compression and minification
env_builder assets --no-compress

# Verbose output during generation
env_builder assets --verbose

💻 Generated Code Usage

import 'package:app_assets/src/generated/assets.gen.dart';

// Access encrypted assets
final logoBytes = Assets.logo; // Uint8List
final videoPlayer = await Assets.videos.intro.video(); // VideoPlayer widget
final svgPicture = Assets.svgs.icon.svg(); // SvgPicture widget

// Flutter_gen compatible API
final image = Assets.images.logo; // AssetGenImage

🔒 Security & Performance

  • Encrypted Storage: All assets are encrypted before embedding
  • Type Safety: Compile-time safe access prevents typos
  • No Runtime Overhead: Assets loaded from memory, no file I/O operations
  • Build-time Only: Encryption/decryption happens at build time only

📋 Compatibility

  • Dart SDK: ^3.8.1+
  • Flutter: Compatible with existing projects
  • Backward Compatible: All existing features remain unchanged

Release v1.1.5

20 Nov 12:26

Choose a tag to compare

Release Notes - Env Builder CLI

v1.1.5 (Latest)

Release Date: 20/11/2025

Changes

  • Command Structure Refactoring: Reorganized the command structure to make apk and aab commands independent top-level commands instead of being subcommands of the build command.
    • Before: env_builder build apk, env_builder build aab
    • After: env_builder apk, env_builder aab
  • Build Command Fix: Fixed issue where running env_builder build --env-file=.env without a subcommand would result in "Missing subcommand" error. Now the build command can be used directly for generating env packages.

New Usage

# Build env package
env_builder build --env-file=.env

# Build APK
env_builder apk

# Build AAB
env_builder aab

Previous Versions

v1.1.4

  • Added APK build command (env_builder apk) for building Flutter APKs with release obfuscation
  • Added AAB build command (env_builder aab) for building Flutter AABs with release obfuscation

v1.1.3

  • Added --output-dir option for custom output directories
  • Added --no-encrypt flag to skip sensitive variable encryption
  • Added --verbose flag for detailed build output

v1.1.2

  • Refactored code structure for improved maintainability
  • Updated example package structure
  • Modified env package generation process

v1.1.1

  • Added user prompt for .env file encryption
  • Fixed bugs

v1.1.0

  • Added environment file encryption/decryption with AES
  • Improved error handling for invalid/corrupted files
  • Updated README with usage examples

v1.0.0

  • Initial release with basic env package generation functionality

Release v1.1.4

20 Nov 10:54

Choose a tag to compare

🚀 Exciting news! I'm happy to announce the release of env_builder_cli v1.1.4!

This Flutter CLI tool continues to simplify environment file management for Flutter developers by automatically creating and maintaining the env package from multiple .env files.

✨ New Features in v1.1.4:

• env_builder apk: Build Flutter APKs with release obfuscation
• env_builder aab: Build Flutter AABs with release obfuscation

🔧 Installation/Upgrade:
dart pub global activate env_builder_cli

📖 Learn more and contribute: https://github.com/KalybosPro/env_builder_cli

If you're building Flutter apps and dealing with environment variables, give this tool a try! It's been a game-changer for my workflow.

#Flutter #DartLang #CLI #DeveloperTools #OpenSource

Release v1.1.3

19 Nov 08:17

Choose a tag to compare

Release Notes - v1.1.3

Overview

Env Builder CLI v1.1.3 introduces new command-line options to provide more flexibility and control over the build process.

New Features

--output-dir Option

  • Allows specifying a custom output directory for the generated environment package
  • Default remains env if not specified
  • Usage: env_builder build --output-dir=custom_env

--no-encrypt Option

  • Skips the encryption prompts for sensitive variables
  • Useful for automated builds or when encryption is not needed
  • Usage: env_builder build --no-encrypt

--verbose Option

  • Enables detailed output during the build process
  • Provides more information for troubleshooting and monitoring
  • Usage: env_builder build --verbose

Usage Examples

# Build with custom directory
env_builder build --output-dir=my_env_package

# Build without encryption prompts
env_builder build --no-encrypt

# Build with detailed logging
env_builder build --verbose

# Combine options
env_builder build --output-dir=custom --no-encrypt --verbose

Improvements

  • Enhanced error handling for missing directories
  • Better user prompts for encryption decisions
  • Improved logging for debugging purposes

For more information, see the full documentation and CHANGELOG.

Release v1.1.2

16 Oct 10:50

Choose a tag to compare

Release Note v1.1.2

Changes

  • Refactored code structure for improved maintainability
  • Updated example package structure
  • Modified the env package generation's command

Release V1.1.1

10 Oct 08:00

Choose a tag to compare

With this env_builder_cli release, user will be asked if he want to encrypt .env files in his generated env package.
If yes, his must choose a secret code that he must not forget. That secret code will be needed while decrypting the encrypted files.

Release v1.1.0 – Env Builder CLI

22 Sep 13:43

Choose a tag to compare

🚀 Release v1.1.0 – Env Builder CLI

env_builder_cli is a Dart command-line tool that automates environment file management in Flutter projects and now includes built-in encryption/decryption support for .env files.

✨ Features

  • Manage multiple .env files (.env, .env.development, .env.production, .env.staging, etc.).
  • Automatically generate a Flutter env package inside packages/env/.
  • Generate Dart files (env.dev.dart, env.prod.dart, etc.) with Envied annotations.
  • Auto-update dependencies in pubspec.yaml and run flutter pub get.
  • Minimal and clean CLI output.

🔒 New: Environment File Encryption / Decryption

  • AES-based encryption with a password-derived key.
  • Protect sensitive data such as API keys, tokens, and database credentials.
  • CLI commands for quick usage:
# Encrypt
env_builder encrypt .env .env.enc --password superSecretKey  

# Decrypt
env_builder decrypt .env.enc .env --password superSecretKey
  • If the password is invalid or the file is corrupted, a clear error message is shown.
  • Recommended workflow: commit only the encrypted .env.enc file, not the decrypted .env.

🛠️ Prerequisites

  • Flutter SDK installed and added to your system PATH
  • Install env_builder_cli from pub.dev
dart pub global activate env_builder_cli

✅ With this release, you can safely share environment files across teams and automate their integration into Flutter projects.