docs / troubleshooting
Troubleshooting
Resolve the most common integration mistakes.
The sheet has no layout
Import styles.css or core.css once from the application entry point. Core CSS owns positioning and pointer behavior; it is required even when every visual rule is replaced.
The sheet has no accessible name
Render Sheet.Title inside Sheet.Content, or add an aria-label to Content. A visual heading outside the sheet does not name the dialog across a portal boundary.
Controlled state does not change
Update open in onOpenChange and activeSnapPoint in onSnapPointChange. Do not combine a controlled value with its corresponding default value.