feat: document frontendExtraFileExtensions

articles/flow/configuration/development-mode/index.adoc

@@ -58,6 +58,25 @@
 
 This is the default mode.
 
+In case the project uses for instance SASS files instead of CSS, the files are not by default taken into account in the bundle contents.
+To have the bundle include the `.scss` file content the plugin contains the configuration property `frontendExtraFileExtensions` that takes a comma separated string of extensions to take into account for bundle frontend files.
+
+The default values `'.js', '.js.map', '.ts', '.ts.map', '.tsx', '.tsx.map', '.css', '.css.map'` will always be used and do not need to be mentioned.
+
+.SASS in the project
+[source,xml]
+----
+<plugin>
+    <groupId>com.vaadin</groupId>
+    <artifactId>vaadin-maven-plugin</artifactId>
+    <!-- plugin goals and other configuration  -->
+    <configuration>
+        <frontendExtraFileExtensions>scss</frontendExtraFileExtensions>
+    </configuration>
+</plugin>
+----
+
+Extensions can also be set as a system property `-Ddevmode.frontendExtraFileExtensions="scss"`, the property works for both the development mode bundle and production mode bundle.
 
 == Easier Debugging
 

articles/flow/configuration/maven.adoc

@@ -106,6 +106,8 @@ Build directory for the project. Defaults to `${project.build.directory}`.
 `skipDevBundleRebuild`::
 Prevents frontend development bundle from being re-built even if Vaadin decides to use an existing compiled development bundle. This is mainly needed when re-bundling checker in Flow has issues leading to false re-bundling and one needs a workaround while the problem is being resolved. Defaults to `false`.
 
+`frontendExtraFileExtensions`::
+Parameter for adding file extensions to handle when generating bundles.
 
 === Build Frontend Goal Parameters
 

articles/flow/production/production-build.adoc

@@ -82,7 +82,6 @@
                             <goals>
                                 <goal>build-frontend</goal>
                             </goals>
-                            <phase>compile</phase>
                         </execution>
                     </executions>
                     <configuration>
@@ -183,6 +182,9 @@
 `require.home.node` (default: `false`)::
 If set to `true`, always prefer `Node.js` is automatically downloaded and installed into the `.vaadin` sub-directory, in the user's home directory.
 
+`frontendExtraFileExtensions` (default: `null`)::
+Parameter for adding extensions of files to be stored in the stats.json of a generated bundle.
+For instance if the project uses scss files they are not automatically taken into account in the bundle hashes.
 
 === `build-frontend`
 
@@ -228,6 +230,10 @@
 `reactEnable` (default: `true`)::
 Whether to use React Router, add React core dependencies, React integration helpers and Vaadin's provided React components (`@vaadin/react-components`). Fallbacks to `vaadin-router`, excludes all React dependencies and adds `Lit` dependencies, if set to `false`.
 
+`frontendExtraFileExtensions` (default: `null`)::
+Parameter for adding extensions of files to be stored in the stats.json of a generated bundle.
+For instance if the project uses scss files they are not automatically taken into account in the bundle hashes.
+
 
 === `clean-frontend`