Skip to content

Conversation

fredpena
Copy link
Contributor

@fredpena fredpena commented Aug 18, 2025

Summary

Adds a new documentation page “Lumo Utility Classes: Responsive Breakpoints” covering how to use breakpoint prefixes (sm:, md:, lg:, xl:, 2xl:) with the LumoUtility.*.Breakpoint Java API in Vaadin Flow. The page includes:

  • A table of default breakpoints (min-widths and CSS equivalents)
  • Supported responsive utility groups: Align Items, Display, Flex Direction, Font Size, Grid, Position
  • Code samples (Java) for each group
  • Guidance on limitations (e.g., spacing/gap/justify-content currently require custom CSS)
  • A short Conclusion with best practices (mobile-first, testing, custom CSS for non-supported utilities)

Motivation / Context

Developers frequently ask how to apply responsive styles directly from Java without writing media queries. This page centralizes the available breakpoint-enabled utilities, clarifies what’s currently supported, and shows idiomatic examples.

Scope of Changes

  • Adds a new .adoc page:
    docs/<appropriate-path>/lumo-responsive-breakpoints.adoc
    (Please advise if a different folder or navigation entry is preferred.)
  • References the main utility classes page: <<utility-classes.adoc#, Lumo Utility Classes>>.

Visuals / Assets

  • Adds illustrative images under articles/styling/_images/:

Alt text is included in the image::...[] directives for accessibility.
If the repo has an image naming or compression guideline, I can adjust.

How to Review

  1. Content accuracy: Confirm API names and enum constants for LumoUtility.* and their .Breakpoint variants.
  2. Scope and tone: Verify the technical tone and that claims (supported groups/limitations) match the current API.
  3. Navigation: Confirm location in the docs tree and side nav ordering (order: 0 can be changed if needed).
  4. Cross-links: Validate the cross-reference utility-classes.adoc (path and anchor).
  5. Images: Confirm paths and filenames match repo conventions.

fredpena and others added 14 commits July 25, 2025 08:54
Remove 'The temporary files are automatically deleted when the upload is complete or the component is detached.'
Provided detailed documentation on what Custom Authorization Rules are, their use cases, and how they complement Vaadin's view-based access control.
Documented the purpose and effects of disabling CSRF configuration and Navigation Access Control in VaadinSecurityConfigurer. Clarified default behavior, when it is safe to disable, and the implications for application security.
@peholmst peholmst added the target/main cherry pick to main branch label Aug 20, 2025
@peholmst peholmst requested a review from anezthes August 26, 2025 10:13
Co-authored-by: Jouni Koivuviita <[email protected]>
@peholmst peholmst requested a review from jouni September 15, 2025 06:18
@peholmst
Copy link
Member

@jouni Can you have a second look at this PR so we can get it merged?

@jouni
Copy link
Member

jouni commented Sep 23, 2025

I’m not very familiar with the Lumo utility classes, so I’d like if @anezthes would review this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

target/main cherry pick to main branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants