Are the ai2 Motion dialogs free?

Yes. The whole styled layer is free and MIT licensed, like the component core.

Can I change the size?

Yes. Every variation takes a size prop of sm, md, lg or xl, aligned to the base Button height scale.

Motion dialogs

Five modal dialogs with showy entrances: flip, swing, zoom, elastic and rotate. Each is self-contained (no radix), sized, token-driven, and closes on backdrop click or Escape.

DialogMotion

Installation

The styled layer is free and installs like any other ai2 component.

Run the following command

npx shadcn@latest add @ai2/dialog-motion

Dependencies, the @ai2/tokens theme and the component file are installed together.

Install dependencies

npm install motion lucide-react

Copy the source

components/ui/dialog-motion.tsx

"use client"

import * as React from "react"
import { X } from "lucide-react"
import { AnimatePresence, motion, useReducedMotion } from "motion/react"

import { cn } from "@/lib/utils"

/* Motion dialog family: 5 showy modals. The panel itself is plain (bg-popover); the
   DIFFERENCE is the enter/exit animation. Each export is a complete dialog:
   internal open/closed state (uncontrolled defaultOpen or controlled
   open/onOpenChange), NO radix or portal - a self-contained fixed backdrop + fixed
   panel. It closes on a backdrop click, Escape or the close button. The panel takes
   focus on open. AnimatePresence handles enter/exit; under reduced motion ALL
   transforms drop away and only an opacity fade remains. Color comes ONLY from
   tokens, via alpha color-mix. For the 3D variants there is an inline perspective
   style on the backdrop. */

export type StyledSize = "sm" | "md" | "lg" | "xl"

const panelSize: Record<StyledSize, string> = {
  sm: "max-w-sm",
  md: "max-w-md",
  lg: "max-w-lg",
  xl: "max-w-2xl",
}

interface DialogProps {
  size?: StyledSize
  trigger?: React.ReactNode
  title?: React.ReactNode
  children?: React.ReactNode
  className?: string
  open?: boolean
  defaultOpen?: boolean
  onOpenChange?: (o: boolean) => void
}

const backdropClass =
  "fixed inset-0 z-50 flex items-center justify-center p-4 bg-[color-mix(in_oklab,var(--color-foreground)_50%,transparent)]"

const panelBase =
  "relative w-full rounded-xl border border-border bg-popover text-popover-foreground shadow-lg outline-none"

const closeBtn =
  "absolute right-3 top-3 inline-flex size-8 items-center justify-center rounded-md text-muted-foreground outline-none transition-colors hover:bg-[color-mix(in_oklab,var(--color-foreground)_8%,transparent)] hover:text-foreground focus-visible:ring-[3px] focus-visible:ring-ring/50 [&_svg]:size-4 [&_svg]:shrink-0 [&_i]:text-base [&_i]:leading-none"

const triggerBtn =
  "inline-flex h-9 shrink-0 select-none items-center justify-center gap-2 whitespace-nowrap rounded-lg border border-border bg-secondary px-4 text-sm font-medium text-secondary-foreground outline-none transition-colors hover:bg-[color-mix(in_oklab,var(--color-foreground)_6%,transparent)] focus-visible:ring-[3px] focus-visible:ring-ring/50"

/* Controlled/uncontrolled acik durum yonetimi. */
function useDialogState(props: DialogProps) {
  const { open, defaultOpen, onOpenChange } = props
  const isControlled = open !== undefined
  const [internal, setInternal] = React.useState(defaultOpen ?? false)
  const isOpen = isControlled ? open : internal

  const setOpen = React.useCallback(
    (next: boolean) => {
      if (!isControlled) setInternal(next)
      onOpenChange?.(next)
    },
    [isControlled, onOpenChange]
  )

  return { isOpen, setOpen }
}

