Quick Start

Build

Requirements: Maven 3.9.9+, Java 26+.

mvn clean install

Run the Vaadin demo

cd demo-vaadin && mvn jetty:run
# http://localhost:8080/

Run the REST demo (server + CLI)

# Terminal 1 — start the JDK-only HTTP server on http://localhost:8080
mvn -pl :demo-rest exec:java

# Terminal 2 — interactive CLI
mvn -pl :demo-rest exec:java \
    -Dexec.mainClass=com.svenruppert.vaadin.security.demo.rest.cli.DemoRestCli

Demo users: admin/admin, editor/editor, viewer/viewer. The full walkthrough with example sessions lives in docs/demo-rest.md of the repository.

# Tests for either demo
mvn -pl :demo-rest -am test
mvn -pl :demo-vaadin -am test

Add the dependency

For a Vaadin Flow application:

<dependency>
  <groupId>com.svenruppert</groupId>
  <artifactId>security-vaadin</artifactId>
  <version>00.50.01-SNAPSHOT</version>
</dependency>

For a REST handler / servlet application:

<dependency>
  <groupId>com.svenruppert</groupId>
  <artifactId>security-rest</artifactId>
  <version>00.50.01-SNAPSHOT</version>
</dependency>

security-core is pulled in transitively by either adapter.

Vaadin Integration