Skip to content

Production-ready animations, transitions, backgrounds, and scenes for Remotion

Merge branch 'main' into feat/launch-pack-registry

kapishdima75cc594c07f1
diff --cc app/(home)/legal/content.tsx
index a704069a,00000000..0fa33d32
mode 100644,000000..100644
--- a/app/(home)/legal/content.tsx
+++ b/app/(home)/legal/content.tsx
@@@ -1,197 -1,0 +1,228 @@@
+import type { ReactNode } from "react";
+import { GITHUB_URL, SUPPORT_EMAIL } from "@/config/site";
+
- export const LAST_UPDATED = "July 24, 2026";
++export const LAST_UPDATED = "October 10, 2026";
+
+export type LegalItem = { title: ReactNode; body: ReactNode };
+
+export type LegalSection = {
+ id: string;
+ title: string;
+ /** Lead paragraph(s) under the section title. */
+ body?: ReactNode;
+ /** Bulleted facts, drawn as cards. */
+ items?: LegalItem[];
+ /** Name / description rows, drawn as a table card. */
+ rows?: LegalItem[];
+};
+
+export type LegalPart = {
+ id: string;
+ title: string;
+ sections: LegalSection[];
+};
+
+function A({ href, children }: { href: string; children: ReactNode }) {
+ return (
+ <a
+ href={href}
+ className="rounded-[2px] underline decoration-divider underline-offset-[3px] transition-colors hover:decoration-foreground focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none"
+ >
+ {children}
+ </a>
+ );
+}
+
+export const Mail = () => (
+ <A href={`mailto:${SUPPORT_EMAIL}`}>{SUPPORT_EMAIL}</A>
+);
+
+export const LEGAL_INTRO = {
+ lead: "How remocn handles your data, and the terms that apply when you use the site or buy something.",
+ body: (
+ <>
+ remocn (&ldquo;we&rdquo;) operates{" "}
+ <A href="https://remocn.dev">remocn.dev</A> — an open-source registry of
+ video components for Remotion. If anything on this page is unclear, email
+ us at <Mail />.
+ </>
+ ),
+};
+
+export const LEGAL_PARTS: LegalPart[] = [
+ {
+ id: "privacy",
+ title: "Privacy Policy",
+ sections: [
+ {
+ id: "what-we-collect",
+ title: "What we collect",
+ body: "The site has no accounts and no sign-up. You can browse the docs, copy components, and use everything on the site without giving us any personal data.",
+ items: [
+ {
+ title: "Usage analytics.",
+ body: (
+ <>
+ We use <A href="https://openpanel.dev">OpenPanel</A> to collect
+ anonymous usage data: pages visited, referrer, browser and
+ device type, and coarse location (country level). This tells us
+ which components people actually use. We do not use advertising
+ trackers, we do not build cross-site profiles, and we never sell
+ data.
+ </>
+ ),
+ },
+ {
+ title: "Local preferences.",
+ body: "Your theme choice (light or dark) is stored in your browser’s localStorage and never leaves your device.",
+ },
+ {
+ title: "Server logs.",
+ body: "Our hosting infrastructure keeps standard access logs (IP address, requested URL, timestamp) for security and operations. They are rotated automatically and not used for anything else.",
+ },
+ ],
+ },
+ {
+ id: "payments",
+ title: "Payments",
+ body: (
+ <>
+ Paid products are sold through <A href="https://creem.io">Creem</A>,
+ our merchant of record. Creem runs the checkout and handles payment
+ processing, invoicing, and taxes. Your card details go directly to
+ Creem and its payment processors — they never touch our servers.
+ After a purchase we receive only what is needed to deliver it: your
+ email address, the product, and the order details. How Creem handles
+ your data is described in{" "}
+ <A href="https://www.creem.io/privacy">Creem’s privacy policy</A>.
+ </>
+ ),
+ },
++ {
++ id: "plugin",
++ title: "The plugin and MCP server",
++ body: (
++ <>
++ The remocn plugin for Claude Code and Codex and the MCP server at{" "}
++ <code>remocn.dev/mcp</code> need no account and collect no personal
++ data.
++ </>
++ ),
++ items: [
++ {
++ title: "MCP server.",
++ body: "The server is stateless. It answers each request from the public component catalog and does not store or log what you send it: search queries, video briefs and component props are used to build the answer and then discarded. The standard access logs described above apply, as for the rest of the site.",
++ },
++ {
++ title: "Previews in chat.",
++ body: (
++ <>
++ Component previews shown inside Claude or ChatGPT load pages
++ from <code>remocn.dev/embed</code>. Those pages run no
++ analytics, so the props in their address are not recorded.
++ </>
++ ),
++ },
++ {
++ title: "The plugin.",
++ body: "Its skills run on your machine, inside your agent. They read public documentation and registry files from remocn.dev and install packages from npm. Nothing about your project or your prompts is sent to us.",
++ },
++ ],
++ },
+ {
+ id: "third-party-services",
+ title: "Third-party services",
+ rows: [
+ {
+ title: <A href="https://openpanel.dev">OpenPanel</A>,
+ body: "Anonymous usage analytics.",
+ },
+ {
+ title: <A href="https://creem.io">Creem</A>,
+ body: "Checkout and payments, as merchant of record.",
+ },
+ {
+ title: <A href={GITHUB_URL}>GitHub</A>,
+ body: "Source code, issues, and sponsorships. Anything you do there is governed by GitHub’s own terms.",
+ },
+ ],
+ },
+ {
+ id: "your-data",
+ title: "Your data",
+ body: (
+ <>
+ We keep order emails for as long as we need them to provide support
+ and meet legal obligations. To ask what we hold about you, or to
+ have it deleted, email <Mail /> and we will sort it out.
+ </>
+ ),
+ },
+ ],
+ },
+ {
+ id: "terms",
+ title: "Terms of Service",
+ sections: [
+ {
+ id: "free-components",
+ title: "The site and free components",
+ body: (
+ <>
+ The free components in the registry are released under the{" "}
+ <A href={`${GITHUB_URL}/blob/main/LICENSE`}>MIT license</A>. You can
+ copy them, modify them, and ship them in personal or commercial
+ projects without attribution. The site and the components are
+ provided &ldquo;as is&rdquo;, without warranty of any kind.
+ </>
+ ),
+ },
+ {
+ id: "paid-products",
+ title: "Paid products",
+ body: "Some products are paid. Unless a product states otherwise at purchase, buying it grants you a non-exclusive license to use it in any number of your own projects, commercial ones included. What it does not grant is the right to redistribute or resell the product itself — for example republishing the components in another registry, template marketplace, or paid bundle.",
+ },
+ {
+ id: "purchases-and-refunds",
+ title: "Purchases and refunds",
+ body: (
+ <>
+ Purchases are processed by Creem as merchant of record, so the sale
+ itself is also subject to the terms Creem presents at checkout. If a
+ product is broken or not as described, email <Mail /> within 14 days
+ of purchase and we will fix it or refund you.
+ </>
+ ),
+ },
+ {
+ id: "liability",
+ title: "Liability",
+ body: "To the maximum extent permitted by law, we are not liable for indirect or consequential damages arising from your use of the site or its products, and our total liability is limited to the amount you paid us in the twelve months before the claim. Free products come with no liability at all — they are yours to own, audit, and modify.",
+ },
+ {
+ id: "changes",
+ title: "Changes",
+ body: "We may update this page as the project evolves — for example when new products or services launch. The date at the top reflects the latest revision, and continued use of the site after a change means you accept it.",
+ },
+ {
+ id: "contact",
+ title: "Contact",
+ body: (
+ <>
+ For anything related to privacy, purchases, or these terms: <Mail />
+ .
+ </>
+ ),
+ },
+ ],
+ },
+];
+
- /** Flat, numbered list of sections (01–10) for the index and the article. */
++/** Flat, numbered list of sections (01–11) for the index and the article. */
+export const LEGAL_INDEX = LEGAL_PARTS.flatMap((part) => part.sections).map(
+ (section, index) => ({
+ id: section.id,
+ title: section.title,
+ number: String(index + 1).padStart(2, "0"),
+ }),
+);
diff --cc components/docs/blocks/controls/control-styles.ts
index 0f3586b0,00000000..b17195cf
mode 100644,000000..100644
--- a/components/docs/blocks/controls/control-styles.ts
+++ b/components/docs/blocks/controls/control-styles.ts
@@@ -1,21 -1,0 +1,23 @@@
+/**
+ * Shared surfaces for the customizer controls on the dark player panel: a
+ * 36px tile (44px on phones) with the label on the left and the value on the
+ * right, a lighter fill on hover and a fuchsia ring while editing.
++ * `customizer-control` is a hook for the compact density in
++ * `ComponentCustomizer`.
+ */
+export const CONTROL =
- "relative flex h-9 min-w-0 items-center justify-between gap-3 overflow-hidden rounded-tile bg-white/5 px-3 text-caption leading-[17px] font-medium transition-colors duration-150 hover:bg-white/8 max-md:h-11 max-md:text-small max-md:leading-[18px]";
++ "customizer-control relative flex h-9 min-w-0 items-center justify-between gap-3 overflow-hidden rounded-tile bg-white/5 px-3 text-caption leading-[17px] font-medium transition-colors duration-150 hover:bg-white/8 max-md:h-11 max-md:text-small max-md:leading-[18px]";
+
+export const CONTROL_FOCUS =
+ "focus-within:ring-[1.5px] focus-within:ring-primary-bright focus-within:ring-inset";
+
+export const CONTROL_LABEL = "shrink-0 text-white/70";
+
+export const CONTROL_VALUE = "text-[#fafafa]";
+
+/** Decimal places implied by a step (0.01 → 2), so 0.9 reads as 0.90. */
+export function formatStep(value: number, step: number) {
+ const dot = String(step).indexOf(".");
+ const decimals = dot === -1 ? 0 : String(step).length - dot - 1;
+ return value.toFixed(decimals);
+}
diff --cc components/docs/component-customizer.tsx
index c4a3b3f4,e255f49c..b874a76e
--- a/components/docs/component-customizer.tsx
+++ b/components/docs/component-customizer.tsx
@@@ -151,34 -238,6 +151,46 @@@ function Control(
}
}
+function GroupChevron({ open, auto }: { open: boolean; auto: boolean }) {
+ return (
+ <svg
+ viewBox="0 0 24 24"
+ aria-hidden="true"
+ className={cn(
+ "size-3 shrink-0 text-white/40 transition-transform duration-150 max-md:size-3.5",
+ !open && "-rotate-90",
+ auto && "max-md:-rotate-90",
+ )}
+ >
+ <path
+ d="M6 9l6 6 6-6"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2.5"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ />
+ </svg>
+ );
+}
+
++// Compact density for tight hosts (Remotion Studio's caption picker): shorter
++// tiles and smaller type. Scoped through the `customizer-control` hook so
++// every control type follows, and it outranks the phone sizes the narrow
++// Studio panel would otherwise pick up.
++const COMPACT = [
++ "[&_.customizer-control]:h-7 [&_.customizer-control]:gap-2 [&_.customizer-control]:rounded-[8px] [&_.customizer-control]:px-2.5 [&_.customizer-control]:text-xs [&_.customizer-control]:leading-4 [&_.customizer-control]:whitespace-nowrap",
++ "[&_.customizer-control_input]:text-xs",
++ // The swatch already shows the colour; the hex would crowd out the label.
++ "[&_.customizer-control:has(input[type=color])_.tabular-nums]:hidden",
++].join(" ");
++
+/**
+ * Every prop the preview honours, grouped by intent (content, timing, style)
+ * into collapsible sections. Controls flow three to a row on desktop and
- * stack on phones; long text takes a full row.
++ * stack on phones; long text takes a full row. The compact density drops the
++ * groups for one dense grid that fits a small fixed panel.
+ */
export function ComponentCustomizer({
controls,
values,
@@@ -187,75 -247,24 +200,101 @@@
controls: ControlConfig;
values: Record<string, unknown>;
onChange: (key: string, value: unknown) => void;
+ density?: "default" | "compact";
}) {
+ const phone = usePhone();
+ const [open, setOpen] = useState<Partial<Record<Group["id"], boolean>>>({});
+
++ if (density === "compact") {
++ return (
++ <div
++ className={cn(
++ "grid grid-cols-1 gap-1.5 @min-[280px]:grid-cols-2",
++ COMPACT,
++ )}
++ >
++ {Object.entries(controls).map(([key, ctrl]) => (
++ <div
++ key={key}
++ className={cn("min-w-0", isLong(ctrl) && "col-span-full")}
++ >
++ <Control
++ id={`ctrl-${key}`}
++ ctrl={ctrl}
++ value={values[key]}
++ onChange={(value) => onChange(key, value)}
++ />
++ </div>
++ ))}
++ </div>
++ );
++ }
++
+ const groups = GROUPS.map((group) => ({
+ ...group,
+ entries: Object.entries(controls).filter(
+ ([key, ctrl]) => groupOf(key, ctrl) === group.id,
+ ),
+ })).filter((group) => group.entries.length > 0);
+
return (
- <div
- className={cn(
- "grid gap-3 sm:grid-cols-2 lg:grid-cols-3",
- density === "compact" && COMPACT,
- )}
- >
- {Object.entries(controls).map(([key, ctrl]) => (
- <Control
- key={key}
- id={`ctrl-${key}`}
- ctrl={ctrl}
- value={values[key]}
- onChange={(value) => onChange(key, value)}
- />
- ))}
+ <div className="flex flex-col">
+ {groups.map((group, index) => {
+ const chosen = open[group.id];
+ // Undecided groups follow the layout: open on desktop, first-only on phones.
+ const autoCollapsed = chosen === undefined && index > 0;
+ const expanded = chosen ?? !(phone && index > 0);
+ const panelId = `customize-${group.id}`;
+ return (
+ <section
+ key={group.id}
+ aria-label={group.title}
+ className={cn(
+ "flex flex-col pb-2 max-md:gap-1.5",
+ index > 0 && "border-t border-white/6",
+ )}
+ >
+ <button
+ type="button"
+ aria-expanded={expanded}
+ aria-controls={panelId}
+ onClick={() =>
+ setOpen((prev) => ({ ...prev, [group.id]: !expanded }))
+ }
+ className="flex h-9 shrink-0 cursor-pointer items-center justify-between rounded-tile px-0.5 text-caption leading-[17px] font-semibold text-white/70 outline-none hover:text-[#fafafa] focus-visible:ring-2 focus-visible:ring-white/40 max-md:h-11 max-md:px-1.5 max-md:text-small max-md:leading-[18px]"
+ >
+ {group.title}
+ <GroupChevron open={chosen ?? true} auto={autoCollapsed} />
+ </button>
+ <div
+ id={panelId}
+ className={cn(
+ "flex flex-wrap gap-1.5",
+ chosen === false && "hidden",
+ autoCollapsed && "max-md:hidden",
+ )}
+ >
+ {group.entries.map(([key, ctrl]) => {
+ const { className, style } = slot(ctrl);
+ return (
+ <div
+ key={key}
+ style={style}
+ className={cn("min-w-0 max-md:basis-full!", className)}
+ >
+ <Control
+ id={`ctrl-${key}`}
+ ctrl={ctrl}
+ value={values[key]}
+ onChange={(value) => onChange(key, value)}
+ />
+ </div>
+ );
+ })}
+ </div>
+ </section>
+ );
+ })}
</div>
);
}
diff --cc components/docs/component-preview.tsx
index a33e3c05,5c11788f..fcd5dd3d
--- a/components/docs/component-preview.tsx
+++ b/components/docs/component-preview.tsx
@@@ -1,33 -1,76 +1,89 @@@
"use client";
++import type { PlayerRef } from "@remotion/player";
import type { StudioElementPayload } from "@remotion/studio-protocol";
- import { Suspense, use, useMemo } from "react";
- import type { ResolvedComponentConfig } from "@/lib/customizer-config";
-import { CheckIcon, LinkIcon, RotateCcwIcon } from "lucide-react";
-import { useQueryStates } from "nuqs";
-import { Suspense, use, useEffect, useMemo, useRef, useState } from "react";
-import { CodeBlock } from "@/components/docs/code-block";
-import { Button } from "@/components/ui/button";
-import {
- Frame,
- FrameHeader,
- FramePanel,
- FrameTitle,
-} from "@/components/ui/frame";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
-import { useTrackEvent } from "@/lib/analytics";
++import { RotateCcwIcon } from "lucide-react";
+ import {
- getDefaults,
- type ResolvedComponentConfig,
++ type ReactNode,
++ Suspense,
++ use,
++ useCallback,
++ useMemo,
++ useRef,
++ useState,
++} from "react";
++import { Button } from "@/components/ui/button";
++import type {
++ ControlConfig,
++ ResolvedComponentConfig,
+ } from "@/lib/customizer-config";
-import { buildParsers, PreviewStage } from "@/lib/ui-preview-internals";
+import { cn } from "@/lib/utils";
import registry, { loadComponentConfig } from "@/registry/__index__";
+import { CustomizePanel } from "./blocks/customize-panel";
+import { DocsPlayer } from "./blocks/player/docs-player";
+import { PlayerFallback, UnknownBlock } from "./blocks/player/player-fallback";
++import {
++ PlayerStage,
++ type StageComposition,
++} from "./blocks/player/player-stage";
+import { BLOCK_SPACING } from "./blocks/spacing";
+import { useCustomizer } from "./blocks/use-customizer";
+ import { ComponentCustomizer } from "./component-customizer";
import { StudioActions } from "./studio-actions";
++type Layout = "caption-picker" | null;
++
+ type PickerHeader = {
- start: React.ReactNode;
++ start: ReactNode;
+ title: string;
- end?: React.ReactNode;
++ end?: ReactNode;
+ };
+
export function ComponentPreview({
name,
studioElement,
- layout,
++ layout = null,
+ header,
}: {
name: string;
studioElement?: StudioElementPayload;
- layout: "caption-picker" | null;
++ /** `"caption-picker"`: the compact layout for Remotion Studio's caption picker. */
++ layout?: Layout;
+ /** Caption picker only: the header row around the style's actions. */
+ header?: PickerHeader;
}) {
const entry = registry[name];
+ if (!entry) return <UnknownBlock kind="component" name={name} />;
- if (!entry) {
++ if (layout === "caption-picker") {
+ return (
- <div className="not-prose mb-6 rounded-lg border border-fd-border p-4 text-sm text-fd-muted-foreground">
- Unknown component: <code>{name}</code>
- </div>
++ <Suspense
++ fallback={
++ <div className="min-h-0 flex-1 animate-pulse rounded-card bg-muted" />
++ }
++ >
++ <Preview
++ name={name}
++ load={entry.load}
++ studioElement={studioElement}
++ layout={layout}
++ header={header}
++ />
++ </Suspense>
+ );
+ }
+
return (
- <Suspense
- fallback={
- <div
- className={
- layout === "caption-picker"
- ? "min-h-0 flex-1 animate-pulse rounded-2xl bg-muted"
- : "not-prose mb-6 aspect-[1.9/1] w-full animate-pulse rounded-2xl bg-muted"
- }
+ <div className={cn("not-prose", BLOCK_SPACING)}>
+ <Suspense fallback={<PlayerFallback />}>
- <Preview name={name} load={entry.load} studioElement={studioElement} />
++ <Preview
++ name={name}
++ load={entry.load}
++ studioElement={studioElement}
++ layout={layout}
+ />
- }
- >
- <Preview
- name={name}
- load={entry.load}
- studioElement={studioElement}
- layout={layout}
- header={header}
- />
- </Suspense>
+ </Suspense>
+ </div>
);
}
@@@ -38,53 -83,223 +96,163 @@@ function Preview(
}: {
name: string;
studioElement?: StudioElementPayload;
- layout: "caption-picker" | null;
++ layout: Layout;
+ header?: PickerHeader;
// biome-ignore lint/suspicious/noExplicitAny: dynamically-loaded Remotion composition, props shape varies per component
load: () => Promise<{ default: React.ComponentType<any> }>;
}) {
// Suspends until this component's config chunk resolves, then returns
// synchronously from the cached promise. No other config is fetched.
const config = use(loadComponentConfig(name));
- const trackEvent = useTrackEvent();
- const { parsers, urlKeys } = useMemo(
- () => buildParsers(name, config.controls),
- [name, config.controls],
- );
- const defaults = useMemo(
- () => getDefaults(config.controls),
- [config.controls],
+ const { values, isDefault, change, reset } = useCustomizer(
+ name,
+ config.controls,
);
-
- const [values, setValues] = useQueryStates(parsers, {
- urlKeys,
- clearOnDefault: true,
- shallow: true,
- });
-
- const isDefault = useMemo(
- () => Object.entries(defaults).every(([k, v]) => values[k] === v),
- [defaults, values],
- );
-
const code = useMemo(() => generateCode(config, values), [config, values]);
+ const installPayload = useMemo(() => {
+ if (!studioElement?.element.isCaptionStyle) return studioElement;
+ // The generated transcript comes from Studio, never from the demo fixture.
+ const { captions: _captions, ...styleProps } = values;
+ return {
+ ...studioElement,
+ element: { ...studioElement.element, initialProps: styleProps },
+ } as StudioElementPayload;
+ }, [studioElement, values]);
+
- const [copied, setCopied] = useState(false);
- const handleCopyLink = () => {
- if (typeof window === "undefined") return;
- navigator.clipboard.writeText(window.location.href);
- setCopied(true);
- trackEvent("customized_link_shared", { component: name });
- setTimeout(() => setCopied(false), 1500);
- };
-
- const handleReset = () => {
- setValues(null);
- trackEvent("customizer_reset", { component: name });
- };
-
- useEffect(() => {
- trackEvent("docs_component_viewed", { component: name });
- }, [name, trackEvent]);
-
- const customizeTimers = useRef<Map<string, ReturnType<typeof setTimeout>>>(
- new Map(),
- );
- useEffect(() => {
- const timers = customizeTimers.current;
- return () => {
- for (const timer of timers.values()) clearTimeout(timer);
- timers.clear();
- };
- }, []);
- const handleCustomizeChange = (key: string, value: unknown) => {
- setValues((prev) => ({ ...prev, [key]: value }));
- const existing = customizeTimers.current.get(key);
- if (existing) clearTimeout(existing);
- customizeTimers.current.set(
- key,
- setTimeout(() => {
- trackEvent("component_customized", { component: name, prop: key });
- customizeTimers.current.delete(key);
- }, 500),
- );
++ const composition: StageComposition = {
++ load,
++ inputProps: values,
++ durationInFrames:
++ config.getDurationInFrames?.(values) ?? config.durationInFrames,
++ fps: config.fps,
++ compositionWidth: config.compositionWidth,
++ compositionHeight: config.compositionHeight,
++ previewBackdrop: config.previewBackdrop,
+ };
-
- const stage = (className: string, controls = true) => (
- <PreviewStage
- name={name}
- load={load}
- inputProps={values}
- durationInFrames={
- config.getDurationInFrames?.(values) ?? config.durationInFrames
- }
- fps={config.fps}
- compositionWidth={config.compositionWidth}
- compositionHeight={config.compositionHeight}
- previewBackdrop={config.previewBackdrop}
- className={className}
- controls={controls}
- />
- );
+ const studioActions = installPayload ? (
+ <StudioActions name={name} payload={installPayload} />
+ ) : null;
+
- // Remotion Studio's caption picker is a small fixed panel (~600x290), so
- // everything has to fit without scrolling the page: one header row with the
- // actions, then the preview beside compact options. The transcript control
- // is hidden: Studio supplies the captions.
+ if (layout === "caption-picker") {
+ return (
- <div className="flex min-h-0 flex-1 flex-col gap-2">
- <div className="grid shrink-0 grid-cols-[1fr_auto_1fr] items-center gap-2">
- <div className="justify-self-start">{header?.start}</div>
- <h1 className="min-w-0 truncate text-center text-sm font-semibold tracking-tight">
- {header?.title}
- </h1>
- <div className="flex items-center gap-1 justify-self-end">
- {header?.end}
- <Button
- variant="ghost"
- size="icon-sm"
- onClick={handleReset}
- disabled={isDefault}
- aria-label="Reset options"
- title="Reset options"
- className="text-muted-foreground hover:text-foreground disabled:opacity-40"
- >
- <RotateCcwIcon className="size-3.5" />
- </Button>
- {studioActions}
- </div>
- </div>
- <div className="flex min-h-0 flex-1 gap-3">
- <div className="surface-card aspect-video w-[40%] shrink-0 self-start overflow-hidden rounded-xl">
- {stage("aspect-auto h-full rounded-none", false)}
- </div>
- <div className="@container min-h-0 flex-1 overflow-x-hidden overflow-y-auto [scrollbar-color:color-mix(in_oklab,currentColor_25%,transparent)_transparent] [scrollbar-width:thin]">
- <div className="[&>div]:grid-cols-1 @min-[280px]:[&>div]:grid-cols-2">
- <ComponentCustomizer
- density="compact"
- controls={Object.fromEntries(
- Object.entries(config.controls).filter(
- ([key]) => key !== "captions",
- ),
- )}
- values={values as Record<string, unknown>}
- onChange={handleCustomizeChange}
- />
- </div>
- </div>
- </div>
- </div>
++ <CaptionPickerPreview
++ name={name}
++ header={header}
++ composition={composition}
++ // Studio supplies the captions, so the transcript control is hidden.
++ controls={Object.fromEntries(
++ Object.entries(config.controls).filter(([key]) => key !== "captions"),
++ )}
++ values={values}
++ isDefault={isDefault}
++ onChange={change}
++ onReset={reset}
++ actions={studioActions}
++ />
+ );
+ }
return (
- <div className="not-prose mb-6 flex w-full flex-col gap-4">
- <Frame>
- <Tabs defaultValue="preview" className="gap-0">
- <FrameHeader className="flex-row items-center justify-between gap-3 px-2 py-2">
- <TabsList>
- <TabsTrigger value="preview">Preview</TabsTrigger>
- <TabsTrigger value="code">Code</TabsTrigger>
- </TabsList>
- {studioActions}
- </FrameHeader>
- <FramePanel className="overflow-hidden p-0">
- <TabsContent value="preview" className="mt-0">
- {stage("rounded-none")}
- </TabsContent>
- <TabsContent value="code" className="mt-0">
- <CodeBlock code={code} />
- </TabsContent>
- </FramePanel>
- </Tabs>
- </Frame>
+ <DocsPlayer
+ name={name}
+ code={code}
- actions={
- studioElement ? (
- <StudioActions name={name} payload={studioElement} />
- ) : null
- }
- composition={{
- load,
- inputProps: values,
- durationInFrames:
- config.getDurationInFrames?.(values) ?? config.durationInFrames,
- fps: config.fps,
- compositionWidth: config.compositionWidth,
- compositionHeight: config.compositionHeight,
- previewBackdrop: config.previewBackdrop,
- }}
++ actions={studioActions}
++ composition={composition}
+ >
+ {Object.keys(config.controls).length > 0 ? (
+ <CustomizePanel
+ name={name}
+ controls={config.controls}
+ values={values}
+ code={code}
+ isDefault={isDefault}
+ onChange={change}
+ onReset={reset}
+ />
+ ) : null}
+ </DocsPlayer>
+ );
+}
- <Frame className="mt-2">
- <FrameHeader className="flex-row items-center justify-between px-3 py-2">
- <FrameTitle>Customize</FrameTitle>
- <div className="flex items-center gap-1">
- <Button
- variant="outline"
- size="icon-sm"
- onClick={handleCopyLink}
- aria-label="Copy share link"
- title="Copy share link"
- className="relative text-muted-foreground before:absolute before:-inset-x-0.5 before:-inset-y-1.5 before:content-[''] hover:text-foreground"
- >
- {copied ? (
- <CheckIcon className="size-3.5" />
- ) : (
- <LinkIcon className="size-3.5" />
- )}
- </Button>
- <Button
- variant="outline"
- size="icon-sm"
- onClick={handleReset}
- disabled={isDefault}
- aria-label="Reset to defaults"
- title="Reset to defaults"
- className="relative text-muted-foreground before:absolute before:-inset-x-0.5 before:-inset-y-1.5 before:content-[''] hover:text-foreground disabled:opacity-40"
- >
- <RotateCcwIcon className="size-3.5" />
- </Button>
- </div>
- </FrameHeader>
- <FramePanel className="p-3">
++/**
++ * Remotion Studio's caption picker is a small fixed panel (~600x290), so
++ * everything has to fit without scrolling the page: one header row with the
++ * actions, then the dark player surface with the stage beside compact options.
++ */
++function CaptionPickerPreview({
++ name,
++ header,
++ composition,
++ controls,
++ values,
++ isDefault,
++ onChange,
++ onReset,
++ actions,
++}: {
++ name: string;
++ header?: PickerHeader;
++ composition: StageComposition;
++ controls: ControlConfig;
++ values: Record<string, unknown>;
++ isDefault: boolean;
++ onChange: (key: string, value: unknown) => void;
++ onReset: () => void;
++ actions: ReactNode;
++}) {
++ const playerRef = useRef<PlayerRef | null>(null);
++ const [mounted, setMounted] = useState(false);
++ const mount = useCallback(() => setMounted(true), []);
++
++ return (
++ <div className="flex min-h-0 flex-1 flex-col gap-2">
++ <div className="grid shrink-0 grid-cols-[1fr_auto_1fr] items-center gap-2">
++ <div className="justify-self-start">{header?.start}</div>
++ <h1 className="min-w-0 truncate text-center text-sm font-semibold tracking-tight">
++ {header?.title}
++ </h1>
++ {/* The narrow Studio panel would otherwise get the 44px phone buttons. */}
++ <div className="flex items-center gap-1 justify-self-end [&_button]:h-8">
++ {header?.end}
++ <Button
++ variant="ghost"
++ size="icon-sm"
++ onClick={onReset}
++ disabled={isDefault}
++ aria-label="Reset options"
++ title="Reset options"
++ className="text-muted-foreground hover:text-foreground disabled:opacity-40"
++ >
++ <RotateCcwIcon className="size-3.5" />
++ </Button>
++ {actions}
++ </div>
++ </div>
++ <section
++ aria-label={`${name.replaceAll("-", " ")} preview`}
++ className="flex min-h-0 flex-1 gap-2 rounded-card border border-transparent bg-dark-surface p-2 text-[#fafafa] dark:border-hairline dark:bg-surface"
++ >
++ <PlayerStage
++ name={name.replaceAll("-", " ")}
++ composition={composition}
++ playerRef={playerRef}
++ mounted={mounted}
++ onMount={mount}
++ className="w-[40%] shrink-0 self-start"
++ />
++ <div className="@container min-h-0 flex-1 overflow-x-hidden overflow-y-auto [scrollbar-color:rgb(255_255_255/0.25)_transparent] [scrollbar-width:thin]">
+ <ComponentCustomizer
- controls={config.controls}
- values={values as Record<string, unknown>}
- onChange={handleCustomizeChange}
++ density="compact"
++ controls={controls}
++ values={values}
++ onChange={onChange}
+ />
- </FramePanel>
- </Frame>
++ </div>
++ </section>
+ </div>
+ );
+ }
+
function generateCode(
config: ResolvedComponentConfig,
props: Record<string, unknown>,
diff --cc components/docs/studio-actions.tsx
index 63bf75d5,2ad8efd3..4016d39a
--- a/components/docs/studio-actions.tsx
+++ b/components/docs/studio-actions.tsx
@@@ -5,11 -5,13 +5,12 @@@ import
isInsideStudio,
type StudioElementPayload,
setStudioDragData,
+ subscribeToCaptionStyleSelection,
} from "@remotion/studio-protocol";
-import { GripVerticalIcon, Loader2Icon } from "lucide-react";
+import { Loader2Icon } from "lucide-react";
import { useEffect, useLayoutEffect, useRef, useState } from "react";
-import { Button } from "@/components/ui/button";
-import { Remotion } from "@/components/ui/svgs/remotion";
import { useTrackEvent } from "@/lib/analytics";
+import { cn } from "@/lib/utils";
type Status = "idle" | "pending" | "success" | "error";
@@@ -79,39 -82,40 +94,44 @@@ export function StudioActions(
};
return (
- <div className="flex min-w-0 items-center gap-1.5">
- {message ? (
- <output
- aria-live="polite"
- className="truncate text-xs text-muted-foreground"
- >
- {message}
- </output>
- ) : null}
- <Button
- variant="outline"
- size="sm"
+ <div className="flex min-w-0 items-center gap-1">
+ <output
+ aria-live="polite"
+ className="truncate text-mono text-dark-subtle max-md:sr-only"
+ >
+ {message}
+ </output>
+ <button
+ type="button"
onClick={handleInstall}
disabled={status === "pending"}
+ aria-pressed={isCaptionPicker ? isSelected : undefined}
- className="text-muted-foreground hover:text-foreground"
+ className={cn(STUDIO_BUTTON, "gap-2 px-3 max-md:h-11 max-md:gap-[7px]")}
>
{status === "pending" ? (
- <Loader2Icon className="size-3.5 animate-spin" />
+ <Loader2Icon className="size-3.5 animate-spin motion-reduce:animate-[spin_2s_linear_infinite]" />
) : (
- <Remotion className="size-3.5" />
+ <svg viewBox="0 0 24 24" aria-hidden="true" className="size-3.5">
+ <path
+ d="M7 4.5v15l12.5-7.5Z"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="1.8"
+ strokeLinejoin="round"
+ />
+ </svg>
)}
- {status === "success"
- ? "Sent to Remotion Studio"
- : "Add to Remotion Studio"}
+ {isCaptionPicker
+ ? isSelected
+ ? "Update style"
+ : "Use this style"
+ : status === "success"
+ ? "Sent to Remotion Studio"
+ : "Add to Remotion Studio"}
- </Button>
+ </button>
{isEmbeddedInStudio === false ? (
- <Button
- variant="outline"
- size="icon-sm"
+ <button
+ type="button"
draggable
onDragStart={handleDragStart}
aria-label="Drag into Remotion Studio"
diff --cc config/docs-directory.ts
index b75bd170,00000000..ee6d6f67
mode 100644,000000..100644
--- a/config/docs-directory.ts
+++ b/config/docs-directory.ts
@@@ -1,99 -1,0 +1,106 @@@
+export const DOCS_MENU_HREF = "/docs/getting-started/introduction";
+
+export const START_HERE = [
+ {
+ href: "/docs/getting-started/introduction",
+ description: "What remocn is and how the pieces fit",
+ },
+ {
+ href: "/docs/getting-started/installation",
+ description: "Add components with the shadcn CLI",
+ },
+ {
+ href: "/docs/getting-started/agent-skill",
+ description: "Teach your agent the whole catalog",
+ },
+ {
+ href: "/docs/getting-started/plugin",
+ description: "One command in Claude Code or Codex",
+ },
+];
+
+export const CRAFT = [
+ "/docs/craft/design-defaults",
+ "/docs/craft/motion-principles",
+ "/docs/craft/anti-patterns",
+];
+
+export const GUIDES = {
+ index: "/docs/guides",
+ setup: "/docs/guides/setup",
+ videos: [
+ "/docs/guides/launch-video",
+ "/docs/guides/feature-announcement",
+ "/docs/guides/product-demo",
+ "/docs/guides/teaser",
+ "/docs/guides/showcase-reel",
+ "/docs/guides/changelog-video",
+ ],
+ practices: [
+ "/docs/guides/directing-your-agent",
+ "/docs/guides/words-on-screen",
+ "/docs/guides/one-video-three-formats",
+ ],
+};
+
+export const CATEGORIES = [
+ { segment: "typography", label: "Typography", href: "/docs/typography" },
+ { segment: "ui", label: "UI", href: "/docs/ui" },
+ { segment: "transitions", label: "Transitions", href: "/docs/transitions" },
+ {
+ segment: "captions",
+ label: "Captions",
+ href: "/docs/captions/getting-started/introduction",
+ },
+ {
+ segment: "shaders",
+ label: "Shaders",
+ href: "/docs/shaders/getting-started/introduction",
+ },
+ {
+ segment: "motion-graphics",
+ label: "Motion graphics",
+ href: "/docs/motion-graphics",
+ },
++ { segment: "logo-stings", label: "Logo stings", href: "/docs/logo-stings" },
++ { segment: "camera", label: "Camera & physics", href: "/docs/camera" },
++ {
++ segment: "graphic-looks",
++ label: "Graphic looks",
++ href: "/docs/graphic-looks",
++ },
+ { segment: "ui-blocks", label: "UI blocks", href: "/docs/ui-blocks" },
+ { segment: "effects", label: "Effects", href: "/docs/effects" },
+ {
+ segment: "filters",
+ label: "Filters",
+ href: "/docs/filters/getting-started/introduction",
+ },
+ { segment: "social", label: "Social", href: "/docs/social" },
+ { segment: "layout", label: "Layout", href: "/docs/layout" },
+ {
+ segment: "compositions",
+ label: "Compositions",
+ href: "/docs/compositions",
+ },
+ { segment: "icons", label: "Icons", href: "/docs/icons/gallery" },
+];
+
+export const AGENTS = [
+ { href: "/docs/ai/claude-code", mark: "claude" },
+ { href: "/docs/ai/claude-chat", mark: "claude" },
+ { href: "/docs/ai/chat-gpt", mark: "openai" },
+ { href: "/docs/ai/v0", mark: "v0" },
+ { href: "/docs/ai/opencode", mark: "opencode" },
+ { href: "/docs/ai/agent-run", mark: "agent-run" },
+] as const;
+
+export type AgentMark = (typeof AGENTS)[number]["mark"];
+
+export const TEMPLATES = [
+ "/docs/templates/release-teaser",
+ "/docs/templates/launch-anything",
+ "/docs/templates/brand-guidelines",
+ "/docs/templates/workflow-console",
+ "/docs/templates/fomo-limit-orders",
+];
diff --cc config/site.ts
index 7e9ff5fa,c81f9878..0bc17f31
--- a/config/site.ts
+++ b/config/site.ts
@@@ -91,28 -78,75 +91,52 @@@ export const NAV_LINKS: NavLink[] =
* tag another menu item — no component changes needed. See `withNewBadges`.
*/
export const NEW_BADGE_PATHS = new Set<string>([
- "/docs/motion-graphics/bauhaus-build",
- "/docs/motion-graphics/mondrian-split",
- "/docs/motion-graphics/truchet-flip",
- "/docs/motion-graphics/trim-burst",
- "/docs/motion-graphics/speed-lines",
- "/docs/motion-graphics/squiggle",
- "/docs/effects/keystroke",
- "/docs/ui-blocks/code-morph",
- "/docs/ai/agent-run",
- "/docs/typography/selection-snap",
- "/docs/typography/echo-stack",
- "/docs/typography/type-wall",
- "/docs/typography/ring-text",
- "/docs/typography/period-drop",
+ "/docs/transitions/iris-wipe",
+ "/docs/transitions/venetian-blinds",
+ "/docs/transitions/paper-tear",
+ "/docs/transitions/pixel-sort",
+ "/docs/transitions/light-leak",
+ "/docs/transitions/hyperspace",
+ "/docs/logo-stings/orbit-lock",
+ "/docs/logo-stings/puzzle-snap",
+ "/docs/logo-stings/spotlight",
+ "/docs/logo-stings/neon-sign",
+ "/docs/logo-stings/inflate",
+ "/docs/logo-stings/liquid-fill",
+ "/docs/logo-stings/accordion-unfold",
+ "/docs/logo-stings/anamorphic-flare",
+ "/docs/motion-graphics/pendulum-wave",
+ "/docs/motion-graphics/flow-field",
+ "/docs/motion-graphics/isometric-build",
+ "/docs/motion-graphics/life-grid",
+ "/docs/motion-graphics/string-art",
+ "/docs/motion-graphics/topo-lines",
+ "/docs/motion-graphics/phyllotaxis",
+ "/docs/camera/parallax-depth",
+ "/docs/camera/dolly-zoom",
+ "/docs/camera/turntable",
+ "/docs/camera/tiny-planet",
+ "/docs/camera/exploded-view",
+ "/docs/camera/gravity-pile",
+ "/docs/camera/cloth-reveal",
+ "/docs/camera/impact-shake",
+ "/docs/graphic-looks/riso-print",
+ "/docs/graphic-looks/line-boil",
+ "/docs/graphic-looks/blueprint",
+ "/docs/graphic-looks/duotone-beat",
+ "/docs/graphic-looks/comic-panels",
+ "/docs/graphic-looks/long-shadow",
+ "/docs/graphic-looks/synthwave",
+ "/docs/graphic-looks/brick-mosaic",
+ "/docs/graphic-looks/x-ray-scan",
]);
-export type FooterGroup = {
- label: string;
- links: NavLink[];
-};
-
-export const FOOTER_GROUPS: FooterGroup[] = [
- {
- label: "Registry",
- links: [
- { href: "/docs/typography", label: "Components" },
- { href: "/docs/shaders/getting-started/introduction", label: "Shaders" },
- { href: "/docs/icons/gallery", label: "Icons" },
- ],
- },
- {
- label: "Learn",
- links: [
- { href: "/docs/getting-started/introduction", label: "Docs" },
- { href: "/blog", label: "Blog" },
- { href: "/changelog", label: "Changelog" },
- ],
- },
- {
- label: "Project",
- links: [
- { href: STUDIO_URL, label: "Studio", external: true },
- { href: "/showcases", label: "Showcases" },
- { href: "/sponsors", label: "Sponsors" },
- { href: "/legal", label: "Privacy & Terms" },
- ],
- },
+// Flat footer row: site pages first, then the external profiles.
+export const FOOTER_LINKS: NavLink[] = [
+ { href: "/docs/getting-started/introduction", label: "Docs" },
+ { href: "/changelog", label: "Changelog" },
+ { href: STUDIO_URL, label: "Studio", external: true },
+ { href: "/sponsors", label: "Sponsors" },
+ { href: GITHUB_URL, label: "GitHub", external: true },
+ { href: X_URL, label: "X", external: true },
];
diff --cc content/docs/camera/index.mdx
index 00000000,26b4b9e9..143301a3
mode 000000,100644..100644
--- a/content/docs/camera/index.mdx
+++ b/content/docs/camera/index.mdx
@@@ -1,0 -1,68 +1,39 @@@
+ ---
+ title: Camera & Physics
+ description: Full-frame shots built on a simulated camera or a small physics engine, from parallax trucks and a dolly zoom to falling bodies and a cloth yank
+ ---
+
++import { CategoryIndex } from "@/components/docs/index/category/category-index";
++import { ComponentGroup } from "@/components/docs/index/category/component-group";
++
+ Each piece here owns the whole frame. The camera shots project a small 3D scene through a pinhole camera, and the physics pieces run a deterministic simulation once and play it back, so seeking and rendering always land on the same frame. Most ship with a built-in subject and accept your own content as children or layers.
+
-## Camera
++<CategoryIndex section="/docs/camera">
+
-<ComponentCardGrid
++<ComponentGroup
+ items={[
- {
- name: "Parallax Depth",
- description: "A layered landscape trucks sideways with a gentle push-in, near layers sliding faster than far ones",
- status: "stable",
- href: "/docs/camera/parallax-depth",
- },
- {
- name: "Dolly Zoom",
- description: "The vertigo shot: a corridor stretches while the subject in the middle keeps its exact size",
- status: "stable",
- href: "/docs/camera/dolly-zoom",
- },
- {
- name: "Turntable",
- description: "A product card with real thickness spins through front, edge and back with face shading and a floor shadow",
- status: "stable",
- href: "/docs/camera/turntable",
- },
- {
- name: "Tiny Planet",
- description: "A flat skyline bends into a tiny planet, then keeps turning beside the sun",
- status: "stable",
- href: "/docs/camera/tiny-planet",
- },
- {
- name: "Exploded View",
- description: "An isometric stack of slabs springs apart with leader lines and labels, then clicks back together",
- status: "stable",
- href: "/docs/camera/exploded-view",
- },
++ "parallax-depth",
++ "dolly-zoom",
++ "turntable",
++ "tiny-planet",
++ "exploded-view",
+ ]}
-/>
++>
+
-## Physics
++## Camera
++
++</ComponentGroup>
+
-<ComponentCardGrid
++<ComponentGroup
+ items={[
- {
- name: "Gravity Pile",
- description: "Seeded shapes rain down, bounce off the floor and each other, and settle into a heap",
- status: "stable",
- href: "/docs/camera/gravity-pile",
- },
- {
- name: "Cloth Reveal",
- description: "A simulated satin sheet is yanked off your content from one corner, folding and fluttering out of frame",
- status: "stable",
- href: "/docs/camera/cloth-reveal",
- },
- {
- name: "Impact Shake",
- description: "Heavy content slams down with a squash, a damped camera jolt, a two-frame RGB split and a dust kick",
- status: "stable",
- href: "/docs/camera/impact-shake",
- },
++ "gravity-pile",
++ "cloth-reveal",
++ "impact-shake",
+ ]}
-/>
++>
++
++## Physics
++
++</ComponentGroup>
++
++</CategoryIndex>
diff --cc content/docs/graphic-looks/index.mdx
index 00000000,a2fb3fe2..f2a66b99
mode 000000,100644..100644
--- a/content/docs/graphic-looks/index.mdx
+++ b/content/docs/graphic-looks/index.mdx
@@@ -1,0 -1,65 +1,10 @@@
+ ---
+ title: Graphic Looks
+ description: Full-frame scenes that borrow a print, drawing or screen technique, from risograph plates and blueprints to heat cameras and toy bricks
+ ---
+
++import { CategoryIndex } from "@/components/docs/index/category/category-index";
++
+ Each look is a complete, full-frame scene with its own ground. It plays a short entrance, then holds the finished image, or keeps it alive with a boil, a beat or a scrolling floor. Most take your own subject as children and fall back to a built-in demo subject without them.
+
-<ComponentCardGrid
- items={[
- {
- name: "Riso Print",
- description: "Two ink plates print the subject; the accent plate slides in off-register, wobbles and settles a hair out of alignment over grainy paper",
- status: "stable",
- href: "/docs/graphic-looks/riso-print",
- },
- {
- name: "Line Boil",
- description: "A hand-drawn outline draws itself, boils on threes like a cel animation, and fills with color while it keeps boiling",
- status: "stable",
- href: "/docs/graphic-looks/line-boil",
- },
- {
- name: "Blueprint",
- description: "A product wipes into a technical drawing with a grid, white linework, dimension lines and a red callout",
- status: "stable",
- href: "/docs/graphic-looks/blueprint",
- },
- {
- name: "Duotone Beat",
- description: "A halftone portrait in two inks that swaps its ink pair on every beat and punches in on the downbeat",
- status: "stable",
- href: "/docs/graphic-looks/duotone-beat",
- },
- {
- name: "Comic Panels",
- description: "The frame cracks into a three-panel comic page, then the action panel bursts into a full-frame POW",
- status: "stable",
- href: "/docs/graphic-looks/comic-panels",
- },
- {
- name: "Long Shadow",
- description: "A flat icon pops in and casts a long shadow to the frame edge, then the light swings and the shadow sweeps around",
- status: "stable",
- href: "/docs/graphic-looks/long-shadow",
- },
- {
- name: "Synthwave",
- description: "A retro neon horizon with a scrolling perspective grid, a rising striped sun and mountain ranges that slide in",
- status: "stable",
- href: "/docs/graphic-looks/synthwave",
- },
- {
- name: "Brick Mosaic",
- description: "Toy bricks drop in row by row from the bottom with a small bounce and build a pixel-art image on a baseplate",
- status: "stable",
- href: "/docs/graphic-looks/brick-mosaic",
- },
- {
- name: "X-Ray Scan",
- description: "A glowing bar sweeps across a device and reveals its white-line internals, with one part marked in red",
- status: "stable",
- href: "/docs/graphic-looks/x-ray-scan",
- },
- ]}
-/>
++<CategoryIndex section="/docs/graphic-looks" />
diff --cc content/docs/logo-stings/index.mdx
index 00000000,820ab8e9..d68464e2
mode 000000,100644..100644
--- a/content/docs/logo-stings/index.mdx
+++ b/content/docs/logo-stings/index.mdx
@@@ -1,0 -1,59 +1,10 @@@
+ ---
+ title: Logo Stings
+ description: Short brand reveals that land your logo or wordmark at the open or close of a video
+ ---
+
++import { CategoryIndex } from "@/components/docs/index/category/category-index";
++
+ A logo sting is the one or two second beat where the brand lands. Each one fills the frame, plays its own lead-in, and leaves your lockup centered and holding, so it works as the first or last `Sequence` of a video. Most take the logo as children; a few draw a mark themselves and only need the wordmark.
+
-<ComponentCardGrid
- items={[
- {
- name: "Orbit Lock",
- description: "Moons ride tilted, shrinking orbits into a core that bursts into a ring flash, and the logo springs into place",
- status: "stable",
- href: "/docs/logo-stings/orbit-lock",
- },
- {
- name: "Puzzle Snap",
- description: "Geometric pieces spin in from scattered positions and snap into a mark with sparks, then the wordmark slides out beside it",
- status: "stable",
- href: "/docs/logo-stings/puzzle-snap",
- },
- {
- name: "Spotlight",
- description: "A soft stage spotlight searches the dark, overshoots, lands on the logo, and the house lights come up",
- status: "stable",
- href: "/docs/logo-stings/spotlight",
- },
- {
- name: "Neon Sign",
- description: "A glass neon tube stutters alive segment by segment, buzzes off once, then holds lit with a glow on the wall",
- status: "stable",
- href: "/docs/logo-stings/neon-sign",
- },
- {
- name: "Inflate",
- description: "A flat sliver puffs up like a balloon toy, squashes and settles into a glossy mark, then the wordmark slides out",
- status: "stable",
- href: "/docs/logo-stings/inflate",
- },
- {
- name: "Liquid Fill",
- description: "A drop falls into an outlined mark and liquid rises with a sloshing surface and bubbles until the mark is solid",
- status: "stable",
- href: "/docs/logo-stings/liquid-fill",
- },
- {
- name: "Accordion Unfold",
- description: "A tight paper zigzag unfolds sideways into a flat card with the logo printed across it",
- status: "stable",
- href: "/docs/logo-stings/accordion-unfold",
- },
- {
- name: "Anamorphic Flare",
- description: "A point of light stretches into a cinematic horizontal streak that sweeps the frame and reveals the logo behind it",
- status: "stable",
- href: "/docs/logo-stings/anamorphic-flare",
- },
- ]}
-/>
++<CategoryIndex section="/docs/logo-stings" />
diff --cc content/docs/motion-graphics/index.mdx
index 910680fb,308e0d6e..c7b483c3
--- a/content/docs/motion-graphics/index.mdx
+++ b/content/docs/motion-graphics/index.mdx
@@@ -3,8 -3,96 +3,46 @@@ title: Motion Graphic
description: Flat geometric motion-graphics pieces for openers, section breaks, and pattern beds
---
+import { CategoryIndex } from "@/components/docs/index/category/category-index";
++import { ComponentGroup } from "@/components/docs/index/category/component-group";
+
Brand-agnostic geometry built the way motion designers build shape layers — drop one over any scene, recolor it, and let it play out.
- <CategoryIndex section="/docs/motion-graphics" />
-<ComponentCardGrid
++<CategoryIndex section="/docs/motion-graphics">
++
++<ComponentGroup
+ items={[
- {
- name: "Bauhaus Build",
- description: "Flat Bauhaus shapes tumble corner over corner into a frieze, then rebuild around an open title band",
- status: "stable",
- href: "/docs/motion-graphics/bauhaus-build",
- },
- {
- name: "Mondrian Split",
- description: "A De Stijl grid builds itself, reflows like rubber, and one cell takes over the frame",
- status: "stable",
- href: "/docs/motion-graphics/mondrian-split",
- },
- {
- name: "Truchet Flip",
- description: "A pattern bed — quarter-circle tiles snap a quarter turn as a wave passes and the lines reconnect into rings",
- status: "stable",
- href: "/docs/motion-graphics/truchet-flip",
- },
- {
- name: "Trim Burst",
- description: "A punctuation accent — short strokes shoot out from a point, and each start chases its end until the stroke zips shut in flight",
- status: "stable",
- href: "/docs/motion-graphics/trim-burst",
- },
- {
- name: "Speed Lines",
- description: "Streaks trail a flying element at its real speed, it lands with a squash and a small bounce, or radial lines snap onto an impact point",
- status: "stable",
- href: "/docs/motion-graphics/speed-lines",
- },
- {
- name: "Squiggle",
- description: "A line accent — a wave draws itself along a course, swims forward as it goes, calms, and erases toward the end",
- status: "stable",
- href: "/docs/motion-graphics/squiggle",
- },
++ "bauhaus-build",
++ "mondrian-split",
++ "truchet-flip",
++ "trim-burst",
++ "speed-lines",
++ "squiggle",
+ ]}
-/>
++>
+
-## Generative Loops
++## Shapes & accents
+
-Rule-driven systems that build or run on their own: pendulums, particles, cellular automata, times tables and growth spirals, for backgrounds and openers that keep moving.
++Shape-layer builds, pattern beds and punctuation accents for openers and section breaks.
++
++</ComponentGroup>
+
-<ComponentCardGrid
++<ComponentGroup
+ items={[
- {
- name: "Pendulum Wave",
- description: "A row of pendulums with tuned periods drifts from a line into waves and braids, then realigns as a seamless loop",
- status: "stable",
- href: "/docs/motion-graphics/pendulum-wave",
- },
- {
- name: "Flow Field",
- description: "Hundreds of particles ride a seeded vector field and leave fine fading trails, as a seamless loop",
- status: "stable",
- href: "/docs/motion-graphics/flow-field",
- },
- {
- name: "Isometric Build",
- description: "An isometric grid springs up row by row into a stepped block sculpture with one accent tower",
- status: "stable",
- href: "/docs/motion-graphics/isometric-build",
- },
- {
- name: "Life Grid",
- description: "Conway's Game of Life on a seeded grid, newborn cells flashing in the accent",
- status: "stable",
- href: "/docs/motion-graphics/life-grid",
- },
- {
- name: "String Art",
- description: "Threads string a ring of pins as a times table, then morph from a cardioid through a nephroid and beyond",
- status: "stable",
- href: "/docs/motion-graphics/string-art",
- },
- {
- name: "Topo Lines",
- description: "Contour lines around seeded peaks breathe and drift, one line picked out in the accent, as a seamless loop",
- status: "stable",
- href: "/docs/motion-graphics/topo-lines",
- },
- {
- name: "Phyllotaxis",
- description: "Seeds spiral out at the golden angle into a sunflower head, then a Fibonacci arm pulses outward",
- status: "stable",
- href: "/docs/motion-graphics/phyllotaxis",
- },
++ "pendulum-wave",
++ "flow-field",
++ "isometric-build",
++ "life-grid",
++ "string-art",
++ "topo-lines",
++ "phyllotaxis",
+ ]}
-/>
++>
++
++## Generative Loops
++
++Rule-driven systems that build or run on their own: pendulums, particles, cellular automata, times tables and growth spirals, for backgrounds and openers that keep moving.
++
++</ComponentGroup>
++
++</CategoryIndex>
diff --cc content/docs/transitions/index.mdx
index 356a5503,5bf14f87..02a4e349
--- a/content/docs/transitions/index.mdx
+++ b/content/docs/transitions/index.mdx
@@@ -58,30 -111,112 +58,47 @@@ Textured, organic transitions driven b
Kinetic, interface-flavored transitions — typed wipes, scattering icons, and messaging motion.
-<ComponentCardGrid
+</ComponentGroup>
+
+<ComponentGroup
items={[
- {
- name: "AsciiDissolve",
- description: "Dissolve one scene into the next through a drifting field of ASCII glyphs",
- status: "stable",
- href: "/docs/transitions/ascii-dissolve",
- },
- {
- name: "CaretWipe",
- description: "Sweep a typing caret across the frame, wiping the outgoing scene into the next",
- status: "stable",
- href: "/docs/transitions/caret-wipe",
- },
- {
- name: "IconScatter",
- description: "Scatter a field of icons over the cut, hiding the scene swap at the field's peak",
- status: "stable",
- href: "/docs/transitions/icon-scatter",
- },
+ "glitch-cut",
+ "ember-burn",
+ "particle-dissolve",
+ "grid-wave",
+ "displacement",
]}
-/>
+>
-## Graphic Cuts
+## Canvas
-Bold, showy cuts built from plain CSS and SVG: shapes, slats, torn paper, streaks and light. No dependencies beyond Remotion.
+Pixel-level transitions. These read the actual pixels of both scenes through the experimental html-in-canvas browser API and post-process them per frame, which is what makes tearing, burning, and shattering possible at all. Chrome 149+ behind `chrome://flags/#canvas-draw-element` shows the real effect; every other browser degrades to a CSS approximation of the same edit, so previews and renders never break.
+
+</ComponentGroup>
-<ComponentCardGrid
++<ComponentGroup
+ items={[
- {
- name: "IrisWipe",
- description: "Close a cartoon iris on the subject, hold it as a dot, then open it on the next scene",
- status: "stable",
- href: "/docs/transitions/iris-wipe",
- },
- {
- name: "VenetianBlinds",
- description: "Turn the outgoing scene edge-on in staggered horizontal slats to reveal the next one",
- status: "stable",
- href: "/docs/transitions/venetian-blinds",
- },
- {
- name: "PaperTear",
- description: "Rip the frame down the middle and fling both torn halves apart on impact",
- status: "stable",
- href: "/docs/transitions/paper-tear",
- },
- {
- name: "PixelSort",
- description: "Melt the scene into glowing vertical streaks and drop the next one in column by column",
- status: "stable",
- href: "/docs/transitions/pixel-sort",
- },
- {
- name: "LightLeak",
- description: "Drift a warm analog light leak across the frame and hard-cut under its blow-out",
- status: "stable",
- href: "/docs/transitions/light-leak",
- },
- {
- name: "Hyperspace",
- description: "Stretch a starfield into streaks, tunnel forward and land on the next scene through a flash",
- status: "stable",
- href: "/docs/transitions/hyperspace",
- },
++ "iris-wipe",
++ "venetian-blinds",
++ "paper-tear",
++ "pixel-sort",
++ "light-leak",
++ "hyperspace",
+ ]}
-/>
++>
+
-## Canvas
++## Graphic Cuts
+
-Pixel-level transitions. These read the actual pixels of both scenes through the experimental html-in-canvas browser API and post-process them per frame, which is what makes tearing, burning, and shattering possible at all. Chrome 149+ behind `chrome://flags/#canvas-draw-element` shows the real effect; every other browser degrades to a CSS approximation of the same edit, so previews and renders never break.
++Bold, showy cuts built from plain CSS and SVG: shapes, slats, torn paper, streaks and light. No dependencies beyond Remotion.
++
++</ComponentGroup>
+
-<ComponentCardGrid
+<ComponentGroup
items={[
- {
- name: "GlitchCut",
- description: "Tear a hard cut into displaced slices with channel split and corrupted blocks",
- status: "stable",
- href: "/docs/transitions/glitch-cut",
- },
- {
- name: "EmberBurn",
- description: "Set the outgoing frame on fire so it boils, chars, and blows away as sparks that carry its own colour",
- status: "stable",
- href: "/docs/transitions/ember-burn",
- },
- {
- name: "ParticleDissolve",
- description: "Grind the frame into drifting grey dust and let the next scene coalesce back out of it",
- status: "stable",
- href: "/docs/transitions/particle-dissolve",
- },
- {
- name: "GridWave",
- description: "Send a wave across the frame that raises the picture into solid blocks and sets them down carrying the next scene",
- status: "stable",
- href: "/docs/transitions/grid-wave",
- },
- {
- name: "Displacement",
- description: "Shear the frame into a grid of offset colour-fringed tiles and settle them back on the next scene",
- status: "stable",
- href: "/docs/transitions/displacement",
- },
+ "slide-swap",
+ "spring-settle",
]}
-/>
+>
## Scene Sequencers
diff --cc lib/ui-preview-internals.tsx
index 16e94704,3aa75a1a..e4d271a6
--- a/lib/ui-preview-internals.tsx
+++ b/lib/ui-preview-internals.tsx
@@@ -199,11 -219,9 +202,12 @@@ export function PreviewStage(
compositionWidth={compositionWidth}
compositionHeight={compositionHeight}
style={{ width: "100%", height: "100%" }}
- controls
+ controls={controls}
+ clickToPlay
loop
+ // Browsers block autoplay with sound; the controls' volume
+ // button turns it back on.
+ initiallyMuted
acknowledgeRemotionLicense
/>
</div>
diff --cc mdx-components.tsx
index 86453bb9,9dd897f4..07689d75
--- a/mdx-components.tsx
+++ b/mdx-components.tsx
@@@ -16,7 -16,9 +16,8 @@@ import { IconsGallery } from "@/compone
import { InstallAll } from "@/components/docs/install-all";
import { InstallBlock } from "@/components/docs/install-block";
import { PropsTable } from "@/components/docs/props-table";
+ import { ShaderPresets } from "@/components/docs/shader-presets";
import { UiComponentPreview } from "@/components/docs/ui-component-preview";
-import { Frame, FramePanel } from "@/components/ui/frame";
import { cn } from "@/lib/utils";
/**
diff --cc registry/__manifest__.ts
index 3c4562f1,d8c38698..43b4ead0
--- a/registry/__manifest__.ts
+++ b/registry/__manifest__.ts
@@@ -2087,12 -2063,26 +2290,31 @@@ export const previewManifest: Record<st
intensity: 1,
speed: 1,
},
+ card: {
+ props: {
+ tint: "#0E1012",
+ },
+ },
},
+ hyperspace: {
+ durationInFrames: 124,
+ fps: 30,
+ compositionWidth: 1280,
+ compositionHeight: 720,
+ previewBackdrop: {
+ type: "color",
+ value: "#0a0a0a",
+ },
+ defaults: {
+ stars: 260,
+ streakColor: "#FFFFFF",
+ accentColor: "#E5322D",
+ accentRatio: 0.14,
+ flash: true,
+ flashColor: "#FFFFFF",
+ speed: 1,
+ },
+ },
"icon-activity": {
durationInFrames: 90,
fps: 30,
@@@ -4147,12 -4351,27 +4617,32 @@@
lineWidth: 3,
speed: 1,
},
+ card: {
+ props: {
+ lineColor: "#0E1012",
+ },
+ },
},
+ "pendulum-wave": {
+ durationInFrames: 450,
+ fps: 30,
+ compositionWidth: 1280,
+ compositionHeight: 720,
+ previewBackdrop: {
+ type: "color",
+ value: "#111111",
+ },
+ defaults: {
+ count: 15,
+ cycles: 10,
+ loopFrames: 450,
+ showGuides: true,
+ background: "#111111",
+ color: "#FFFFFF",
+ accent: "#E5322D",
+ speed: 1,
+ },
+ },
"per-character-rise": {
durationInFrames: 60,
fps: 30,
@@@ -4276,12 -4482,45 +4766,50 @@@
lineGap: 50,
speed: 1,
},
+ card: {
+ props: {
+ fill: "#0E1012",
+ },
+ },
},
+ phyllotaxis: {
+ durationInFrames: 165,
+ fps: 30,
+ compositionWidth: 1280,
+ compositionHeight: 720,
+ previewBackdrop: {
+ type: "color",
+ value: "#111111",
+ },
+ defaults: {
+ count: 420,
+ size: 1,
+ arm: 21,
+ growFrames: 60,
+ pulseFrames: 45,
+ rotation: 4,
+ background: "#111111",
+ color: "#FFFFFF",
+ accent: "#E5322D",
+ speed: 1,
+ },
+ },
+ "pixel-sort": {
+ durationInFrames: 110,
+ fps: 30,
+ compositionWidth: 1280,
+ compositionHeight: 720,
+ previewBackdrop: {
+ type: "color",
+ value: "#0a0a0a",
+ },
+ defaults: {
+ columns: 40,
+ seed: 5,
+ streakColor: "#FFFFFF",
+ speed: 1,
+ },
+ },
"pixelate-region": {
durationInFrames: 90,
fps: 30,
@@@ -5843,13 -6606,27 +6960,33 @@@
loop: false,
speed: 1,
},
+ card: {
+ props: {
+ color: "#0E1012",
+ secondaryColor: "#0E1012",
+ },
+ },
},
+ turntable: {
+ durationInFrames: 90,
+ fps: 30,
+ compositionWidth: 1280,
+ compositionHeight: 720,
+ previewBackdrop: {
+ type: "color",
+ value: "#111111",
+ },
+ defaults: {
+ turns: 1,
+ thickness: 22,
+ tilt: 8,
+ frontColor: "#E5322D",
+ edgeColor: "#A3201C",
+ backColor: "#F2F2F2",
+ backgroundColor: "#111111",
+ speed: 1,
+ },
+ },
"tv-power-off": {
durationInFrames: 62,
fps: 30,
@@@ -6056,12 -6808,24 +7193,29 @@@
direction: "up",
speed: 1,
},
+ card: {
+ props: {
+ color: "#0E1012",
+ },
+ },
},
+ "venetian-blinds": {
+ durationInFrames: 114,
+ fps: 30,
+ compositionWidth: 1280,
+ compositionHeight: 720,
+ previewBackdrop: {
+ type: "color",
+ value: "#0a0a0a",
+ },
+ defaults: {
+ slats: 12,
+ stagger: 0.55,
+ direction: "top-down",
+ shadeColor: "#000000",
+ speed: 1,
+ },
+ },
"vhs-filter": {
durationInFrames: 90,
fps: 30,
diff --cc source.tsx
index 4b66a42f,09161a13..2ac5acdf
--- a/source.tsx
+++ b/source.tsx
@@@ -9,7 -10,7 +10,8 @@@ import
Layers01Icon,
Layout01Icon,
MagicWand01Icon,
+ PaintBoardIcon,
+ PlaySquareIcon,
Rocket01Icon,
Share01Icon,
SparklesIcon,
@@@ -33,7 -36,7 +37,8 @@@ const DOCS_ICONS: Record<string, IconSv
Layers01Icon,
Layout01Icon,
MagicWand01Icon,
+ PaintBoardIcon,
+ PlaySquareIcon,
Rocket01Icon,
Share01Icon,
SparklesIcon,