# Troubleshooting

## Registry item returns 404

Use the exact `registryUrl` from the catalogue or component Markdown page.
Registry names use the `gummy-{slug}` form.

## Component renders without Gummy material

Confirm that the generated shared style files are imported once in the global
stylesheet or root layout. Re-run the canonical component install command so
the registry can resolve its shared style dependencies.

## Base UI import cannot be resolved

Install through the registry command rather than copying one TypeScript file.
The registry payload declares `@base-ui/react` where it is required.

## Dark or RTL behavior is missing

Use `data-theme="dark"` for the dark environment and set a genuine `dir`
boundary. Do not simulate RTL only by reversing a flex row.

## Motion remains enabled

Check that the generated component style payload is imported and that no
application rule overrides `prefers-reduced-motion: reduce`.

## Source viewer cannot load

Open the component's public registry URL directly. Its JSON payload contains
the same editable files used by the source viewer.

## Licence and source boundary

Gummy UI's public component source and documentation are MIT licensed.
This Markdown namespace exposes only public catalogue facts, public source
locations, and public registry URLs. Separate paid assets are not included
and cannot be inferred from these documents.

Canonical Markdown: https://gummyui.dev/docs/markdown/guides/troubleshooting.md