webforj · EHandtkeBasis · Aug 8, 2025 · Aug 14, 2025 · Aug 14, 2025 · Aug 14, 2025
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,4 @@
+{
+    "java.project.sourcePaths": [],
+    "java.configuration.updateBuildConfiguration": "interactive"
+}
diff --git a/1-creating-a-basic-app/.editorconfig b/1-creating-a-basic-app/.editorconfig
@@ -0,0 +1,15 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+insert_final_newline = false
+trim_trailing_whitespace = false
diff --git a/1-creating-a-basic-app/.gitignore b/1-creating-a-basic-app/.gitignore
@@ -0,0 +1,44 @@
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+replay_pid*
+
+**/target
+/.idea
+/.claude
+*.iml
+/.project
+/.classpath
+**/sample/
+
+/.settings/org.eclipse.core.resources.prefs
+/.settings/org.eclipse.jdt.core.prefs
+/.settings/org.eclipse.m2e.core.prefs
+
+bbj/.bdtPath
+bbj/.buildpath
+bbj/.project
+
+.DS_Store
+*.versionsBackup
+
diff --git a/1-creating-a-basic-app/.vscode/settings.json b/1-creating-a-basic-app/.vscode/settings.json
@@ -0,0 +1,26 @@
+{
+  "java.configuration.updateBuildConfiguration": "interactive",
+  "java.completion.favoriteStaticMembers": [
+    "org.junit.Assert.*",
+    "org.junit.Assume.*",
+    "org.junit.jupiter.api.Assertions.*",
+    "org.junit.jupiter.api.Assumptions.*",
+    "org.junit.jupiter.api.DynamicContainer.*",
+    "org.junit.jupiter.api.DynamicTest.*",
+    "org.mockito.Mockito.*",
+    "org.mockito.ArgumentMatchers.*",
+    "org.mockito.Answers.*",
+    "com.webforj.component.optiondialog.OptionDialog.*",
+    "com.webforj.App.console",
+  ],
+  "java.completion.filteredTypes": [
+    "java.awt.*",
+    "com.sun.*",
+    "sun.*",
+    "jdk.*",
+    "org.graalvm.*",
+    "io.micrometer.shaded.*",
+    "com.basis.*",
+    "javax.swing.*",
+  ],
+}
diff --git a/1-creating-a-basic-app/README.md b/1-creating-a-basic-app/README.md
@@ -0,0 +1,59 @@
+
+# webforJ Customer Management Tutorial App (Spring Boot)
+
+This project demonstrates how to build a customer management app using the **webforJ framework** with Spring Boot. The app showcases modern web UI development while leveraging Spring’s backend ecosystem, including dependency injection, service layers, and data management.
+
+For a complete step-by-step guide to building this app, see the **[webforJ Tutorial](https://docs.webforj.com/docs/introduction/tutorial/overview)**.
+
+---
+
+## Prerequisites
+
+To run the app, ensure the following tools are installed:
+
+- Java 17 or 21
+- Maven
+- A Java IDE (e.g., IntelliJ IDEA, Eclipse, VSCode)
+- Web browser
+- Git (recommended)
+
+---
+
+## Project Structure
+
+```bash
+webforj-demo-application
+│   .gitignore
+│   LICENSE
+│   README.md
+│   tree.txt
+│
+├───1-creating-a-basic-app         # Step 1: Basic app with Spring Boot
+├───2-working-with-data            # Step 2: Table integration, data binding
+├───3-scaling-with-routing-and-composites  # Step 3: Routing, reusable components (Spring controllers)
+└───4-validating-and-binding-data  # Step 4: Data validation and bindings
+```
+
+## Running the App (Spring Boot)
+
+1. Navigate to the desired step directory (e.g., `1-creating-a-basic-app`):
+	```sh
+	cd 1-creating-a-basic-app
+	```
+2. Start the Spring Boot application:
+	```sh
+	mvn spring-boot:run
+	```
+3. Open your browser and go to [http://localhost:8080](http://localhost:8080).
+
+## Project Highlights
+
+- **Spring Boot integration:** Autowire Spring beans directly into webforJ views and components.
+- **Data binding and validation:** Use standard Java validation annotations and webforJ data binding features.
+- **Spring Data support:** Connect UI components to your data layer using Spring repositories.
+- **Hot reload:** Automatic browser refresh with Spring DevTools.
+- **Familiar development:** Continue using Spring annotations like `@Service`, `@Repository`, and `@Component`.
+- **Flexible configuration:** Combine `application.properties` with `webforj.conf` for complete control.
+
+## License
+This project is licensed under the MIT License. See the LICENSE file for details.
diff --git a/1-creating-a-basic-app/pom.xml b/1-creating-a-basic-app/pom.xml
@@ -1,44 +1,23 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <modelVersion>4.0.0</modelVersion>
-
-  <groupId>com.webforj.samples</groupId>
-  <artifactId>webforj-demo-application</artifactId>
-  <version>25.02</version>
-  <packaging>war</packaging>
-  <name>webforj-demo-application</name>
-  <description>A simple webforJ application</description>
-  <url>https://webforj.com</url>
-
+  <parent>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-parent</artifactId>
+    <version>3.5.4</version>
+    <relativePath/>
+  </parent>
+  <groupId>com.webforj.demos</groupId>
+  <artifactId>demoapplication</artifactId>
+  <version>1.0-SNAPSHOT</version>
+  <name>DemoApplication</name>
   <properties>
+    <webforj.version>25.03-SNAPSHOT</webforj.version>
+    <maven.compiler.target>21</maven.compiler.target>
+    <maven.compiler.source>21</maven.compiler.source>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-
-    <maven.compiler.source>17</maven.compiler.source>
-    <maven.compiler.target>17</maven.compiler.target>
-
-    <webforj.version>25.02</webforj.version>
-
-    <jetty.version>12.0.14</jetty.version>
-    <jetty.scan>1</jetty.scan>
-    <jetty.port>8080</jetty.port>
-    <jetty.stopPort>9966</jetty.stopPort>
   </properties>
-
-  <repositories>
-    <repository>
-      <id>snapshots-repo</id>
-      <url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
-      <releases>
-        <enabled>false</enabled>
-      </releases>
-      <snapshots>
-        <enabled>true</enabled>
-      </snapshots>
-    </repository>
-  </repositories>
-
   <dependencyManagement>
     <dependencies>
       <dependency>
@@ -48,98 +27,117 @@
         <type>pom</type>
         <scope>import</scope>
       </dependency>
-
-      <dependency>
-        <groupId>org.junit</groupId>
-        <artifactId>junit-bom</artifactId>
-        <version>5.10.3</version>
-        <scope>import</scope>
-        <type>pom</type>
-      </dependency>
     </dependencies>
   </dependencyManagement>
-
-<dependencies>
+  <dependencies>
     <dependency>
       <groupId>com.webforj</groupId>
       <artifactId>webforj</artifactId>
       <version>${webforj.version}</version>
     </dependency>
     <dependency>
       <groupId>com.webforj</groupId>
-      <artifactId>webforj-googlecharts</artifactId>
+      <artifactId>webforj-spring-boot-starter</artifactId>
     </dependency>
-
     <dependency>
-      <groupId>org.slf4j</groupId>
-      <artifactId>slf4j-simple</artifactId>
-      <version>2.0.16</version>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-validation</artifactId>
     </dependency>
-
     <dependency>
-      <groupId>com.microsoft.playwright</groupId>
-      <artifactId>playwright</artifactId>
-      <version>1.49.0</version>
+      <groupId>com.webforj</groupId>
+      <artifactId>webforj-spring-devtools</artifactId>
+      <optional>true</optional>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-devtools</artifactId>
+      <optional>true</optional>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-test</artifactId>
       <scope>test</scope>
+      <exclusions>
+        <exclusion>
+          <groupId>com.vaadin.external.google</groupId>
+          <artifactId>android-json</artifactId>
+        </exclusion>
+      </exclusions>
     </dependency>
     <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-api</artifactId>
+      <groupId>com.microsoft.playwright</groupId>
+      <artifactId>playwright</artifactId>
+      <version>1.49.0</version>
       <scope>test</scope>
     </dependency>
   </dependencies>
-
+  <repositories>
+    <repository>
+      <releases>
+        <enabled>false</enabled>
+      </releases>
+      <snapshots>
+        <enabled>true</enabled>
+      </snapshots>
+      <id>central-portal-snapshots</id>
+      <name>Central Portal Snapshots</name>
+      <url>https://central.sonatype.com/repository/maven-snapshots/</url>
+    </repository>
+  </repositories>
   <build>
+    <defaultGoal>spring-boot:run</defaultGoal>
     <plugins>
       <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-war-plugin</artifactId>
-        <version>3.4.0</version>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-maven-plugin</artifactId>
         <configuration>
-          <webResources>
-            <resource>
-              <filtering>true</filtering>
-              <directory>src/main/webapp</directory>
-              <includes>
-                <include>**/web.xml</include>
-              </includes>
-            </resource>
-          </webResources>
+          <excludeDevtools>true</excludeDevtools>
         </configuration>
       </plugin>
-
       <plugin>
-        <groupId>org.eclipse.jetty.ee10</groupId>
-        <artifactId>jetty-ee10-maven-plugin</artifactId>
-        <version>${jetty.version}</version>
-        <configuration>
-          <scan>${jetty.scan}</scan>
-          <stopPort>${jetty.stopPort}</stopPort>
-          <stopKey>${project.artifactId}</stopKey>
-          <httpConnector>
-            <port>${jetty.port}</port>
-          </httpConnector>
-          <webApp>
-            <contextPath>/</contextPath>
-          </webApp>
-        </configuration>
+        <artifactId>maven-failsafe-plugin</artifactId>
+        <version>3.0.0-M7</version>
         <executions>
           <execution>
-            <id>start-jetty</id>
-            <phase>pre-integration-test</phase>
-            <goals>
-              <goal>start</goal>
-            </goals>
-          </execution>
-          <execution>
-            <id>stop-jetty</id>
-            <phase>post-integration-test</phase>
             <goals>
-              <goal>stop</goal>
+              <goal>integration-test</goal>
+              <goal>verify</goal>
             </goals>
           </execution>
         </executions>
+        <configuration>
+          <trimStackTrace>false</trimStackTrace>
+        </configuration>
       </plugin>
     </plugins>
   </build>
+  <profiles>
+    <profile>
+      <id>prod</id>
+      <activation />
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-maven-plugin</artifactId>
+            <configuration>
+              <excludeDevtools>true</excludeDevtools>
+              <excludes>
+                <exclude>
+                  <groupId>com.webforj</groupId>
+                  <artifactId>webforj-spring-devtools</artifactId>
+                </exclude>
+              </excludes>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+    <profile>
+      <id>dev</id>
+      <activation>
+        <activeByDefault>true</activeByDefault>
+      </activation>
+    </profile>
+  </profiles>
 </project>