Skip to content

Commit c517367

Browse files
Address @patrykgruszka review: scope to Mautic 7.2 and correct DDEV build trigger
- Change 'From Mautic 7' to 'From Mautic 7.2'; the untracked-assets build workflow ships only in 7.2, not 7.0/7.1. - Correct the DDEV bullet: the build runs during initial DDEV provisioning, not on every start; direct existing environments to 'ddev gjs-build'.
1 parent 86d7650 commit c517367

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

docs/themes/grapesjs.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -174,14 +174,14 @@ You can download a :xref:`GrapesJS Demo Plugin` to get you started.
174174
Building the Builder assets
175175
***************************
176176

177-
From Mautic 7, Mautic no longer commits the GrapesJS Builder's compiled JavaScript and CSS to the repository. The build output lives in the Plugin's ``Assets/library/js/dist/`` directory, which ``.gitignore`` now excludes, and Mautic generates it at build time instead - the same way it handles other compiled assets such as ``media/css`` and ``media/js``.
177+
From Mautic 7.2, Mautic no longer commits the GrapesJS Builder's compiled JavaScript and CSS to the repository. The build output lives in the Plugin's ``Assets/library/js/dist/`` directory, which ``.gitignore`` now excludes, and Mautic generates it at build time instead - the same way it handles other compiled assets such as ``media/css`` and ``media/js``.
178178

179179
This matters when you work from a git checkout. After a fresh clone, the ``dist/`` directory doesn't exist yet, so the Builder can't load until you build the assets. Missing assets don't cause Mautic to fail. It logs a warning and skips loading the Builder scripts. Build them before you use the GrapesJS Builder.
180180

181181
Building the assets requires Node, and Mautic builds them with Node 24. In most cases, you don't need to run the build by hand because Mautic builds the assets automatically at these points:
182182

183183
* When you run ``composer install`` or ``composer update``. This step is non-fatal - if Node isn't available, Composer prints a warning and continues, so you can build the assets later.
184-
* When you start the DDEV environment, as part of the bootstrap.
184+
* When DDEV provisions the environment for the first time, not on every start, so for an existing environment, run ``ddev gjs-build`` to rebuild.
185185

186186
To build or rebuild the assets manually with Composer, run:
187187

0 commit comments

Comments
 (0)