PHPackages laravel-blaze/builder - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. laravel-blaze/builder ActiveLibrary[Utility & Helpers](/categories/utility) laravel-blaze/builder ===================== Blaze Laravel Builder - A smart build system for Laravel apps 1.0.8(11mo ago)637MITPHPPHP >=7.4 Since Jun 5Pushed 11mo ago1 watchersCompare [ Source](https://github.com/engineertuhin/Blaze)[ Packagist](https://packagist.org/packages/laravel-blaze/builder)[ RSS](/packages/laravel-blaze-builder/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (10)Used By (0) Blaze Builder for Laravel ========================= [](#blaze-builder-for-laravel) [![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![Laravel](https://camo.githubusercontent.com/9530f0d90478e0b25d5bf5abd6ceb7a17377c3c89704a33f3250b5da82065e59/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382532422d7265642e737667)](https://laravel.com/)[![PHP Version](https://camo.githubusercontent.com/b1bb5560bb0056a3cf9f03a0176a92d1974a97748662aa16b4b5e7b03a17e5e9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e342532422d3737376262342e737667)](https://php.net/) Blaze Builder is a comprehensive, modern asset and build management package for Laravel applications. It streamlines asset compilation, environment configuration, and deployment, supporting both traditional Laravel Mix and the latest Vite.js workflows. --- ✨ Key Features -------------- [](#-key-features) - **Instant Asset Building:** Compile and optimize your assets with a single command. - **Vite.js & Laravel Mix Support:** Effortlessly switch between asset bundlers. - **Zero-Hassle Environment Setup:** Smart .env configuration for any environment. - **Production-Ready:** Optimized for fast, secure, and scalable deployment. - **Flexible Configuration:** Fully customizable via a published config file. - **Seamless Integration:** Works out-of-the-box with existing Laravel projects. - **Detailed Logging:** Transparent build output for easy troubleshooting. - **Automatic Asset Versioning:** Cache-busting for static assets. - **Public Path Management:** Simple handling of asset URLs, even on custom domains. - **Developer Friendly:** Clear documentation, copy-paste commands, and best practices. - **Encrypted App Builds:** Generate encrypted builds so you can share your source without riskβ€”no one can change your source code. - **Device-Specific Builds:** Optionally lock builds to a specific device. These builds will only run on the selected device and nowhere else. - **Interactive Build Lock:** During build, you'll see a prompt: "Do you want to lock this build to this device only?" If you answer "yes", the build will be restricted to the current device. - **Open Source:** MIT licensed and welcomes community contributions. --- πŸ“¦ Installation -------------- [](#-installation) Install Blaze Builder using Composer: ``` composer require laravel-blaze/builder ``` Publish the Blaze configuration file: ``` php artisan vendor:publish --tag=blaze-config --force ``` --- πŸ–₯️ Requirements --------------- [](#️-requirements) - **PHP:** 7.4 or higher - **Laravel:** 8.x, 9.x, or newer - **Composer:** Latest recommended - **Node.js & NPM:** Required for Vite.js or Laravel Mix workflows --- βš™οΈ Environment Configuration ---------------------------- [](#️-environment-configuration) Add the following to your `.env` file: ``` APP_ENV=production APP_DEBUG=false ``` **If using Vite.js, add:** ``` APP_URL=https://example.com ASSET_URL=https://example.com/public ``` > Replace `example.com` with your actual domain. --- πŸ—οΈ Build Process ---------------- [](#️-build-process) Compile and optimize your assets for production: ``` php artisan build ``` - This will handle asset bundling via your configured builder (Vite.js or Laravel Mix). - Output and errors are logged for auditing and debugging. - **Interactive Device Lock:** During this process, you'll be asked: *"Do you want to lock this build to this device only?"* If you choose "yes", the build will only work on this device. - **Encrypted Builds:** You can choose to encrypt your app so your source can be shared, but no one can change your source code. --- πŸ”₯ Supported Workflows --------------------- [](#-supported-workflows) ### Laravel Mix [](#laravel-mix) - Default for Laravel <= 9.x - Supports SASS, LESS, JS, Vue, React, and more ### Vite.js [](#vitejs) - Default for Laravel >= 9.x - Lightning-fast HMR and modern JS ecosystem **Switch workflows in your Blaze config (`blaze.json`) as needed.** --- πŸ› οΈ Blaze Configuration ---------------------- [](#️-blaze-configuration) After publishing, adjust the config in: ``` blaze.json ``` - Set asset builder (Mix/Vite) - Define public paths, asset roots, versioning, and more - Enable/disable logging - Customize build scripts - **Enable Encryption:** Lock your app code from modification - **Set Device Lock:** Restrict build to specific device --- πŸ’‘ Tips & Best Practices --------------------------- [](#-tips--best-practices) - Always set correct `APP_URL` and `ASSET_URL` for asset links and CORS. - Use `APP_ENV=production` and `APP_DEBUG=false` for best security and performance. - Rebuild assets after updating dependencies or changing config. - Check log output if build fails. - Use encryption and device-lock features for extra security when distributing your app. --- πŸ“‹ Copy-Paste Commands --------------------- [](#-copy-paste-commands) ``` # Install Blaze Builder composer require laravel-blaze/builder # Publish config file php artisan vendor:publish --tag=blaze-config --force # Build assets php artisan build ``` --- 🧩 Integration Examples ---------------------- [](#-integration-examples) ### Example: Vite.js with Custom Domain [](#example-vitejs-with-custom-domain) ``` APP_ENV=production APP_URL=https://mydomain.com ASSET_URL=https://cdn.mydomain.com/public ``` ### Example: Updating Build Script [](#example-updating-build-script) Edit `blaze.json` as needed. --- 🚦 Troubleshooting ----------------- [](#-troubleshooting) - **Build fails?** Check the output logs for detailed errors. - **Assets missing?** Confirm `ASSET_URL` and public path in config match your deployment. - **Environment not detected?** Ensure `.env` is up-to-date and permissions are correct. - **Encrypted or device-locked build fails elsewhere?** Make sure you're running on the correct device, and the build hasn't been tampered with. --- πŸ”’ Security Features ------------------- [](#-security-features) ### Encrypted App Builds [](#encrypted-app-builds) - Share your source code securelyβ€”no one can change your code after build. - Useful for distributing apps to clients or partners while protecting your IP. ### Device-Specific Builds [](#device-specific-builds) - Lock builds to a specific device (e.g., server, VM, or developer machine). - Prevents unauthorized copying or running your app elsewhere. - Interactive prompt ensures you don't accidentally lock a build. --- πŸ“ License --------- [](#-license) Blaze Builder is open-source software licensed under the [MIT license](LICENSE). --- 🀝 Contributing -------------- [](#-contributing) Pull requests and issues are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. --- πŸ“’ Support --------- [](#-support) For questions, suggestions, or bugs, open an [issue](https://github.com/engineertuhin/Blaze/issues). --- **Build smarter, deploy faster β€” with Blaze Builder! πŸš€** ### Health Score 31 β€” LowBetter than 68% of packages Maintenance51 Moderate activity, may be stable Popularity14 Limited adoption so far Community7 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 9 Last Release 342d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c85d50eb388f86c15342f00ac57fdc7dc6b97a36bc459a259f4b6a558338bd5e?d=identicon)[engineertuhin](/maintainers/engineertuhin) --- Top Contributors [![engineertuhin](https://avatars.githubusercontent.com/u/55057902?v=4)](https://github.com/engineertuhin "engineertuhin (19 commits)") ### Embed Badge ![Health badge](/badges/laravel-blaze-builder/health.svg) ``` [![Health](https://phpackages.com/badges/laravel-blaze-builder/health.svg)](https://phpackages.com/packages/laravel-blaze-builder) ``` ### Alternatives [thiagomarini/binocular Doing Event Sourcing without building a spaceship 373.0k](/packages/thiagomarini-binocular) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)