The Contribution Guide


This section is based on the great Symfony documentation.

How to install Sylius to contribute?

Before you start contributing you need to have your own local environment for editing things.

To install Sylius main application from our main repository and contribute, run the following command:

$ composer create-project sylius/sylius

This will create a new sylius project in the sylius directory. When all the dependencies are installed, you’ll be asked to fill the parameters.yml file via an interactive script. Please follow the steps. If you hit enter, the default values will be loaded.

Creating the "app/config/parameters.yml" file
Some parameters are missing. Please provide them.
database_driver (pdo_mysql): # - provide a database driver that you are willing to use
database_host (
database_port (null):
database_name (sylius): # - you should rename the database to for instance `my_custom_application_name`
database_user (root): # - provide the database user and password
database_password (null): 1234
mailer_transport (smtp): # - if you will be testing e-mails please provide here your test account data, use `gmail` as transport for example.
mailer_host (
mailer_user (null): # - your test email
mailer_password (null): # - and password
secret (EDITME):

After everything is in place, run the following commands:

$ cd sylius # Move to the newly created directory
$ php bin/console sylius:install

The sylius:install command actually runs several other commands, which will ask you some questions and check if everything is setup to run Sylius properly.

This package contains our main Sylius development repository, with all the components and bundles in the src/ folder.

In order to see a fully functional frontend you will need to install its assets.

Sylius already has a gulpfile.js, therefore you just need to get Gulp using Node.js.

Having Node.js installed go to your project directory and run:

$ yarn install

And now you can use gulp for installing views, by just running a simple command:

$ yarn run gulp

For the contributing process questions, please refer to the Contributing Guide that comes up in the following chapters:

How to contribute using Sylius Vagrant

If you would like to contribute to the repo without worrying about environment, you can follow the “Configure Vagrant to contribute on Sylius Core” section here to setup your vagrant machine.