init

Init — Sylius Stack

Ask the user for the project directory name if not provided.

1. Create the Symfony project

composer create-project symfony/skeleton:"8.0.*" {project_directory}
cd {project_directory}
composer require webapp

2. Allow contrib recipes

composer config extra.symfony.allow-contrib true

3. Install Sylius Stack packages

composer require -W \
  doctrine/orm \
  doctrine/doctrine-bundle \
  pagerfanta/doctrine-orm-adapter \
  symfony/asset-mapper \
  sylius/bootstrap-admin-ui \
  sylius/ui-translations

When prompted by Symfony Flex, type a or p to apply all recipes automatically.

4. Configure the app secret

In .env, set a real secret:

APP_SECRET=UseYourOwnSecretPlease

5. Configure AssetMapper

Since sylius/bootstrap-admin-ui auto-initializes Stimulus and injects its own stylesheets, you need to take control of that to avoid duplicate Ajax calls.

Disable the default Stimulus app and Symfony UX stylesheets, and register your own JS hook in config/packages/sylius_bootstrap_admin_ui.yaml :

# config/packages/sylius_bootstrap_admin_ui.yaml
sylius_twig_hooks:
    hooks:
        'sylius_admin.base#stylesheets':
            symfony_ux:
                enabled: false
        'sylius_admin.base#javascripts':
            app:
                priority: 200
                template: 'base/javascripts/app.html.twig'
            symfony_ux:
                enabled: false

Create the template that loads your AssetMapper entry point:

{# templates/base/javascripts/app.html.twig #}
{{ importmap('app') }}

Make sure your Stimulus app is started in assets/bootstrap.js:

// assets/bootstrap.js
import { startStimulusApp } from '@symfony/stimulus-bundle';

const app = startStimulusApp();

And imported in assets/app.js:

// assets/app.js
import './bootstrap.js';

6. Start the stack and configure the database URL

docker compose up -d