README

Huckle is an HCL-based multi-tenant configuration management package for Laravel. Define structured configurations with partitions, environments, and services — then export them directly to .env files or inject them into your application at runtime.

Key Features

• Multi-Tenant Hierarchies — Organize config by partition/tenant, environment, provider, and service
• HCL Syntax — Type-safe, human-readable configuration with HashiCorp Configuration Language
• Environment Exports — Generate .env files or inject values via putenv() at runtime
• Context-Based Queries — Filter configurations by partition, environment, or custom tags
• Credential Lifecycle — Track expiration dates, rotation schedules, and sensitive value masking
• Encryption Support — Encrypt/decrypt configuration files for secure storage and deployment

Requirements

Requires PHP 8.4+ and Laravel 12+

Installation

composer require cline/huckle

Publish the configuration:

php artisan vendor:publish --tag=huckle-config

Documentation

• Getting Started - Installation, configuration, and basic usage
• Environment Management - Work with multiple environments
• Exports & Syncing - Export to .env files and environment variables
• Connection Commands - Execute database CLI connections
• HCL Conversion - Convert between HCL and JSON formats
• Artisan Commands - All available CLI commands

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.