Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/psrpinto/frontend-bundle
A modern frontend development workflow for Symfony apps
https://github.com/psrpinto/frontend-bundle
asset-pipeline front-end frontend gulp symfony
Last synced: 3 months ago
JSON representation
A modern frontend development workflow for Symfony apps
- Host: GitHub
- URL: https://github.com/psrpinto/frontend-bundle
- Owner: psrpinto
- License: mit
- Created: 2015-06-28T17:52:49.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-03-15T16:27:38.000Z (almost 7 years ago)
- Last Synced: 2024-11-02T03:50:31.147Z (3 months ago)
- Topics: asset-pipeline, front-end, frontend, gulp, symfony
- Language: PHP
- Homepage: http://frontend-bundle.rtfd.io
- Size: 157 KB
- Stars: 30
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# frontend-bundle
A modern frontend development workflow for Symfony apps.
# DEPRECATED
This project is deprecated. Use [Webpack Encore](https://symfony.com/doc/current/frontend.html) instead.
> Webpack Encore is a simpler way to integrate Webpack into your Symfony application. It wraps Webpack, giving you a clean & powerful API for bundling JavaScript modules, pre-processing CSS & JS and compiling and minifying assets.
There used to be a time where Symfony had no first-class support for a modern frontend development workflow, which was the problem this bundle was trying to solve. With Webpack Encore that is no longer the case so there is no reason for this bundle to continue to exist. Webpack Encore does it better and is the officially recommended way to integrate frontend technologies into Symfony applications.
---
[](https://travis-ci.org/regularjack/frontend-bundle)
[](https://scrutinizer-ci.com/g/regularjack/frontend-bundle/code-structure)
[](https://scrutinizer-ci.com/g/regularjack/frontend-bundle)
[](https://insight.sensiolabs.com/projects/5f7d6dc7-1dcb-4acf-86b7-eb1564c59939)
[](https://packagist.org/packages/regularjack/frontend-bundle)
[](Resources/meta/LICENSE)
[](https://packagist.org/packages/regularjack/frontend-bundle)
Symfony comes packaged with [Assetic](https://github.com/symfony/AsseticBundle) for managing frontend assets like CSS, JavaScript or images. Assetic is great to quickly start a project but, as applications grow, its limitations start to show.
It has thus become more and more common to integrate tools native to frontend development into Symfony projects (`bower`, `gulp`, `webpack`, `livereload`, etc). However, setting up a seamless frontend development workflow is not easy and developers must repeat themselves every time they start a new project.
[There](https://github.com/romanschejbal/gassetic) [are](https://github.com/Spea/SpBowerBundle) [several](https://github.com/francoispluchino/composer-asset-plugin) [tools](https://github.com/Kunstmaan/KunstmaanLiveReloadBundle) out there that make it easier to do this but they come with their own limitations and many are wrappers for the native frontend development tools. Developers should be able to use the native tools directly and have them just work within their Symfony projects.
This bundle attempts to be the go-to solution for quickly, easily and cleanly setting up a tailored frontend development workflow in Symfony projects.
*Supports PHP 5.4+, Symfony 2.7+*
# Features
* **Asset pipeline**
* Automatically generate the build file for your preferred asset pipeline
* Supports [Gulp](https://github.com/gulpjs/gulp) ([Webpack](https://webpack.github.io/), [Broccoli](https://github.com/broccolijs/broccoli) and others on the way)
* Sensible defaults that work with most Symfony projects
* You can easily adapt it for your use case
* **Use Symfony's native calls to reference assets**
* ``
* No need to clutter your Twig templates with *boundaries* for the asset pipeline
* Assets are automatically *cache-busted* in production
* **Fast development**
* Fast rebuilds make for an efficient workflow
* Only changed files are processed
* No more slow refreshes due to Assetic
* **Livereload**
* Browser updates when you save a file
* Change the CSS, the browser instantaneously updates, without a page reload
* **Bower**
* Frontend dependencies are a `bower install` away
* No more vendor code in your repository
* Automatically generates `vendor.js` and `vendor.css` files from your `bower.json`
* **Cache busting**
* Automatically add a version to assets when in production
* No more need to set a version on every deploy
* An asset's version only changes if its content changed
# Documentation
[View Documentation](http://frontend-bundle.readthedocs.io)
# Contributing
[CONTRIBUTING](CONTRIBUTING.md)