frontend.rst

Managing CSS and JavaScript

Symfony ships with a pure-JavaScript library - called Webpack Encore - that makes working with CSS and JavaScript a joy. You can use it, use something else, or just create static CSS and JS files in your web/ directory and include them in your templates.

Webpack Encore

Webpack Encore is a simpler way to integrate Webpack into your application. It wraps Webpack, giving you a clean & powerful API for bundling JavaScript modules, pre-processing CSS & JS and compiling and minifying assets. Encore gives you professional asset system that's a delight to use.

Encore is inspired by Webpacker and Mix, but stays in the spirit of Webpack: using its features, concepts and naming conventions for a familiar feel. It aims to solve the most common Webpack use cases.

Tip

Encore is made by Symfony and works beautifully in Symfony applications. But it can easily be used in any application... in any language!

Encore Documentation

Getting Started

• :doc:`Installation </frontend/encore/installation>`
• :doc:`First Example </frontend/encore/simple-example>`

Adding more Features

• :doc:`CSS Preprocessors: Sass, LESS, etc </frontend/encore/css-preprocessors>`
• :doc:`PostCSS and autoprefixing </frontend/encore/postcss>`
• :doc:`Enabling React.js </frontend/encore/reactjs>`
• :doc:`Enabling Vue.js (vue-loader) </frontend/encore/vuejs>`
• :doc:`Configuring Babel </frontend/encore/babel>`
• :doc:`Source maps </frontend/encore/sourcemaps>`
• :doc:`Enabling TypeScript (ts-loader) </frontend/encore/typescript>`

Optimizing

• :doc:`Versioning (and the manifest.json file) </frontend/encore/versioning>`
• :doc:`Using A CDN </frontend/encore/cdn>`
• :doc:`Creating a "Shared" entry for re-used modules </frontend/encore/shared-entry>`

Guides

• :doc:`Using Bootstrap CSS & JS </frontend/encore/bootstrap>`
• :doc:`Creating Page-Specific CSS/JS </frontend/encore/page-specific-assets>`
• :doc:`jQuery and Legacy Applications </frontend/encore/legacy-apps>`
• :doc:`Passing Information from Twig to JavaScript </frontend/encore/server-data>`
• :doc:`webpack-dev-server and Hot Module Replacement (HMR) </frontend/encore/dev-server>`
• :doc:`Adding custom loaders & plugins </frontend/encore/custom-loaders-plugins>`
• :doc:`Advanced Webpack Configuration </frontend/encore/advanced-config>`

Issues & Questions

• :doc:`FAQ & Common Issues </frontend/encore/faq>`
• :doc:`/frontend/encore/versus-assetic`

Full API

• Full API: https://github.com/symfony/webpack-encore/blob/master/index.js

Assetic

Assetic is a pure PHP library that helps to process & optimize your assets (similar to Encore). Even though we recommend using Encore, Assetic still works great. For a comparison, see :doc:`/frontend/encore/versus-assetic`.

For more about Assetic, see :doc:`/assetic`.

Other Front-End Articles

.. toctree::
    :hidden:
    :glob:

    frontend/encore/installation
    frontend/encore/simple-example
    frontend/encore/*

.. toctree::
    :maxdepth: 1
    :glob:

    frontend/*