/* Shared shell: trigger plus an AnimatePresence backdrop plus panel. panelMotion carries the enter/exit animation supplied from outside; it differs in every export. */
function DialogShell({
  props,
  panelClassName,
  panelMotion,
}: {
  props: DialogProps
  panelClassName?: string
  panelMotion?: {
    initial: Record<string, number>
    animate: Record<string, number>
    exit: Record<string, number>
    transition?: Record<string, unknown>
  }
}) {
  const { size = "md", trigger, title, children, className } = props
  const { isOpen, setOpen } = useDialogState(props)
  const reduce = useReducedMotion()
  const panelRef = React.useRef<HTMLDivElement>(null)

  React.useEffect(() => {
    if (!isOpen) return
    const onKey = (e: KeyboardEvent) => {
      if (e.key === "Escape") setOpen(false)
    }
    window.addEventListener("keydown", onKey)
    const id = window.requestAnimationFrame(() => panelRef.current?.focus())
    return () => {
      window.removeEventListener("keydown", onKey)
      window.cancelAnimationFrame(id)
    }
  }, [isOpen, setOpen])

  const fade = { initial: { opacity: 0 }, animate: { opacity: 1 }, exit: { opacity: 0 } }
  const motionProps = reduce || !panelMotion ? fade : panelMotion

  return (
    <>
      {/* ARIA durumu tetikleyicinin KENDISINDE. Once yoktu: ekran okuyucu

          kullanicisi butonun bir dialog actigini ve acik olup olmadigini

          HIC bilmiyordu. Canli AX taramasiyla bulundu (grep gostermemisti). */}

      <span data-slot="styled-dialog-trigger" className="inline-flex">

        {React.isValidElement<React.ButtonHTMLAttributes<HTMLButtonElement>>(trigger) ? (

          React.cloneElement(trigger, {

            "aria-haspopup": "dialog",

            "aria-expanded": isOpen,

            onClick: (event: React.MouseEvent<HTMLButtonElement>) => {

              trigger.props.onClick?.(event)

              setOpen(true)

            },

          })

        ) : (

          <button

            type="button"

            aria-haspopup="dialog"

            aria-expanded={isOpen}

            onClick={() => setOpen(true)}

            className={triggerBtn}

          >

            {trigger ?? "Open dialog"}

          </button>

        )}

      </span>

      <AnimatePresence>
        {isOpen ? (
          <motion.div
            data-slot="styled-dialog"
            className={backdropClass}
            style={{ perspective: "1200px" }}
            initial={{ opacity: 0 }}
            animate={{ opacity: 1 }}
            exit={{ opacity: 0 }}
            transition={{ duration: 0.2, ease: "easeOut" }}
            onClick={() => setOpen(false)}
          >
            <motion.div
              ref={panelRef}
              role="dialog"
              aria-modal="true"
              tabIndex={-1}
              className={cn(panelBase, panelSize[size], panelClassName, className)}
              initial={motionProps.initial}
              animate={motionProps.animate}
              exit={motionProps.exit}
              transition={panelMotion?.transition ?? { duration: 0.2, ease: "easeOut" }}
              onClick={(e) => e.stopPropagation()}
            >
              <button
                type="button"
                aria-label="Close"
                className={closeBtn}
                onClick={() => setOpen(false)}
              >
                <X />
              </button>
              {title ? (
                <div className="border-b border-border px-6 py-4 pr-12 text-base font-semibold">
                  {title}
                </div>
              ) : null}
              <div className="px-6 py-5 text-sm text-muted-foreground">{children}</div>
            </motion.div>
          </motion.div>
        ) : null}
      </AnimatePresence>
    </>
  )
}

/* Flip: it arrives closed on a 3D vertical axis and opens by straightening
   (rotateX). */
export function FlipDialog(props: DialogProps) {
  return (
    <DialogShell
      props={props}
      panelClassName="origin-top [transform-style:preserve-3d]"
      panelMotion={{
        initial: { opacity: 0, rotateX: -90 },
        animate: { opacity: 1, rotateX: 0 },
        exit: { opacity: 0, rotateX: -90 },
        transition: { type: "spring", stiffness: 260, damping: 24 },
      }}
    />
  )
}

/* Swing: ustten sarkac gibi sallanarak iner (rotate + origin-top). */
export function SwingDialog(props: DialogProps) {
  return (
    <DialogShell
      props={props}
      panelClassName="origin-top"
      panelMotion={{
        initial: { opacity: 0, rotate: -14, y: -24 },
        animate: { opacity: 1, rotate: 0, y: 0 },
        exit: { opacity: 0, rotate: -8, y: -16 },
        transition: { type: "spring", stiffness: 220, damping: 12 },
      }}
    />
  )
}

/* Zoom: agresif buyume ile ortaya patlar (scale 0.5 -> 1). */
export function ZoomDialog(props: DialogProps) {
  return (
    <DialogShell
      props={props}
      panelMotion={{
        initial: { opacity: 0, scale: 0.5 },
        animate: { opacity: 1, scale: 1 },
        exit: { opacity: 0, scale: 0.5 },
        transition: { type: "spring", stiffness: 360, damping: 26 },
      }}
    />
  )
}

