You'll create a full-stack web app in pure Java. No HTML, no JavaScript, no REST plumbing — just components, events, and instant hotswap.
Vaadin Quickstart
Build your first Vaadin
Build your first Vaadin
app in 5 minutes
Before you start
Just two things — and if you write Java, you already have them.
A Java™ Development Kit (JDK) 21 or 25
Liberica, Temurin, or any modern JDK.
An Integrated Development Environment (IDE)
IntelliJ IDEA, Visual Studio Code or Eclipse
Step 1:
Download your starter
Click below to download a Spring Boot + Vaadin project starter with the default configuration as a .zip.
The defaults are fine for this quickstart — you don't need to change anything.
Want to customize first? Open start.vaadin.com configurator, to pick a project type, theme, or pre-built views.
Experienced Vaadin developers use it for every new project.
Step 2:
Open it in your IDE
Unzip the file and open the project folder in your IDE.
IntelliJ IDEA (recommended)
File → Open… and select the unzipped folder. IntelliJ detects the Maven project and imports dependencies automatically.
Visual Studio Code
Install the Extension Pack for Java, then File → Open Folder… and select the unzipped folder.
Eclipse
File → Import → Existing Maven Project and select the unzipped folder.
Step 3:
Enable Hotswap
Hotswap lets you change Java code and see the result instantly — no restart, no rebuild. Turn it on now - install the Vaadin plugin for your IDE and use it to start the application:
IntelliJ IDEA (recommended)
Install Vaadin from the JetBrains Marketplace, then click the Debug using Hotswap Agent menu item from the dropdown next to the main Run button.
Open http://localhost:8080 in your browser. First start takes ~30 seconds while Maven downloads dependencies.
Visual Studio Code
Install the Vaadin extension from the VS Code marketplace, then run Vaadin: Debug using Hotswap Agent from the command palette. Alternatively, you can right-click the Application.java class and select Debug using Hotswap Agent.
Open http://localhost:8080 in your browser. First start takes ~30 seconds while Maven downloads dependencies.
Eclipse
Install the Vaadin plugin from the Eclipse Marketplace, then right-click the project → Run As → Vaadin Application. Learn more
Open http://localhost:8080 in your browser. First start takes ~30 seconds while Maven downloads dependencies.
Why a plugin? It launches the JVM with the right agent for hotswap. Running with plain mvn spring-boot:run will work, but you'll lose live code changes.
Step 4:
Make your first change
Open MainLayout.java and modify the application name from "My Application to "Todo list".
Save the file. Switch back to your browser — the new app name appears without a reload.
Step 5:
Make a change without writing code
Vaadin Copilot is a visual, AI-empowered development tool built into dev mode.
You can inspect components, drag-and-drop, edit themes, or just ask in plain English.
Open Copilot in your running app - click Edit mode in the bottom-right corner toolbar.
or toggle it on ⇧ + ⌘ ⌘ on Mac · ⇧ + Ctrl Ctrl on Windows / Linux
(Hold Shift and press ⌘ or Ctrl twice)
Then click the AI assistant icon in the Copilot toolbar and try it out with a prompt:
Copilot prompt:
Add "ID" as the first column
Copilot edits your Java source directly, re-runs hotswap, and your app updates in place.
Open MainLayout.java in your IDE - the new column is right there in the code.
First-time AI use: Copilot will ask you to sign in with a free Vaadin account. The visual tools (drag-drop, theme editor, inspector) work without sign-in.
You're All Set!
Where to next?
You just built a full-stack web app in Java.
Pick your next step. Build real apps with AI development tools, explore the components, and ship to production.
Connect with AI dev tools
Use Vaadin MCP server to connect Claude Code, Codex, or any AI assistant to Vaadin's docs and APIs for accurate, real-time guidance.
Use UI Java Components
Library of 50+ production-ready UI components - grids, forms, charts, and dialogs. All callable from Java.
Master Vaadin Copilot
Drag-and-drop UI editing, theme tweaks, and AI prompts — without ever leaving the browser.