AlertDialog

A modal alert dialog whose opened/closed state is a pure function of the timeline

A state atom whose appearance (closed, opened) is a pure function of the state prop. Pass a state directly or drive it from the Remotion timeline via useCurrentState. The component reads no frame — only the state value you give it. The wrapper is transparent by design: AlertDialog is a modal layer meant to compose over another scene, so it does not paint an opaque background.

Installation

$ pnpm dlx shadcn@latest add @remocn/alert-dialog

Installing alert-dialog automatically installs the shared remocn-ui core (lib/remocn-ui/) and the button primitive via registryDependencies (["remocn-ui", "button"]). You do not need to install them separately — the dialog pairs with the Button as its trigger in the canonical lifecycle example.

States

AlertDialogState is:

type AlertDialogState =
  | "opened"  // backdrop dims to 50% black, popup fades in and zooms from 0.95 → 1
  | "closed"  // panel hidden, backdrop clear (overlay opacity 0, popup opacity 0, scale 0.95)

opened reveals the backdrop dim (scales up to MAX_OVERLAY_ALPHA = 0.5) and fades the popup card in while zooming it from 0.95 to 1 and lifting it 8 px upward. closed hides the backdrop and the popup entirely.

Snap usage

Pass state directly — the component snaps instantly to that visual. Useful for static previews or when you drive state from your own logic:

import { AlertDialog } from "@/components/remocn/alert-dialog";

export const Scene = () => <AlertDialog state="opened" />;

To drive state from the timeline, use useCurrentState:

import { useCurrentState } from "@/lib/remocn-ui";
import { AlertDialog } from "@/components/remocn/alert-dialog";

export const Scene = () => {
  const state = useCurrentState(
    [
      { at: 32, state: "opened" },
      { at: 92, state: "closed" },
    ],
    "closed",
  );

  return <AlertDialog title="Delete account?" state={state} />;
};

Each at is a Sequence-local authored frame. State persists between steps: opened at frame 32 keeps the dialog visible until closed fires at frame 92. See Concepts for the full useCurrentState API.

Smooth transitions

State changes via state snap with no cross-fade. For animated transitions, use useAlertDialogTransition from the copied use-alert-dialog-transition.ts file. It reads the frame, interpolates between state presets, and returns a resolved AlertDialogStyle — pass it to the style prop:

import { AlertDialog } from "@/components/remocn/alert-dialog";
import { useAlertDialogTransition } from "@/components/remocn/use-alert-dialog-transition";

export const Scene = () => {
  const style = useAlertDialogTransition([
    { at: 32, state: "opened", duration: 16 },
    { at: 92, state: "closed", duration: 12 },
  ]);
  return <AlertDialog title="Delete account?" style={style} />;
};

The duration field on each step overrides the file's DEFAULT_DURATION (= 12) for that specific transition. To globally tune timing and easing, edit use-alert-dialog-transition.ts directly in your project — that file is yours (shadcn "own your code" philosophy).

style takes precedence over state when both are provided.

Props

PropTypeDefaultDescription
state
"opened" | "closed""closed"Current visual state (snap path). State changes snap — no automatic cross-fade.
style
AlertDialogStyleResolved animated visual (smooth path). Pass an interpolated AlertDialogStyle from useAlertDialogTransition. Takes precedence over state when provided.
title
string"Delete account?"Headline of the alert dialog popup.
description
string"This action cannot be undone. This will permanently remove your data from our servers."Body copy displayed under the title.
actionLabel
string"Delete"Label of the confirming (destructive) action button.
cancelLabel
string"Cancel"Label of the dismissing action button.
theme
Partial<RemocnTheme>Per-component theme override. Merges with the active RemocnUIProvider theme and the mode defaults. Must be concrete oklch/hex/rgb values — not CSS custom properties.
mode
"light" | "dark""light"Sets the base palette. Overrides the mode on RemocnUIProvider when both are present.
className
stringOptional className applied to the popup card element.