From b793f48f8264318add92daa73c83c3608e4aa4b4 Mon Sep 17 00:00:00 2001
From: Cosimo Damiano Prete <nar92uto@gmail.com>
Date: Fri, 19 Jun 2026 13:20:49 +0200
Subject: [PATCH] chore: Add 'localNpm' build profile to allow to build the UI
 with the already installed Node and NPM instead of downloading it since the
 download may be blocked (e.g.: in corporate environments) and 'npm.registry'
 Maven property to allow to change the registry to use

---
 pom.xml                             |  6 ++
 spring-boot-admin-server-ui/pom.xml | 92 +++++++++++++++++++++++++++--
 2 files changed, 94 insertions(+), 4 deletions(-)

diff --git a/pom.xml b/pom.xml
index ed5ada13100..073d28436b9 100644
--- a/pom.xml
+++ b/pom.xml
@@ -88,6 +88,7 @@
         <spring-javaformat-maven-plugin.version>0.0.47</spring-javaformat-maven-plugin.version>
         <central-publishing-maven-plugin.version>0.10.0</central-publishing-maven-plugin.version>
         <spring-conf-prop-documenter-maven-plugin.version>0.7.2</spring-conf-prop-documenter-maven-plugin.version>
+        <exec-maven-plugin.version>3.6.3</exec-maven-plugin.version>
     </properties>
 
     <modules>
@@ -432,6 +433,11 @@
                     <artifactId>spring-configuration-property-documenter-maven-plugin</artifactId>
                     <version>${spring-conf-prop-documenter-maven-plugin.version}</version>
                 </plugin>
+                <plugin>
+                    <groupId>org.codehaus.mojo</groupId>
+                    <artifactId>exec-maven-plugin</artifactId>
+                    <version>${exec-maven-plugin.version}</version>
+                </plugin>
             </plugins>
         </pluginManagement>
     </build>
diff --git a/spring-boot-admin-server-ui/pom.xml b/spring-boot-admin-server-ui/pom.xml
index 6c8ef950d6a..8dd6fd44ca2 100644
--- a/spring-boot-admin-server-ui/pom.xml
+++ b/spring-boot-admin-server-ui/pom.xml
@@ -33,6 +33,13 @@
 
     <properties>
         <ui-resources.relative-path>META-INF/spring-boot-admin-server-ui</ui-resources.relative-path>
+
+        <npm.install.args>ci --prefer-offline --no-progress --no-audit --silent</npm.install.args>
+        <npm.build.args>run build</npm.build.args>
+        <npm.lint.args>run lint</npm.lint.args>
+        <npm.test.args>run test</npm.test.args>
+        <!-- To be set explicitly with -Dnpm.registry=https://foo.bar if the standard registry is not wanted or not accessible -->
+        <npm.registry />
     </properties>
 
     <dependencies>
@@ -122,6 +129,83 @@
                 </plugins>
             </build>
         </profile>
+        <!--
+        Profile: localNpm
+        Set this profile to run frontend related build steps using the local NPM installation.
+        Skipping frontend tests can be achieved by using default flag -D skipTests.
+        -->
+        <profile>
+            <id>localNpm</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>com.github.eirslett</groupId>
+                        <artifactId>frontend-maven-plugin</artifactId>
+                        <configuration>
+                            <skip>true</skip>
+                        </configuration>
+                    </plugin>
+
+                    <plugin>
+                        <groupId>org.codehaus.mojo</groupId>
+                        <artifactId>exec-maven-plugin</artifactId>
+                        <executions>
+                            <execution>
+                                <id>npm-install</id>
+                                <phase>generate-resources</phase>
+                                <goals>
+                                    <goal>exec</goal>
+                                </goals>
+                                <configuration>
+                                    <executable>npm</executable>
+                                    <commandlineArgs>${npm.install.args}</commandlineArgs>
+                                    <environmentVariables>
+                                        <NPM_CONFIG_REGISTRY>${npm.registry}</NPM_CONFIG_REGISTRY>
+                                    </environmentVariables>
+                                </configuration>
+                            </execution>
+                            <execution>
+                                <id>npm-build</id>
+                                <phase>generate-resources</phase>
+                                <goals>
+                                    <goal>exec</goal>
+                                </goals>
+                                <configuration>
+                                    <executable>npm</executable>
+                                    <commandlineArgs>${npm.build.args}</commandlineArgs>
+                                    <environmentVariables>
+                                        <PROJECT_VERSION>${project.version}</PROJECT_VERSION>
+                                    </environmentVariables>
+                                </configuration>
+                            </execution>
+                            <execution>
+                                <id>npm-lint</id>
+                                <phase>verify</phase>
+                                <goals>
+                                    <goal>exec</goal>
+                                </goals>
+                                <configuration>
+                                    <executable>npm</executable>
+                                    <commandlineArgs>${npm.lint.args}</commandlineArgs>
+                                </configuration>
+                            </execution>
+                            <execution>
+                                <id>npm-test</id>
+                                <phase>test</phase>
+                                <goals>
+                                    <goal>exec</goal>
+                                </goals>
+                                <configuration>
+                                    <skip>${skipTests}</skip>
+                                    <executable>npm</executable>
+                                    <commandlineArgs>${npm.test.args}</commandlineArgs>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
     </profiles>
 
     <build>
@@ -155,7 +239,7 @@
                             <goal>npm</goal>
                         </goals>
                         <configuration>
-                            <arguments>ci --prefer-offline --no-progress --no-audit --silent</arguments>
+                            <arguments>${npm.install.args}</arguments>
                         </configuration>
                     </execution>
                     <execution>
@@ -164,7 +248,7 @@
                             <goal>npm</goal>
                         </goals>
                         <configuration>
-                            <arguments>run build</arguments>
+                            <arguments>${npm.build.args}</arguments>
                             <environmentVariables>
                                 <PROJECT_VERSION>${project.version}</PROJECT_VERSION>
                             </environmentVariables>
@@ -177,7 +261,7 @@
                         </goals>
                         <phase>verify</phase>
                         <configuration>
-                            <arguments>run lint</arguments>
+                            <arguments>${npm.lint.args}</arguments>
                         </configuration>
                     </execution>
                     <execution>
@@ -187,7 +271,7 @@
                         </goals>
                         <phase>test</phase>
                         <configuration>
-                            <arguments>run test</arguments>
+                            <arguments>${npm.test.args}</arguments>
                         </configuration>
                     </execution>
                 </executions>