# generator-symfony-alchemy

> Gulp recipes for asset management in Symfony applications

Latest version **1.0.1** (published 2015-07-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install generator-symfony-alchemy
pnpm add generator-symfony-alchemy
yarn add generator-symfony-alchemy
bun add generator-symfony-alchemy
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2015-07-14 |
| First published | 2015-07-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.12.0 |
| Dependencies | 4 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Zander Janse van Rensburg |
| Maintainers | blacklight |
| Keywords | yeoman-generator, generator, gulp, symfony, symfony2, gulp-symfony2, assetic, asset management, asset files, assets, css, javascript, fonts, images, build, watch, serve, minify |

## Links

- npm: https://www.npmjs.com/package/generator-symfony-alchemy
- Repository: https://github.com/blacklight-design/generator-symfony-alchemy
- Homepage: https://github.com/blacklight-design/generator-symfony-alchemy#readme
- Issues: https://github.com/blacklight-design/generator-symfony-alchemy/issues
- npm.io page: https://npm.io/package/generator-symfony-alchemy

## Dependencies (4)

- [yo](https://npm.io/package/yo.md) >=1.0.0
- [chalk](https://npm.io/package/chalk.md) ^1.1.0
- [yosay](https://npm.io/package/yosay.md) ^1.0.4
- [yeoman-generator](https://npm.io/package/yeoman-generator.md) ^0.20.1

## Alternatives

- [style-dictionary](https://npm.io/package/style-dictionary.md) — 2.0M weekly downloads
- [postcss-merge-idents](https://npm.io/package/postcss-merge-idents.md) — 1.7M weekly downloads
- [@fontsource/noto-sans](https://npm.io/package/@fontsource/noto-sans.md) — 93.0K weekly downloads
- [uglifycss](https://npm.io/package/uglifycss.md) — 71.6K weekly downloads
- [mat4-interpolate](https://npm.io/package/mat4-interpolate.md) — 23.3K weekly downloads

## Recent versions

- 1.0.1 (latest) — 2015-07-14
- 1.0.0 — 2015-07-14

## README

# Symfony Alchemy

Gulp recipes for asset management in Symfony applications.

## About

Symfony Alchemy comes in the form of a [Yeoman](http://yeoman.io/) generator. If all the dependencies are installed you
can get up and running with some sleek asset management with one simple command.

Check the documentation below for more information.

### Features

- Concatenates JS and CSS
- Minifies JS and CSS
- Optimizes images
- Bower compatible
- Watches files and live reloads via BrowserSync

## Installation

First install all the dependencies:

- Install Node: https://nodejs.org/
- Install Gulp: `npm install -g gulp`
- Install Yeoman: `npm install -g yeoman`
- Install Symfony Alchemy: `npm install -g generator-symfony-alchemy`

Now that all the dependencies are in place you can install Symfony Alchemy. Ensure that you are in the root of your
Symfony2 application and run the following command:

```
yo symfony-alchemy
```

## Usage

To watch for file changes simply run `gulp watch`.

The following commands are also available:

```
gulp js
gulp css
gulp fonts
gulp images
gulp clean
gulp build
```

The difference between `build` and the `default` task is that the build task will minify all assets.

### assets.json

In this file you can specify all the main CSS and JS files you require. You can also specify all the files that should
be included in the making of that file. The structure is as follows:

```
{
  "css": {
    "main.css": [
      "app/Resources/public/css/app.css"
    ]
  },
  "js": {
    "main.js": [
      "app/Resources/public/js/app.js"
    ]
  },
  "replace": {
    "images/": "img/"
  }
}
```

See the included `assets.json` file for more information.

#### replace

Some libraries installed via bower might be looking for files in directories different from Symfony Alchemy's output
directory. The replace section allows you to define simple search and replace strings to try and resolve this during
the build. The format is as follows:

```
<search string>: <replace string>
```

## Changelog

### 1.0.0 (2015-07-14)

Initial Commit

## License

MIT

---
_Source: https://npm.io/package/generator-symfony-alchemy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._