vaadin-form-layout
Builds the visual structure and layout of a form, entity editor, or data-entry view in Vaadin Flow (Java) from any spec source — Figma URL, screenshot, text, or prompt — choosing the fields and components, FormLayout sectioning, and responsive column layout. Use when asked to create, implement, build, or generate a form, entity editor, or data entry view in Vaadin, to "add fields", "add a form", or "build a layout for editing", or when the user describes collecting structured input from users — even if they don't say the word "form" explicitly. This skill covers the form's layout and components only; to wire the fields to a Java bean with Binder, converters, and validation, look up the Binder and Form Validation guides via the Vaadin docs MCP (search_vaadin_docs).
How do I install this agent skill?
npx skills add https://github.com/vaadin/agent-skills --skill vaadin-form-layoutIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a developer tool for building Vaadin Flow form layouts from design specifications like Figma URLs or screenshots. It generates standard Java code and utilizes a vendor-specific tool for documentation lookup. The operations performed are consistent with the skill's stated purpose and no malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Vaadin Form Creation
Workflow
Track these three steps as TODOs so progress stays visible and the work can be resumed if it's interrupted partway through. Work through them in order.
Step 1 – Understand the input and plan
Process the spec source first: fetch and inspect a Figma URL, read a screenshot, or parse a text prompt.
- Well-defined spec (explicit field list, or a design with clear fields and labels): implement exactly what's specified. Do not invent extra fields, rename labels, or add controls the spec doesn't call for. The output should be predictable and faithful to the input.
- Vague request (e.g. "make a customer form" with no field list): ask a few targeted clarifying questions before planning — which fields and their data types, how they group, and whether it should be a single section or several. Don't silently guess the contents. Once the contents are settled, plan the structure and record it in your TODOs:
- the field list and the data type of each field,
- the section layout — single section, stacked vertical sections, or side-by-side horizontal sections,
- which reference example (see table below) most closely matches the planned structure.
Sectioning guidance: when a form covers multiple logical groups of fields (e.g. basic details and address), split it into separate
FormLayoutinstances — one per section, each with its own heading added into theFormLayoutspanning the full column width. Use a heading element whose level fits the surrounding view hierarchy (e.g. a section heading nested under a page title). If the right level isn't clear from the surrounding code, default toH4as the reference examples do — don't go out of your way to discover the exact level. Arrange sections side-by-side with a wrappingHorizontalLayout(growing and shrinking equally, wrapping to one column on narrow viewports) or stacked in aVerticalLayout.
Step 2 – Gather references
With the component set now known from the plan:
- Resolve the theme. Check
Application.javafor the@StyleSheetimport:Aura.STYLESHEET→ Aura,Lumo.STYLESHEET→ Lumo (also the default if no theme is found). Theme affects component variants, e.g.RadioGroupVariant.AURA_HORIZONTALvsRadioGroupVariant.LUMO_VERTICALfor horizontal radio groups. - Read the matching reference example end-to-end (table below).
- Fetch component API docs with
mcp_vaadin_get_component_java_apifor every component you'll use, includingFormLayout— method signatures differ between Vaadin versions.
Step 3 – Write the UI code
Implement the form following the patterns in the chosen reference example. Always use FormLayout for the form body. Key layout concepts:
- Auto-responsive — use
setAutoResponsive(true)withaddFormRow(...)to infer column count from the widest row. Combine withsetExpandColumns(true)andsetExpandFields(true)to fill available width. Preferred for uniform-width fields. - Responsive steps — alternative to auto-responsive; use
setResponsiveSteps(...)to define explicit column counts at specific breakpoints when you need precise control over layout at different widths. - Column span — pass a column count to
form.add(field, n)or useFormRowwith per-field colspan for asymmetric rows. - Constrained width — set
setMaxWidth/setMinWidthto keep forms readable at large viewport sizes. - Asymmetric rows — when fields in a row need different widths, wrap them in a
HorizontalLayoutand add it as a single full-width item.
Examples
| File | What it shows |
|---|---|
| references/horizontal-sections-form-example.md | Two-section entity form with side-by-side auto-responsive FormLayout panels, equal-grow HorizontalLayout wrapper, asymmetric field rows via HorizontalLayout.expand, read-only fields, horizontal RadioButtonGroup (Aura), ComboBox with defaults, NumberField with helper text |
| references/vertical-sections-three-column-form-example.md | Three-section employee form with stacked VerticalLayout sections, three-column auto-responsive FormLayout, FormRow colspan, DatePicker, EmailField, phone helper text |
| references/compact-single-section-form-example.md | Compact single-section form with progressive disclosure (CheckboxGroup conditionally revealing a field), horizontal RadioButtonGroup with dynamic helper text, asymmetric field row via HorizontalLayout, icon prefix, live-computed summary label, constrained form width |
| references/compact-labels-aside-form-example.md | Compact labels-aside form with setLabelsAside(true) for a two-column label/field layout, CustomField composition combining NumberField and ComboBox into a single form item, TextArea with character limit, required field indicators, constrained form width |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/vaadin/agent-skills/vaadin-form-layout">View vaadin-form-layout on skillZs</a>