Motion Fade — logic2b/ui

Fade in

The card fades up into place when it mounts.

"use client"

import * as React from "react"

import { Button } from "@/components/ui/button"
import { MotionFade } from "@/components/ui/motion-fade"

export default function MotionFadeDemo() {
  const [run, setRun] = React.useState(0)

  return (
    <div className="flex w-full flex-col items-center gap-6">
      <Button variant="outline" size="sm" onClick={() => setRun((n) => n + 1)}>
        Replay
      </Button>
      <MotionFade
        key={run}
        duration={600}
        className="w-full max-w-sm rounded-lg border bg-card p-6 text-card-foreground"
      >
        <p className="text-sm font-medium">Fade in</p>
        <p className="mt-1 text-sm text-muted-foreground">
          The card fades up into place when it mounts.
        </p>
      </MotionFade>
    </div>
  )
}

Installation

npx logic2b@next add motion-fade

Working with an AI assistant? Copy this prompt into Claude Code, Cursor or Copilot — it carries the install steps, a no-CLI fallback and a verification checklist.

Add the "motion-fade" item from the logic2b ui registry (https://ui.logic2b.com) to this project. Follow every step and verify at the end.

## Steps

1. If the project has no `components.json` yet, set up logic2b ui first:

   ```bash
   npx logic2b@next init
   ```

2. Install the item (the CLI resolves registry dependencies automatically):

   ```bash
   npx logic2b@next add motion-fade
   ```

3. Install any npm dependencies the command prints.

## If the CLI is not available

Do it manually from the registry payload:

1. Fetch https://ui.logic2b.com/r/motion-fade.json.
2. Write every entry in `files[]` to its mapped project path (see below).
3. Repeat (recursively) for each name in `registryDependencies`.
4. Install every package listed in `dependencies` across those payloads.

## Registry reference

- Index of every item: https://ui.logic2b.com/r/index.json
- Item payload (full source): https://ui.logic2b.com/r/<name>.json
- Usage examples per item: https://ui.logic2b.com/r/demos/index.json → https://ui.logic2b.com/r/demos/<demo>.json
- Docs index for agents: https://ui.logic2b.com/llms.txt (full docs: https://ui.logic2b.com/llms-full.txt)
- Every docs page is Markdown when you append `.md` to its URL.

Registry file paths map to project paths like this:
- `ui/*` → `@/components/ui/*`
- `blocks/<name>/*` → `@/components/*`
- `charts/*` → `@/components/charts/*`
- `hooks/*` → `@/hooks/*`
- `lib/utils.ts` → `@/lib/utils.ts`
- `theme.css` → next to the project's Tailwind entry stylesheet

## Conventions (do not break these)

- Tailwind CSS v4 (CSS-first config; no tailwind.config.js needed) and React 19.
- All colors go through semantic tokens (`bg-primary`, `text-muted-foreground`,
  `border-border`, …). Never hardcode hex/oklch values in components.
- Dark mode is class-based: toggle `.dark` on `<html>`.
- Icons come from lucide-react.

## Verify before finishing

1. The dev server starts and the app renders without console errors.
2. TypeScript compiles (`tsc --noEmit` or the framework's check).
3. Components use the theme: a `<Button>` shows the primary token color,
   and toggling `.dark` on `<html>` switches the palette.

Copy into ui/motion-fade.tsx:

"use client"

import { Motion, type MotionProps } from "@/components/ui/motion"

export type MotionFadeProps = Omit<MotionProps, "preset">

/** Fade a mounting element in. Preconfigured `<Motion preset="fade">`. */
function MotionFade(props: MotionFadeProps) {
  return <Motion preset="fade" {...props} />
}

export { MotionFade }

Usage

import { MotionFade } from "@/components/ui/motion-fade"

<MotionFade duration={600}>
  <Card>…</Card>
</MotionFade>

MotionFade is <Motion preset="fade"> — see Motion for the shared duration, delay, hover and asChild props, exit recipes and reduced-motion behavior.

Live playground

Edit the component props and inspect the exact JSX before copying it. The preview loads only when this section enters the viewport.

Generated JSX

<MotionFade
  duration={500}
  delay={0}
>Fade reveal</MotionFade>

API reference

Generated from the public TypeScript exports in src/ui/motion-fade.tsx.

View JSON

MotionFadeProps

Type

type MotionFadeProps = Omit<MotionProps, "preset">

MotionFade

Component

Fade a mounting element in. Preconfigured `<Motion preset="fade">`.

Props: MotionFadeProps

Accessibility contract

Machine-readable behavior and consumer responsibilities for motion-fade.

View JSON

Support: Composition contract
Pattern: fade animation; Motion for React

Built-in semantics

Preserves child semantics and accepts reduced-motion behavior from the motion foundation.

Consumer responsibilities

Keep content available without animation and avoid fading essential feedback too quickly.

Known limitations

• Motion safety depends on the selected transition and consumer composition.