docs: update configuration reference

Author: jon-ht

docs/configuration.md

@@ -259,6 +259,26 @@ const config: StorybookConfig = {
              * These options only applies to the dev environment.
              */
             symfony: {
+                /**
+                 * Mandatory, the absolute path of the Symfony application.
+                 * 
+                 * If you are using Docker for your Symfony application,
+                 * it must be the absolute path inside the Docker container.
+                 * In other cases, it must be the absolute path on your host machine.
+                 *
+                 * @example '/var/www/html'
+                 *
+                 * @var string
+                 */
+                projectDir: '',
+                
+                /**
+                 * Mandatory, the absolute path of the Storybook cache path.
+                 *
+                 * @var string
+                 */
+                storybookCachePath: path.resolve(__dirname, '../var/cache/dev/storybook'),
+                
                 /**
                  * Mandatory, the URL of the Symfony development server.
                  * 
@@ -289,7 +309,18 @@ const config: StorybookConfig = {
                 additionalWatchPaths: [
                     'assets',
                     'var/tailwind/tailwind.built.css'
-                ]
+                ],
+
+                /**
+                 * Configure aliases for components paths resolution.
+                 *
+                 * Use this when Storybook and Symfony app are running on different hosts (like Docker).
+                 *
+                 * @var object
+                 */
+                templatePathAliases: {
+                    [path.resolve(__dirname, '..')]: '/var/www/html',
+                }
             }
         },
     },

docs/static-build.md

@@ -2,6 +2,9 @@
 
 Storybook can be built in a static application, to be deployed on a simple web server. The build will contain all stories metadata and the JavaScript used to render the Storybook UI.
 
+> ⚠️ In order to build Storybook, you need to have a running Symfony server.
+> The Symfony server is used to generate "preview.html.twig" iframe.
+
 ## Build Storybook
 
 To build Storybook, use: