Async Components and Client-Only Islands

Instructions for async components with fallbacks and client-only rendering.

When to Use

Use this when a component needs async setup or when a section should render only on the client.

Steps

1. Define a component that returns a Promise of a render function.
2. Provide a fallback render function for DOM mode while async work runs.
3. Use clientOnly: true to skip SSR for a component and render it on the client.
4. Keep explicit updates for any local state changes after load.

Arguments

• componentName - async component name (defaults to AsyncCard)
• includeFallback - whether to include a fallback (defaults to true)