Skip to content

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. 1

    Set up shadcn

    Skip this if your project already has a components.json.

    npx shadcn@latest init
  2. 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. 3

    Unlock the paid components

    After you buy, put MIZZLE_LICENSE=your-license-key in .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 when MIZZLE_LICENSE is 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. 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. 5

    Add a component

    By name. The CLI brings in anything else the component needs.

    npx shadcn@latest add @mizzle/text-reveal
  6. 6

    Use it

    The source lands in your components folder, ready to import and to edit.

    1import { TextReveal } from "@/components/mizzle/text/text-reveal"
    2
    3export 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. 1

    Set up shadcn-svelte

    Skip this if your project already has a components.json.

    npx shadcn-svelte@latest init
  2. 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. 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. 4

    Pick a look

    For Inset or Flat, add the look after /svelte in the URL: /svelte/inset/ or /svelte/flat/, before the key if there is one.

  5. 5

    Use it

    Text goes in text, classes in class.

    1<script lang="ts">
    2 import { TextReveal } from "$lib/components/mizzle/text/text-reveal/index.js"
    3</script>
    4
    5<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. 1

    Add the registry

    In components.json, point @mizzle at the Solid registry. Paid components send the key from MIZZLE_LICENSE in .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. 2

    Add a component

    npx shadcn@latest add @mizzle/text-reveal
  3. 3

    Use it

    1import { TextReveal } from "~/components/mizzle/text/text-reveal"
    2
    3export default function Hero() {
    4 return (
    5 <TextReveal as="h1">
    6 Words rise into place, one after another.
    7 </TextReveal>
    8 )
    9}

A few to start with

All components
Button
Text Reveal
Number Roll
Tabs