CPS-IT / frontend-asset-handler

Composer library to download and extract Frontend assets in Composer projects

Frontend Asset Handler

📦 Packagist | 💾 Repository | 🐛 Issue tracker

A Composer library that downloads and extracts Frontend assets to a dedicated path in PHP projects. All Frontend assets are configured through an assets.json file and can be easily maintained by a dedicated CLI application.

🚀 Features

• Command-line application to fetch Frontend assets
• Asset configuration via assets.json file
• Automated integration into CI systems
• Easy extensible by custom asset providers and processors
• Designed for dependency injection

🔥 Getting started

1. Install the library:

   composer require cpsit/frontend-asset-handler

2. Initialize a new assets.json file:

   vendor/bin/frontend-assets init

3. Fetch Frontend assets:

   vendor/bin/frontend-assets fetch

📖 Documentation

• Installation
• Usage
  • Command-line usage
    • Configure assets
    • Fetch assets
    • Initialize config
    • Inspect assets
  • API usage
• Configuration
  • Full reference
  • Source
  • Target
  • VCS
  • Environments
• Shipped components
  • Providers
  • Processors
  • Handlers
  • VCS Providers
  • Placeholder Processors
  • Environment Transformers
• Dependency injection
• Migration

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

💎 Credits

Direct download icons created by Pixel perfect - Flaticon

⭐ License

This project is licensed under GNU General Public License 3.0 (or later).