/* Elastic: yuksek stiffness dusuk damping ile elastik overshoot. */
export function ElasticDialog(props: DialogProps) {
  return (
    <DialogShell
      props={props}
      panelMotion={{
        initial: { opacity: 0, scale: 0.8, y: 28 },
        animate: { opacity: 1, scale: 1, y: 0 },
        exit: { opacity: 0, scale: 0.9, y: 16 },
        transition: { type: "spring", stiffness: 520, damping: 11 },
      }}
    />
  )
}

/* Rotate: hafif donerek ve buyuyerek girer (rotate -8 + scale). */
export function RotateDialog(props: DialogProps) {
  return (
    <DialogShell
      props={props}
      panelMotion={{
        initial: { opacity: 0, rotate: -8, scale: 0.9 },
        animate: { opacity: 1, rotate: 0, scale: 1 },
        exit: { opacity: 0, rotate: -6, scale: 0.92 },
        transition: { type: "spring", stiffness: 300, damping: 22 },
      }}
    />
  )
}

Manual installs skip the @ai2/tokens theme, so add the token CSS from the theming guide or the tone colors will be missing.

Variations

5 takes on the same idea. Each is its own export, and every one accepts a size prop (sm, md, lg, xl) aligned to the base Button scale.

Flip

Flips open in 3D around its top edge.

import { FlipDialog } from "@/components/ui/dialog-motion"

<FlipDialog title="Dialog title">A self-contained modal dialog with a showy entrance. Click the backdrop or press Escape to close.</FlipDialog>

Swing

Swings down from the top like a pendulum.

import { SwingDialog } from "@/components/ui/dialog-motion"

<SwingDialog title="Dialog title">A self-contained modal dialog with a showy entrance. Click the backdrop or press Escape to close.</SwingDialog>

Zoom

Bursts in with an aggressive zoom.

import { ZoomDialog } from "@/components/ui/dialog-motion"

<ZoomDialog title="Dialog title">A self-contained modal dialog with a showy entrance. Click the backdrop or press Escape to close.</ZoomDialog>

Elastic

Springs in with an elastic overshoot.

import { ElasticDialog } from "@/components/ui/dialog-motion"

<ElasticDialog title="Dialog title">A self-contained modal dialog with a showy entrance. Click the backdrop or press Escape to close.</ElasticDialog>

Rotate

Rotates in slightly while scaling up.

import { RotateDialog } from "@/components/ui/dialog-motion"

<RotateDialog title="Dialog title">A self-contained modal dialog with a showy entrance. Click the backdrop or press Escape to close.</RotateDialog>

ai2 Motion dialogs: 5 styled variations on the token system

The ai2 Motion dialogs are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around self-contained modal dialogs with showy entrances. They are free and MIT licensed, and every color comes from a semantic token, so they theme with the rest of ai2 in light and dark.

Motion runs on framer-motion: framer-motion animates a distinct 3D flip, pendulum swing, zoom, elastic spring or rotate on enter and exit; the backdrop fades. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, the transforms are skipped and the dialog fades instead.

What is in the ai2 Motion dialogs?

5 exports in one file: Flip, Swing, Zoom, Elastic and Rotate. Each renders a native button and takes a size prop (sm, md, lg, xl) aligned to the base Button. They are separate from the base Button on purpose: the base keeps its clean variant, tone and size axes, while the styled layer carries the effects.

You own the file. Copy the one category file and you have all 5 variations, with no runtime dependency on ai2 itself.

Why use it

On-system by construction: Every color resolves to an ai2 semantic token, so the buttons follow your theme in light and dark with no extra work.
Effect without the sprawl: The decorations live in a dedicated styled file, so the base Button keeps its clean, predictable API.
Accessible and honest: Each renders a real button element, keeps a visible focus ring, and respects prefers-reduced-motion.

Features

Token-driven color: No hardcoded hex or oklch; the look recolors with your theme tokens.
framer-motion: framer-motion animates a distinct 3D flip, pendulum swing, zoom, elastic spring or rotate on enter and exit; the backdrop fades.
Reduced-motion aware: Under prefers-reduced-motion, the transforms are skipped and the dialog fades instead.
Size aligned to the base: Every variation takes sm, md, lg and xl matching the base Button height scale, so styled and base buttons line up in a row.

Production tips

Use it for emphasis, not everywhere: Styled buttons draw the eye. Reserve them for the one action you want people to take on a screen, and use the base Button for the rest.
Keep labels as verbs: The decoration adds weight, so a clear action label keeps the button scannable.
Pick one variation per surface: The variations share a family; using two different ones in the same view competes for attention.

Works with the rest of ai2

The Motion dialogs sit alongside the base Button and the rest of the @ai2 registry. They share the same token file, so a styled action next to a base button or a badge stays visually consistent in both modes.