Skip to content

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

feat: create changelog page

kapishdima977c667b4d0b
diff --git a/CLAUDE.md b/CLAUDE.md
index 57253893..91b3cff3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -12,9 +12,13 @@ Solo builders и маленькие команды (1-2 чел), фронтен
## Архитектура
-- **Монорепо:** pnpm workspaces + turborepo
-- `apps/web/` — Next.js сайт (landing page + Fumadocs для документации)
-- `packages/registry/` — shadcn registry manifest + исходники компонентов
+Плоское Next.js приложение в корне репозитория, пакетный менеджер — bun. Никакого монорепо, workspaces и turborepo.
+
+- `app/` — Next.js App Router. `app/(home)/` — landing и standalone-страницы (`sponsors`, `changelog`), `app/docs/` — Fumadocs, `app/r/` — раздача registry-артефактов, `app/api/` — рендер и прочие endpoints
+- `content/docs/` — MDX документации (fumadocs collection `docs`), `content/changelog/` — записи ченджлога (flat collection `changelog`)
+- `registry/` — исходники компонентов: `remocn/` (анимации, переходы, backgrounds), `remocn-ui/` (UI-примитивы), `remocn-icons/` (иконки). У каждого неймспейса свой `registry.json`; `registry/__index__.tsx` — отдельный реестр превью для сайта
+- `registry-artifacts/` — собранный shadcn-registry (`bun run registry:build`), коммитится в репозиторий
+- `components/`, `lib/`, `config/`, `hooks/` — код сайта
## Два уровня компонентов
@@ -31,6 +35,19 @@ Solo builders и маленькие команды (1-2 чел), фронтен
- Превью на сайте через `@remotion/player` — интерактивный плеер в браузере
- Лицензия: MIT
+## Changelog
+
+Любая ветка, которая добавляет или заметно меняет компоненты registry, обязана содержать запись ченджлога — в том же PR, что и сама фича.
+
+- Одна запись = один файл `content/changelog/<YYYY-MM-DD>-<slug>.mdx`. Дата в имени файла — дата мержа
+- Frontmatter: `title` и `date` (без кавычек, без `: ` внутри значений). `date` парсится в JS `Date`
+- Запись = веха, а не PR и не календарный день
+- Заголовки: `h1` и `h2` принадлежат странице (`h2` рендерится из `title`). Внутри тела — только `h3` для групп `New components` / `Improvements` / `Fixes`
+- Живое превью: `<ChangelogPreview name="component-name" />`, где `name` — ключ из `registry/__index__.tsx`. Опционально
+- Ссылки на доки компонентов приветствуются: `[Zoom Blur](/docs/transitions/zoom-blur)`
+- Весь текст — на английском
+- Опубликованные записи не переименовываются: имя файла — это якорь (`/changelog#2026-07-08-transitions-revamp`), которым делятся
+
## Бизнес-модель
Open core. Free примитивы и базовые compositions (MIT). В будущем — premium блоки и video builder.
@@ -39,5 +56,8 @@ Open core. Free примитивы и базовые compositions (MIT). В бу
```bash
bun install # установка зависимостей
-bun dev # запуск dev серверов
-bun run build # сборка всех пакетов
+bun dev # dev-сервер Next.js
+bun run build # production-сборка сайта
+bun run typecheck # tsc --noEmit
+bun run lint # biome check
+bun run registry:build # пересборка registry-artifacts из registry/
diff --git a/app/(home)/changelog/page.tsx b/app/(home)/changelog/page.tsx
new file mode 100644
index 00000000..76411fcc
--- /dev/null
+++ b/app/(home)/changelog/page.tsx
@@ -0,0 +1,89 @@
+import type { Metadata } from "next";
+import type { ComponentProps } from "react";
+import { changelog } from "@/.source/server";
+import { ChangelogPreview } from "@/components/changelog/changelog-preview";
+import { getMDXComponents } from "@/mdx-components";
+
+export const metadata: Metadata = {
+ title: "Changelog",
+ description:
+ "Every release of remocn — new components, transitions, shaders, icons, and improvements, newest first.",
+ openGraph: {
+ title: "Changelog · remocn",
+ description:
+ "Every release of remocn — new components, transitions, shaders, icons, and improvements, newest first.",
+ },
+};
+
+const dateFormatter = new Intl.DateTimeFormat("en-US", {
+ timeZone: "UTC",
+ year: "numeric",
+ month: "long",
+ day: "numeric",
+});
+
+const entryComponents = {
+ ...getMDXComponents(),
+ ChangelogPreview,
+ h3: (props: ComponentProps<"h3">) => <h3 {...props} id={undefined} />,
+ h4: (props: ComponentProps<"h4">) => <h4 {...props} id={undefined} />,
+};
+
+export default function ChangelogPage() {
+ const entries = [...changelog].sort(
+ (a, b) => b.date.getTime() - a.date.getTime(),
+ );
+
+ return (
+ <>
+ <section className="pt-24 pb-10 sm:pt-28">
+ <div className="section">
+ <h1 className="text-4xl font-semibold leading-[1.05] tracking-tight text-foreground sm:text-5xl">
+ Changelog
+ </h1>
+ <p className="mt-4 max-w-2xl text-balance text-base leading-relaxed text-muted-foreground sm:text-lg">
+ New components, transitions, shaders, and icons as they ship.
+ </p>
+ </div>
+ </section>
+
+ <section className="pb-24">
+ <div className="section flex flex-col gap-16">
+ {entries.map((entry) => {
+ const slug = entry.info.path.replace(/\.mdx$/, "");
+ const iso = entry.date.toISOString().slice(0, 10);
+ const MDX = entry.body;
+
+ return (
+ <article
+ key={slug}
+ id={slug}
+ className="scroll-mt-24 border-t border-border pt-8 md:grid md:grid-cols-[10rem_1fr] md:gap-8"
+ >
+ <div className="md:sticky md:top-24 md:self-start">
+ <time
+ dateTime={iso}
+ className="font-mono text-xs font-medium text-muted-foreground"
+ >
+ {dateFormatter.format(entry.date)}
+ </time>
+ </div>
+
+ <div className="mt-4 min-w-0 md:mt-0">
+ <h2 className="text-2xl font-semibold tracking-tight text-foreground sm:text-3xl">
+ <a href={`#${slug}`} className="hover:underline">
+ {entry.title}
+ </a>
+ </h2>
+ <div className="typeset typeset-docs mt-6">
+ <MDX components={entryComponents} />
+ </div>
+ </div>
+ </article>
+ );
+ })}
+ </div>
+ </section>
+ </>
+ );
+}
diff --git a/app/sitemap.ts b/app/sitemap.ts
index 05949b23..20a8f0ac 100644
--- a/app/sitemap.ts
+++ b/app/sitemap.ts
@@ -19,6 +19,12 @@ export default function sitemap(): MetadataRoute.Sitemap {
changeFrequency: "monthly",
priority: 0.5,
},
+ {
+ url: `${SITE_URL}/changelog`,
+ lastModified: now,
+ changeFrequency: "weekly",
+ priority: 0.6,
+ },
];
const docRoutes: MetadataRoute.Sitemap = source.getPages().map((page) => ({
diff --git a/bun.lock b/bun.lock
index 4b502480..7bfc48a7 100644
--- a/bun.lock
+++ b/bun.lock
@@ -42,6 +42,7 @@
"tailwind-merge": "^3.5.0",
"tw-animate-css": "^1.4.0",
"vaul": "^1.1.2",
+ "zod": "^4.3.6",
},
"devDependencies": {
"@biomejs/biome": "2.2.0",
@@ -1621,7 +1622,7 @@
"yoctocolors": ["[email protected]", "", {}, "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug=="],
- "zod": ["[email protected]", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
+ "zod": ["[email protected]", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
"zod-to-json-schema": ["[email protected]", "", { "peerDependencies": { "zod": "^3.25.28 || ^4" } }, "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA=="],
@@ -1633,6 +1634,8 @@
"@mdx-js/mdx/source-map": ["[email protected]", "", {}, "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ=="],
+ "@modelcontextprotocol/sdk/zod": ["[email protected]", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
+
"@radix-ui/react-collection/@radix-ui/react-slot": ["@radix-ui/[email protected]", "", { "dependencies": { "@radix-ui/react-compose-refs": "1.1.2" }, "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-aeNmHnBxbi2St0au6VBVC7JXFlhLlOnvIIlePNniyUNAClzmtAUEY8/pBiK3iHjufOlwA+c20/8jngo7xcrg8A=="],
"@radix-ui/react-dialog/@radix-ui/react-slot": ["@radix-ui/[email protected]", "", { "dependencies": { "@radix-ui/react-compose-refs": "1.1.2" }, "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-aeNmHnBxbi2St0au6VBVC7JXFlhLlOnvIIlePNniyUNAClzmtAUEY8/pBiK3iHjufOlwA+c20/8jngo7xcrg8A=="],
@@ -1647,10 +1650,6 @@
"@remotion/studio/semver": ["[email protected]", "", { "dependencies": { "lru-cache": "^6.0.0" }, "bin": { "semver": "bin/semver.js" } }, "sha512-QBlUtyVk/5EeHbi7X0fw6liDZc7BBmEaSYn01fMU1OUYbf6GPsbTtd8WmnqbI20SeycoHSeiybkE/q1Q+qlThQ=="],
- "@remotion/studio/zod": ["[email protected]", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
-
- "@remotion/zod-types/zod": ["[email protected]", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
-
"@tailwindcss/oxide-wasm32-wasi/@emnapi/core": ["@emnapi/[email protected]", "", { "dependencies": { "@emnapi/wasi-threads": "1.2.1", "tslib": "^2.4.0" }, "bundled": true }, "sha512-UC+ZhH3XtczQYfOlu3lNEkdW/p4dsJ1r/bP7H8+rhao3TTTMO1ATq/4DdIi23XuGoFY+Cz0JmCbdVl0hz9jZcA=="],
"@tailwindcss/oxide-wasm32-wasi/@emnapi/runtime": ["@emnapi/[email protected]", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-3U4+MIWHImeyu1wnmVygh5WlgfYDtyf0k8AbLhMFxOipihf6nrWC4syIm/SwEeec0mNSafiiNnMJwbza/Is6Lw=="],
@@ -1675,12 +1674,8 @@
"express/mime-types": ["[email protected]", "", { "dependencies": { "mime-db": "^1.54.0" } }, "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A=="],
- "fumadocs-core/zod": ["[email protected]", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
-
"fumadocs-mdx/esbuild": ["[email protected]", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.27.7", "@esbuild/android-arm": "0.27.7", "@esbuild/android-arm64": "0.27.7", "@esbuild/android-x64": "0.27.7", "@esbuild/darwin-arm64": "0.27.7", "@esbuild/darwin-x64": "0.27.7", "@esbuild/freebsd-arm64": "0.27.7", "@esbuild/freebsd-x64": "0.27.7", "@esbuild/linux-arm": "0.27.7", "@esbuild/linux-arm64": "0.27.7", "@esbuild/linux-ia32": "0.27.7", "@esbuild/linux-loong64": "0.27.7", "@esbuild/linux-mips64el": "0.27.7", "@esbuild/linux-ppc64": "0.27.7", "@esbuild/linux-riscv64": "0.27.7", "@esbuild/linux-s390x": "0.27.7", "@esbuild/linux-x64": "0.27.7", "@esbuild/netbsd-arm64": "0.27.7", "@esbuild/netbsd-x64": "0.27.7", "@esbuild/openbsd-arm64": "0.27.7", "@esbuild/openbsd-x64": "0.27.7", "@esbuild/openharmony-arm64": "0.27.7", "@esbuild/sunos-x64": "0.27.7", "@esbuild/win32-arm64": "0.27.7", "@esbuild/win32-ia32": "0.27.7", "@esbuild/win32-x64": "0.27.7" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w=="],
- "fumadocs-mdx/zod": ["[email protected]", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
-
"fumadocs-ui/motion": ["[email protected]", "", { "dependencies": { "framer-motion": "^12.38.0", "tslib": "^2.4.0" }, "peerDependencies": { "@emotion/is-prop-valid": "*", "react": "^18.0.0 || ^19.0.0", "react-dom": "^18.0.0 || ^19.0.0" }, "optionalPeers": ["@emotion/is-prop-valid", "react", "react-dom"] }, "sha512-uYfXzeHlgThchzwz5Te47dlv5JOUC7OB4rjJ/7XTUgtBZD8CchMN8qEJ4ZVsUmTyYA44zjV0fBwsiktRuFnn+w=="],
"log-symbols/is-unicode-supported": ["[email protected]", "", {}, "sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ=="],
@@ -1705,6 +1700,8 @@
"send/mime-types": ["[email protected]", "", { "dependencies": { "mime-db": "^1.54.0" } }, "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A=="],
+ "shadcn/zod": ["[email protected]", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
+
"sharp/semver": ["[email protected]", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA=="],
"source-map-support/source-map": ["[email protected]", "", {}, "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g=="],
diff --git a/components/changelog/changelog-preview.tsx b/components/changelog/changelog-preview.tsx
new file mode 100644
index 00000000..da0f98d6
--- /dev/null
+++ b/components/changelog/changelog-preview.tsx
@@ -0,0 +1,59 @@
+"use client";
+
+import { Suspense, useMemo } from "react";
+import { type ComponentConfig, getDefaults } from "@/lib/customizer-config";
+import { PreviewStage } from "@/lib/ui-preview-internals";
+import registry from "@/registry/__index__";
+
+export function ChangelogPreview({ name }: { name: string }) {
+ const entry = registry[name];
+
+ if (!entry) {
+ 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>
+ );
+ }
+
+ return (
+ <Suspense
+ fallback={
+ <div className="not-prose mb-6 aspect-[1.9/1] w-full animate-pulse rounded-2xl bg-muted" />
+ }
+ >
+ <Preview name={name} config={entry.config} load={entry.load} />
+ </Suspense>
+ );
+}
+
+function Preview({
+ name,
+ config,
+ load,
+}: {
+ name: string;
+ config: ComponentConfig;
+ // biome-ignore lint/suspicious/noExplicitAny: dynamically-loaded Remotion composition, props shape varies per component
+ load: () => Promise<{ default: React.ComponentType<any> }>;
+}) {
+ const inputProps = useMemo(
+ () => getDefaults(config.controls),
+ [config.controls],
+ );
+
+ return (
+ <div className="not-prose mb-6 w-full">
+ <PreviewStage
+ name={name}
+ load={load}
+ inputProps={inputProps}
+ durationInFrames={config.durationInFrames}
+ fps={config.fps}
+ compositionWidth={config.compositionWidth}
+ compositionHeight={config.compositionHeight}
+ previewBackdrop={config.previewBackdrop}
+ />
+ </div>
+ );
+}
diff --git a/config/site.ts b/config/site.ts
index 0eee0e37..e936aca0 100644
--- a/config/site.ts
+++ b/config/site.ts
@@ -62,6 +62,7 @@ export const NEW_BADGE_PATHS = new Set<string>([
export const FOOTER_NAV: NavLink[] = [
{ href: "/docs/getting-started/introduction", label: "Docs" },
+ { href: "/changelog", label: "Changelog" },
{ href: GITHUB_URL, label: "GitHub" },
{ href: "/sponsors", label: "Sponsors" },
];
diff --git a/content/changelog/2026-04-08-launch.mdx b/content/changelog/2026-04-08-launch.mdx
new file mode 100644
index 00000000..35717a56
--- /dev/null
+++ b/content/changelog/2026-04-08-launch.mdx
@@ -0,0 +1,18 @@
+---
+title: remocn launches
+date: 2026-04-08
+---
+
+A shadcn registry for Remotion. You already know the workflow — run `npx shadcn@latest add`, the files land in your project, and they are yours to edit. remocn applies it to video.
+
+Everything is written from scratch against the Remotion API — `useCurrentFrame`, `interpolate`, `spring` — so components seek correctly in the studio and render deterministically. Remotion itself is a prerequisite, not something remocn installs for you.
+
+<ChangelogPreview name="typewriter" />
+
+### New components
+
+The first catalog — text effects like [Typewriter](/docs/typography/typewriter), [Matrix Decode](/docs/typography/matrix-decode), [RGB Glitch Text](/docs/typography/rgb-glitch-text), [Shimmer Sweep](/docs/typography/shimmer-sweep), [Tracking In](/docs/typography/tracking-in), [Staggered Fade Up](/docs/typography/staggered-fade-up), [Slot Machine Roll](/docs/typography/slot-machine-roll), [Inline Highlight](/docs/typography/inline-highlight), [Marker Highlight](/docs/typography/marker-highlight), [Infinite Marquee](/docs/typography/infinite-marquee), and [Perspective Marquee](/docs/typography/perspective-marquee).
+
+Interface blocks — [Terminal Simulator](/docs/ui-blocks/terminal-simulator), [Glass Code Block](/docs/ui-blocks/glass-code-block), [Animated Bar Chart](/docs/ui-blocks/animated-bar-chart), [Animated Line Chart](/docs/ui-blocks/animated-line-chart), [Data Flow Pipes](/docs/ui-blocks/data-flow-pipes), and [Progress Steps](/docs/ui-blocks/progress-steps).
+
+And the first compositions — [Ecosystem Constellation](/docs/compositions/ecosystem-constellation), [Infinite Bento Pan](/docs/compositions/infinite-bento-pan), and [Live Code Compilation](/docs/compositions/live-code-compilation) — full scenes assembled from the primitives above.
diff --git a/content/changelog/2026-06-12-remocn-ui.mdx b/content/changelog/2026-06-12-remocn-ui.mdx
new file mode 100644
index 00000000..78c3648c
--- /dev/null
+++ b/content/changelog/2026-06-12-remocn-ui.mdx
@@ -0,0 +1,18 @@
+---
+title: remocn/ui arrives
+date: 2026-06-12
+---
+
+Every product demo eventually has to show the product — a dialog opening, a command menu filtering, a form being filled. Doing that with real shadcn components inside Remotion does not work, because they animate against wall-clock time and a video has no clock, only a frame number.
+
+So remocn/ui is a parallel set of primitives with the same shapes and a timeline-driven API. You describe the steps; the component renders whichever one the current frame belongs to.
+
+<ChangelogPreview name="command-menu" />
+
+### New components
+
+Around forty primitives, including [Button](/docs/ui/components/button), [Input](/docs/ui/components/input), [Dialog](/docs/ui/components/dialog), [Drawer](/docs/ui/components/drawer), [Sheet](/docs/ui/components/sheet), [Popover](/docs/ui/components/popover), [Tooltip](/docs/ui/components/tooltip), [Select](/docs/ui/components/select), [Combobox](/docs/ui/components/combobox), [Command Menu](/docs/ui/components/command-menu), [Context Menu](/docs/ui/components/context-menu), [Dropdown Menu](/docs/ui/components/dropdown-menu), [Accordion](/docs/ui/components/accordion), [Tabs](/docs/ui/components/tabs), [Stepper](/docs/ui/components/stepper), [Toast](/docs/ui/components/toast), [Slider](/docs/ui/components/slider), [Progress](/docs/ui/components/progress), [Skeleton](/docs/ui/components/skeleton), [Spinner](/docs/ui/components/spinner), and [Cursor](/docs/ui/components/cursor) — the simulated pointer that drives the rest.
+
+Assembled flows too — [Checkout Flow](/docs/ui/blocks/checkout-flow), [Signup Flow](/docs/ui/blocks/signup-flow), and [Settings Toggle Flow](/docs/ui/blocks/settings-toggle-flow).
+
+Read [concepts](/docs/ui/concepts) first — the steps API is the whole idea.
diff --git a/content/changelog/2026-06-17-ai-and-social.mdx b/content/changelog/2026-06-17-ai-and-social.mdx
new file mode 100644
index 00000000..50de6684
--- /dev/null
+++ b/content/changelog/2026-06-17-ai-and-social.mdx
@@ -0,0 +1,14 @@
+---
+title: AI chat simulators and social cards
+date: 2026-06-17
+---
+
+Two shots that show up in almost every launch video — someone prompting an AI, and a follower count going up.
+
+<ChangelogPreview name="claude-code" />
+
+### New components
+
+- AI interfaces, typing themselves out — [Claude Code](/docs/ai/claude-code), [Claude Chat](/docs/ai/claude-chat), [ChatGPT](/docs/ai/chat-gpt), [OpenCode](/docs/ai/opencode), and [v0](/docs/ai/v0).
+- [X Follow Card](/docs/social/x-follow-card) and [X Followers Overview](/docs/social/x-followers-overview) — the follow button and the count that climbs.
+- [Confetti](/docs/effects/confetti) — for the moment the number lands.
diff --git a/content/changelog/2026-06-23-typography-wave.mdx b/content/changelog/2026-06-23-typography-wave.mdx
new file mode 100644
index 00000000..63eec1c4
--- /dev/null
+++ b/content/changelog/2026-06-23-typography-wave.mdx
@@ -0,0 +1,16 @@
+---
+title: 18 new text animations
+date: 2026-06-23
+---
+
+Text is most of what a demo video says, so the typography tier got the most attention. Eighteen entrances and swaps, each built on Remotion's `interpolate` and `spring` rather than a CSS keyframe library — they seek correctly, and frame 40 looks the same on every render.
+
+<ChangelogPreview name="soft-blur-in" />
+
+### New components
+
+Entrances — [Soft Blur In](/docs/typography/soft-blur-in), [Per Character Rise](/docs/typography/per-character-rise), [Bottom Up Letters](/docs/typography/bottom-up-letters), [Top Down Letters](/docs/typography/top-down-letters), [Spring Scale In](/docs/typography/spring-scale-in), [Micro Scale Fade](/docs/typography/micro-scale-fade), [Mask Reveal Up](/docs/typography/mask-reveal-up), [Line By Line Slide](/docs/typography/line-by-line-slide), [Kinetic Center Build](/docs/typography/kinetic-center-build), and [Focus Blur Resolve](/docs/typography/focus-blur-resolve).
+
+Exits and swaps — [Blur Out Up](/docs/typography/blur-out-up), [Scale Down Fade](/docs/typography/scale-down-fade), [Fade Through](/docs/typography/fade-through), [Per Word Crossfade](/docs/typography/per-word-crossfade), [Shared Axis Y](/docs/typography/shared-axis-y), [Shared Axis Z](/docs/typography/shared-axis-z), [Short Slide Down](/docs/typography/short-slide-down), and [Short Slide Right](/docs/typography/short-slide-right).
+
+Numbers got their own treatment a few days earlier — [Number Wheel](/docs/typography/number-wheel) and [Rolling Number](/docs/typography/rolling-number) — along with [Backdrop](/docs/layout/backdrop), the wrapper that gives any component a surface to sit on.
diff --git a/content/changelog/2026-06-25-agent-skill.mdx b/content/changelog/2026-06-25-agent-skill.mdx
new file mode 100644
index 00000000..13a65680
--- /dev/null
+++ b/content/changelog/2026-06-25-agent-skill.mdx
@@ -0,0 +1,19 @@
+---
+title: The remocn agent skill
+date: 2026-06-25
+---
+
+If you build videos with an AI agent, it now knows the catalog. The remocn skill teaches Claude Code and friends which components exist, what each one is for, and how to compose them — so "make me an intro scene" stops being a guessing game.
+
+<ChangelogPreview name="glass-code-walk" />
+
+### New components
+
+- [Glass Code Walk](/docs/ui-blocks/glass-code-walk) — a camera walk across a code block, for showing a diff without narrating it.
+- [Terminal Cursor Zoom](/docs/ui-blocks/terminal-cursor-zoom) — the terminal, zoomed to wherever the cursor is working.
+- [Logo Enter](/docs/social/logo-enter) — a logo entrance for the end card.
+
+### Improvements
+
+- The [agent skill](/docs/getting-started/agent-skill) ships with install instructions and a component catalog.
+- An install-all button on the components page, for anyone who would rather have everything than choose.
diff --git a/content/changelog/2026-06-27-chat-primitives.mdx b/content/changelog/2026-06-27-chat-primitives.mdx
new file mode 100644
index 00000000..b4a4f1e0
--- /dev/null
+++ b/content/changelog/2026-06-27-chat-primitives.mdx
@@ -0,0 +1,14 @@
+---
+title: Chat and messaging primitives
+date: 2026-06-27
+---
+
+Demo videos keep needing the same shot — a conversation typing itself out. Rather than ship one rigid chat component, this adds the pieces and lets you assemble the flow.
+
+<ChangelogPreview name="message-bubble" />
+
+### New components
+
+- [Message Bubble](/docs/ui/components/message-bubble) and [Typing Indicator](/docs/ui/components/typing-indicator) — the atoms.
+- [Chat Flow](/docs/ui/blocks/chat-flow), [iMessage Chat Flow](/docs/ui/blocks/imessage-chat-flow), and [Telegram Chat Flow](/docs/ui/blocks/telegram-chat-flow) — assembled conversations, each with the platform's own look.
+- [GitHub Sponsors](/docs/social/github-sponsors) — the sponsors card, as a companion to the stars card.
diff --git a/content/changelog/2026-07-01-shader-backgrounds.mdx b/content/changelog/2026-07-01-shader-backgrounds.mdx
new file mode 100644
index 00000000..d7320302
--- /dev/null
+++ b/content/changelog/2026-07-01-shader-backgrounds.mdx
@@ -0,0 +1,14 @@
+---
+title: 18 shader backgrounds
+date: 2026-07-01
+---
+
+Gradient backdrops read as a slide deck. These read as a product. Eighteen GPU shaders wrapped as Remotion components, each driven by the frame rather than by wall-clock time — so they render deterministically and a re-render produces the same file.
+
+<ChangelogPreview name="shader-neuro-noise" />
+
+### New components
+
+[Neuro Noise](/docs/shaders/components/shader-neuro-noise), [Mesh Gradient](/docs/shaders/components/shader-mesh-gradient), [Grain Gradient](/docs/shaders/components/shader-grain-gradient), [Liquid Metal](/docs/shaders/components/shader-liquid-metal), [Metaballs](/docs/shaders/components/shader-metaballs), [God Rays](/docs/shaders/components/shader-god-rays), [Smoke Ring](/docs/shaders/components/shader-smoke-ring), [Dot Orbit](/docs/shaders/components/shader-dot-orbit), [Color Panels](/docs/shaders/components/shader-color-panels), [Dithering](/docs/shaders/components/shader-dithering), [Perlin Noise](/docs/shaders/components/shader-perlin-noise), [Simplex Noise](/docs/shaders/components/shader-simplex-noise), [Pulsing Border](/docs/shaders/components/shader-pulsing-border), [Spiral](/docs/shaders/components/shader-spiral), [Swirl](/docs/shaders/components/shader-swirl), [Voronoi](/docs/shaders/components/shader-voronoi), [Warp](/docs/shaders/components/shader-warp), and [Water](/docs/shaders/components/shader-water).
+
+Start with the [shaders introduction](/docs/shaders/getting-started/introduction) for the determinism rules before dropping one behind a scene.
diff --git a/content/changelog/2026-07-02-transitions-revamp.mdx b/content/changelog/2026-07-02-transitions-revamp.mdx
new file mode 100644
index 00000000..e16a805b
--- /dev/null
+++ b/content/changelog/2026-07-02-transitions-revamp.mdx
@@ -0,0 +1,14 @@
+---
+title: Transitions revamp
+date: 2026-07-02
+---
+
+remocn had backgrounds and text animations but almost nothing for the cut between two scenes. This closes that hole with eleven transitions — eight driven by shaders, three by camera motion. All of them are Remotion transition presentations, so they drop straight into a `TransitionSeries.Transition` and take their character from the timing function you pass.
+
+<ChangelogPreview name="swirl-dissolve" />
+
+### New components
+
+Shader dissolves — [Dither Dissolve](/docs/transitions/dither-dissolve), [Grain Dissolve](/docs/transitions/grain-dissolve), [Perlin Dissolve](/docs/transitions/perlin-dissolve), [Smoke Dissolve](/docs/transitions/smoke-dissolve), [Swirl Dissolve](/docs/transitions/swirl-dissolve), [Warp Dissolve](/docs/transitions/warp-dissolve), [Wave Wipe](/docs/transitions/wave-wipe), and [Ripple Zoom](/docs/transitions/ripple-zoom).
+
+Camera moves — [Whip Pan](/docs/transitions/whip-pan), [Push Through](/docs/transitions/push-through), and [Focus Pull](/docs/transitions/focus-pull).
diff --git a/content/changelog/2026-07-06-llms-txt.mdx b/content/changelog/2026-07-06-llms-txt.mdx
new file mode 100644
index 00000000..49acfedb
--- /dev/null
+++ b/content/changelog/2026-07-06-llms-txt.mdx
@@ -0,0 +1,12 @@
+---
+title: llms.txt for AI agents
+date: 2026-07-06
+---
+
+Agents were reading remocn docs by scraping the rendered site, which is a bad way to learn an API. Now the docs are available as plain text at the addresses agents already look for.
+
+### Improvements
+
+- `/llms.txt` lists every docs page with a short description.
+- `/llms-full.txt` returns the whole documentation as one Markdown document.
+- Any docs page can be fetched as raw Markdown by appending `.md` to its URL.
diff --git a/content/changelog/2026-07-07-performance-and-guards.mdx b/content/changelog/2026-07-07-performance-and-guards.mdx
new file mode 100644
index 00000000..4cb2fed1
--- /dev/null
+++ b/content/changelog/2026-07-07-performance-and-guards.mdx
@@ -0,0 +1,19 @@
+---
+title: Faster site, stronger guards
+date: 2026-07-07
+---
+
+An unglamorous week aimed entirely at the things that quietly rot — page weight, type safety, and the gap between what the registry says it ships and what it actually ships.
+
+### Improvements
+
+- Landing page Remotion players now mount only when scrolled into view, and registry components lazy-load in the preview barrels. Opening the site no longer means downloading every animation on it.
+- The hero video went from 18.5 MB to 4.7 MB, with a poster frame and `preload=metadata`.
+- A registry drift guard fails CI when the built artifacts disagree with the sources in `registry/`, so an installed component can no longer silently lag behind its docs.
+- Typechecking is back on in the build, with the real errors it was hiding fixed rather than suppressed.
+- CI runs lint, typecheck, tests, and the drift guard on every push.
+
+### Fixes
+
+- The render endpoint now trusts the proxy-set client IP, caps queue depth, and restricts avatar URLs to GitHub's host allowlist.
+- Stale finished and errored render jobs are evicted from the job registry instead of accumulating.
diff --git a/content/changelog/2026-07-08-new-logo-and-hero.mdx b/content/changelog/2026-07-08-new-logo-and-hero.mdx
new file mode 100644
index 00000000..f5a3e553
--- /dev/null
+++ b/content/changelog/2026-07-08-new-logo-and-hero.mdx
@@ -0,0 +1,11 @@
+---
+title: New logo, new hero
+date: 2026-07-08
+---
+
+remocn got a proper mark, and the landing page finally leads with motion instead of describing it.
+
+### Improvements
+
+- New logo, applied across the site, the favicon, and the open-graph image.
+- The hero now plays a real video built from remocn components, rather than a static screenshot of one.
diff --git a/content/changelog/2026-07-08-zoom-blur-and-drift.mdx b/content/changelog/2026-07-08-zoom-blur-and-drift.mdx
new file mode 100644
index 00000000..5db152f8
--- /dev/null
+++ b/content/changelog/2026-07-08-zoom-blur-and-drift.mdx
@@ -0,0 +1,15 @@
+---
+title: Zoom blur, drift, and two ways to swap text
+date: 2026-07-08
+---
+
+A depth punch between scenes, a slow camera drift for anything that needs to breathe, and two components for the specific problem of replacing one word with another without a hard cut.
+
+<ChangelogPreview name="zoom-blur" />
+
+### New components
+
+- [Zoom Blur](/docs/transitions/zoom-blur) — the outgoing scene scales past the viewer into blur while the incoming one resolves out of it. `rise` adds a vertical pickup to the move.
+- [Drift](/docs/layout/drift) — a continuous, slow parallax on any child. The fix for static shots that feel dead.
+- [Rolodex Flip](/docs/typography/rolodex-flip) — the old value flips away on a 3D hinge as the new one flips in.
+- [Value Swap](/docs/typography/value-swap) — a shorter, flatter swap for numbers and labels that change often.
diff --git a/content/changelog/2026-07-10-animated-icons.mdx b/content/changelog/2026-07-10-animated-icons.mdx
new file mode 100644
index 00000000..e2fd515d
--- /dev/null
+++ b/content/changelog/2026-07-10-animated-icons.mdx
@@ -0,0 +1,12 @@
+---
+title: 100 animated icons
+date: 2026-07-10
+---
+
+Lucide icons, re-authored for video. Every icon draws itself in and then performs one action that belongs to it — the bell rings, the heart beats, the trash lid lifts. The geometry is Lucide's, so they sit next to the icons already in your product; the motion is new.
+
+<ChangelogPreview name="icon-heart" />
+
+### New components
+
+100 icons across navigation, media, status, commerce, files, and communication. Browse them all in the [icon gallery](/docs/icons/gallery), where each one previews on hover and installs with a single command.
diff --git a/content/changelog/2026-07-11-docs-typography.mdx b/content/changelog/2026-07-11-docs-typography.mdx
new file mode 100644
index 00000000..30e42e80
--- /dev/null
+++ b/content/changelog/2026-07-11-docs-typography.mdx
@@ -0,0 +1,11 @@
+---
+title: Docs typography rebuilt on typeset
+date: 2026-07-11
+---
+
+Docs prose had accumulated a decade of one-off overrides — a margin here, a font size there — and headings drifted between pages. That is all gone. Typography now derives from shadcn typeset, so vertical rhythm, headings, links, and tables come from one system instead of from whichever page you happened to land on.
+
+### Improvements
+
+- All docs pages render inside a single `typeset` container. Per-page text overrides were deleted rather than tuned.
+- Code blocks moved to rehype-pretty-code with the vesper theme, matching the shadcn-style block — line numbers, filename with language icon, and a copy button.
diff --git a/content/changelog/2026-07-14-stars-generator-retired.mdx b/content/changelog/2026-07-14-stars-generator-retired.mdx
new file mode 100644
index 00000000..761473fd
--- /dev/null
+++ b/content/changelog/2026-07-14-stars-generator-retired.mdx
@@ -0,0 +1,11 @@
+---
+title: The stars generator is retired
+date: 2026-07-14
+---
+
+The GitHub stars video generator at `/stars` is no longer accepting new renders. It was a fun experiment and a good stress test of the render pipeline, but keeping a public render queue healthy is a different project from maintaining a component registry, and the registry is where the value is.
+
+### Improvements
+
+- `/stars` now shows a short notice explaining the retirement instead of the generator form.
+- The [GitHub Stars](/docs/social/github-stars) component is unaffected — install it and render the same animation inside your own Remotion project, where you own the code and the render.
diff --git a/package.json b/package.json
index 57491250..54b38fb4 100644
--- a/package.json
+++ b/package.json
@@ -54,7 +54,8 @@
"sonner": "^2.0.7",
"tailwind-merge": "^3.5.0",
"tw-animate-css": "^1.4.0",
- "vaul": "^1.1.2"
+ "vaul": "^1.1.2",
+ "zod": "^4.3.6"
},
"devDependencies": {
"@biomejs/biome": "2.2.0",
diff --git a/source.config.ts b/source.config.ts
index 36cb15f4..92b71564 100644
--- a/source.config.ts
+++ b/source.config.ts
@@ -1,7 +1,12 @@
import { metaSchema, pageSchema } from "fumadocs-core/source/schema";
-import { defineConfig, defineDocs } from "fumadocs-mdx/config";
+import {
+ defineCollections,
+ defineConfig,
+ defineDocs,
+} from "fumadocs-mdx/config";
import rehypePrettyCode from "rehype-pretty-code";
import type { ShikiTransformer } from "shiki";
+import { z } from "zod";
export const docs = defineDocs({
dir: "content/docs",
@@ -16,6 +21,15 @@ export const docs = defineDocs({
},
});
+export const changelog = defineCollections({
+ type: "doc",
+ dir: "content/changelog",
+ schema: z.object({
+ title: z.string(),
+ date: z.date(),
+ }),
+});
+
const transformers: ShikiTransformer[] = [
{
code(node) {