Skip to content

Styling intro updated to mention Aura default #5405

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rolfsmeds merged 3 commits into from
Mar 27, 2026
+5 −1
Merged

Styling intro updated to mention Aura default #5405

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
083050b
Updated Styling intro to mention Aura loaded by default if no AppShel…
rolfsmeds Mar 26, 2026
833df02
Merge branch 'main' into docs/styling-docs-default-theme-update
peholmst Mar 27, 2026
b067b14
Merge branch 'main' into docs/styling-docs-default-theme-update
rolfsmeds Mar 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion articles/styling/index.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,11 @@

== Themes

By default, Vaadin components are rendered with their minimalistic built-in <<themes/base#, base styles>>, which are a good starting point if you want to customize the look and feel extensively. Vaadin also ships with two themes, <<themes/aura#, Aura>> and <<themes/lumo#, Lumo>>, that provide a more polished look and feel for Vaadin components.
Vaadin components come bundled only with minimalistic, built-in base styles, on top of which the application can load one of the two Vaadin themes, <<themes/aura#, Aura>> or <<themes/lumo#, Lumo>>, which provide a more polished look and feel.

Check failure on line 49 in articles/styling/index.adoc

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'minimalistic'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'minimalistic'?", "location": {"path": "articles/styling/index.adoc", "range": {"start": {"line": 49, "column": 42}}}, "severity": "ERROR"}

If no [interfacename]`AppShellConfigurator` is defined for the application, the Aura theme will be loaded automatically. Otherwise either theme needs to be loaded explicitly using the [annotationname]`@StyleSheet` annotation.

Check warning on line 51 in articles/styling/index.adoc

View workflow job for this annotation

GitHub Actions / lint 

[vale] reported by reviewdog 🐶
[Vaadin.Will] Avoid using 'will'.

Raw Output:
{"message": "[Vaadin.Will] Avoid using 'will'.", "location": {"path": "articles/styling/index.adoc", "range": {"start": {"line": 51, "column": 92}}}, "severity": "WARNING"}

While both themes are highly customizable, you can also choose to implement your own custom styling directly on top of the <<themes/base#, base styles>> in order to avoid having to override the styling provided by the theme.

[cols="^.^1, ^.^1, ^.^1"]
|===
Expand Down
Loading