Server side rendering support

[crash7]

Hi! First of all, kudos for the design system outsourcing and really nice docs :) The announcement came just in time, as I was looking for a UI toolkit for a new side-project, so I'm giving the library a try.

I'm using Next.js and when trying to replicate some of the demos in a toy-repo, I encountered a couple of warnings/errors regarding the hydration/diffs between client and server render:

1. "Warning: useLayoutEffect does nothing on the server" -> seems to be related with Icon/internal
2. react-hydration-error when using HelpPanel

Are you aware of this errors/are they on the roadmap?
If not,

• What are your plans regarding SSR?
• Would you be open for contributions to help improving the DX there?

[FlorianDr]

Hey Christian,

Thank you for your question and the kudos. We are excited to hear that you are interested in building your next project with the Cloudscape Design System.

To answer your request:
At the time of writing, there are known limitations in server-side rendering Cloudscape components, but we don't currently have short-term plans to work on these issues. As per our contribution guidelines, we currently support contributions for bug fixes. If you are willing to contribute small code changes to better support SSR with Next.js, we would happily support you during your contribution.

Thank you,
Florian

[crash7]

Hi Florian!
Thanks for your answer! I have been able to fix the main issue by using a wrapper component to avoid rendering it during SSR. The other issues that remain are warnings for the components that are using the useLayoutEffect.

Will try to create a separate issue to discuss a solution before attempting to do a PR, as I'm not sure it would qualify as a bug fix.

Thanks!

[avinashbot]

Hi!

Regarding the warnings for useLayoutEffect, we decided to leave them as-is for now, and only address them on a per-component level (#79). In general, you can ignore them, but as Florian said, if you're willing to contribute small fixes for individual components on that front, we're happy to support you.

Thanks,
Avinash.