Introduction
Animated components for React, Svelte and Solid, installed as source with the shadcn CLI or shadcn-svelte.
What you get
Yours to change
Each component is added to your project as a source file with the shadcn CLI. No package to update, nothing hidden.
CSS does the motion
Transitions driven by a data attribute and a few variables. No animation library to install, and a hover can be interrupted for free.
Made to be read
Small files with named parts, checked against strict TypeScript and an accessibility linter. Every component forwards its ref and passes your props to its root, and its page explains why it moves the way it does.
Fits your theme
Tailwind classes and shadcn’s colour names, in light and dark. Timing can be set from a class.
Three frameworks, one set
Every component is written for React first, then ported to Svelte 5 and Solid with the same look, the same motion and the same props wherever the framework allows. Pick yours with the Framework switch on any component page: the preview, the code, the install command and the usage all follow. One license covers all three.
Quick start: React
Components come from a shadcn registry. Text Reveal, Number Roll, Link, Field and Input are free and install without a key. Everything else is unlocked by the license key you get when you buy.
- 1
Set up shadcn
Skip this if your project already has a
components.json.$npx shadcn@latest init - 2
Add the registry
In
components.json, tell shadcn where Mizzle lives. For the free components, that is all you need.components.json
1{2 "registries": {3 "@mizzle": "https://mizzle.saddy.me/r/{name}.json"4 }5} - 3
Unlock the paid components
After you buy, put
MIZZLE_LICENSE=your-license-keyin.env.local, which the shadcn CLI reads, and keep it out of version control. Then tell shadcn to send the key with each request. One key covers everything you buy. Add the header only once the key is set: the CLI stops with an error whenMIZZLE_LICENSEis missing.components.json
1{2 "registries": {3 "@mizzle": {4 "url": "https://mizzle.saddy.me/r/{name}.json",5 "headers": {6 "Authorization": "Bearer ${MIZZLE_LICENSE}"7 }8 }9 }10} - 4
Pick a look
Every component comes in three looks: Raised, a white panel on a grey frame (the default); Inset, a grey panel set into a white frame; and Flat, one grey body with no shadows. To install everything in Inset or Flat, add the look to the registry URL. Switch looks on any component page to see them. The looks come with the license: the free components install in Flat.
components.json
1"url": "https://mizzle.saddy.me/r/flat/{name}.json" - 5
Add a component
By name. The CLI brings in anything else the component needs.
$npx shadcn@latest add @mizzle/text-reveal - 6
Use it
The source lands in your components folder, ready to import and to edit.
1import { TextReveal } from "@/components/mizzle/text/text-reveal"23export default function Hero() {4 return (5 <TextReveal as="h1">6 Words rise into place, one after another.7 </TextReveal>8 )9}
Quick start: Svelte
Svelte components install with shadcn-svelte from their own registry, as Svelte 5 components that use runes. They land in your components folder, one folder per component.
- 1
Set up shadcn-svelte
Skip this if your project already has a
components.json.$npx shadcn-svelte@latest init - 2
Add a component
By its URL. The free ones need nothing else, and the CLI brings in anything a component uses.
$npx shadcn-svelte@latest add https://mizzle.saddy.me/r/svelte/text-reveal.json - 3
Unlock the paid components
shadcn-svelte cannot send a key in a header, so it goes in the URL instead. Keep it in your shell as
MIZZLE_LICENSE, out of version control, and quote the URL so the shell fills it in.$export MIZZLE_LICENSE=your-license-key$npx shadcn-svelte@latest add "https://mizzle.saddy.me/r/svelte/$MIZZLE_LICENSE/dynamic-island.json" - 4
Pick a look
For Inset or Flat, add the look after
/sveltein the URL:/svelte/inset/or/svelte/flat/, before the key if there is one. - 5
Use it
Text goes in
text, classes inclass.1<script lang="ts">2 import { TextReveal } from "$lib/components/mizzle/text/text-reveal/index.js"3</script>45<TextReveal as="h1" text="Words rise into place, one after another." />
Quick start: Solid
Solid components install with the shadcn CLI, the same way as React, from the Solid registry.
- 1
Add the registry
In
components.json, point@mizzleat the Solid registry. Paid components send the key fromMIZZLE_LICENSEin.env.local, as for React.components.json
1{2 "registries": {3 "@mizzle": {4 "url": "https://mizzle.saddy.me/r/solid/{name}.json",5 "headers": {6 "Authorization": "Bearer ${MIZZLE_LICENSE}"7 }8 }9 }10} - 2
Add a component
$npx shadcn@latest add @mizzle/text-reveal - 3
Use it
1import { TextReveal } from "~/components/mizzle/text/text-reveal"23export default function Hero() {4 return (5 <TextReveal as="h1">6 Words rise into place, one after another.7 </TextReveal>8 )9}