Troubleshooting
When it goes wrong.
Every one of these has happened, most of them to us. They are listed in the order they tend to bite.
The components arrive unstyled
This is the npm path. Tailwind does not scan node_modules, so a package’s utility classes are never generated and the markup lands without any of them. Point Tailwind at the package in your CSS:
@import "tailwindcss";
@source "../node_modules/mischief-ui";Installing through the registry copies source into your own project, where Tailwind is already looking, so it needs none of this.
A scene renders nothing at all
The scenes draw into a box they do not create. Every one of them is positioned relative with no height of its own, so dropping one into an absolutely positioned parent collapses it to zero and it paints nothing. Give it the box:
<div className="relative h-64">
<AuroraField className="absolute inset-0" />
</div>The giveaway is that a grain or gradient layered over it still shows, because those position themselves, while the scene underneath does not.
An animation never plays
Three components animate a keyframe by name, and the keyframes travel with them through the registry rather than living in your stylesheet already. Copying the source by hand instead of installing it leaves the rule pointing at a keyframe that does not exist: the component renders correctly and simply never moves.
Install through the CLI and the keyframes are added to your CSS for you. If you did copy by hand, the missing rules are in that component’s entry in the registry, under css.
Nothing animates anywhere
Check whether your system is set to reduce motion. Every component here decides what to do when it is, and for most of them the decision is to arrive without the movement. That is working as intended, and the content is all still there.
The CLI cannot find the component
The short form needs the namespace registered once in your components.json. Without it the CLI has nowhere to resolve @mischief and looks in shadcn’s own registry instead, where these do not exist.
{
"registries": {
"@mischief": "https://ui.tinkererslabs.com/r/{name}.json"
}
}The long form, which names this repository in full, works without any configuration.
Still stuck
Open an issue with the component, the install command you ran, and what you expected instead. Everything here is MIT, so a patch is welcome too.