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

License

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

cline / huckle

Maintainers

Details