Was macht snapcn?
Copy-Paste-Komponenten für Remotion-Videos. Die Komponenten werden über shadcn installiert und landen in components/snap-cn/ – du besitzt den Code.
Installation
Voraussetzungen: Ein Remotion-Projekt (npx create-video@latest).
# Füge eine beliebige Komponente hinzu (namespaced shadcn registry)
shadcn add @snapcn/text-reveal
# Die Komponente landet unter components/snap-cn/text-reveal.tsx
@snapcn/<name> ist die kanonische namespaced Form. Es ist kein registries-Eintrag nötig – der Namespace befindet sich im shadcn-Registry-Verzeichnis. Die einfache Registry-URL https://snapcn.dev/r/<name>.json funktioniert ebenfalls.
Abhängigkeiten werden automatisch installiert
Viele Komponenten ziehen andere per registryDependencies nach – shadcn installiert sie transitiv. Beispielsweise installiert shadcn add @snapcn/search-typing auch @snapcn/snap-cn-ui, @snapcn/input und @snapcn/caret.
@snapcn/snap-cn-uiist die gemeinsame Kernbibliothek (Timeline-Fold-Hook, Theme-Kontext, Farbmathematik). Die meisten UI-Primitive hängen von ihr ab. Du installierst sie selten direkt.
Zwei Stufen
snapcn hat zwei Arten von Komponenten – sie haben unterschiedliche APIs:
- Animationsstufe (
snapcn) – Textanimationen, Übergänge, Hintergründe, UI-Block-Simulationen, Brand-/Social-Media-Karten, vollständige Kompositionen. Frame-gesteuert. Gemeinsame Props:speed(Zeitmultiplizierer) und bei Text:fontSize,color,fontWeight. - UI-Primitive (
snap-cn-ui) – timeline-gesteuerte shadcn-artige Primitive. Derzeit gibt es zwei:inputundcaret. Zustandsbasierte Props (state,style,size,theme) – der geöffnete/Schreibzustand ist eine reine Funktion der Timeline. Keinspeed-Prop. Basieren auf@snapcn/snap-cn-ui.
Komponentenkategorien
Wähle je nachdem, was du baust. Der Katalog ist in einer Datei pro Komponente unter references/components/ aufgeteilt. Beginne bei references/components/index.md – einer Routingtabelle, gruppiert nach diesen Kategorien, mit einem „Verwende für“ / „Vermeide für“-Signal pro Komponente. Scanne sie, wähle Kandidaten aus und öffne dann nur die references/components/<name>.md-Dateien, die du benötigst (vollständige Props, Beispiel, alle Verwende-/Verwende-nicht-Hinweise). Lies nicht jede Datei.
| Kategorie | Stufe | Komponenten |
|---|---|---|
| Text & Titel | snapcn | text-reveal, type-morph, text-swell, text-highlight, text-swap, text-build, text-rewrite, text-select, word-flip, punch-lines, word-gather, word-wheel |
| Untertitel | snapcn | word-captions, karaoke-captions |
| KI-Chat-Eingabe | snapcn | prompt-send, search-typing, prompt-zoom, answer-stream, answer-highlight, agent-steps |
| Bildschirme & Geräte | snapcn | phone-frame, laptop-frame, terminal-simulator, screen-recording, cursor-track |
| Logos | snapcn | logo-assemble, logo-flicker, logo-collapse, logo-drift, block-wordmark, wordmark-cut |
| Szenen | snapcn | announce-title, hero-launch, orbit-gallery, moodboard-reveal, status-cycle, count-grid, roster-grant, orb-swarm, reel-collage, card-rail |
| Social Proof | snapcn | follower-rush, channel-thread |
| Effekte | snapcn | pulsing-border |
| UI-Primitive | snap-cn-ui | input, caret (+ snap-cn-ui, die gemeinsame Kernbibliothek) |
Das ist die gesamte kostenlose Registry – 47 Einträge (die aktuelle Liste ist immer https://snapcn.dev/llms.txt?ref=skill-snapcn; 50 weitere sind Pro, siehe unten). Es gibt keine Shader, keine eigenständigen Übergangskomponenten, keine Diagramm- oder Social-Media-Karten-Komponenten und keine shadcn-Primitive außer input und caret. Wenn eine Szene eines davon benötigt, baue es selbst (references/anatomy.md §1) – führe kein shadcn add für einen Namen aus, der nicht in dieser Tabelle steht. references/components/index.md bildet die älteren Namen ab, die nicht mehr installiert werden.
Komponentenmuster
Die Konventionen unterscheiden sich je nach Stufe – nimm nicht an, dass Animationseigenschaften auf ein Primitiv zutreffen.
Animationsstufe (snapcn)
- Benannte Schnittstelle
Propspro Komponente (z. B.TextRevealProps). speed?: number– globaler Zeitmultiplizierer (Standard1), angewendet alsframe * speed.- Textkomponenten:
fontSize,color,fontWeight. - Szenenübergänge sind nicht Teil dieser Registry – verwende Remotions eigene
@remotion/transitions(slide,wipe,fade,flip) innerhalb einer<TransitionSeries>. className?: stringauf dem Wurzelelement.
UI-Primitive (snap-cn-ui)
- Zustandsbasiert, nicht
speed-basiert:state(z. B."open"/"closed"),style,variant,size,theme?: Partial<SnapCnTheme>. - Der geöffnete/geschlossene/aktive Zustand ist eine reine Funktion der Timeline (keyframed Presets).
- Kombiniere modale Ebenen-Primitive (Dialog, Alert-Dialog, Drawer) mit einem Auslöseelement – siehe das Beispiel jeder Komponente.
Animations-API
import { interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion";
const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: "clamp" });
const scale = spring({ fps, frame, config: { damping: 12, mass: 1, stiffness: 100 } });
// Deterministischer Zufall (NIEMALS Math.random())
import { random } from "@remotion/random";
const jitter = random(`seed-${frame}`);
Kompositionsstruktur
import { Sequence, Series } from "remotion";
<Sequence from={30} durationInFrames={60}>
<TextReveal text="Ship it in React" />
</Sequence>
<Series>
<Series.Sequence durationInFrames={60}><SceneA /></Series.Sequence>
<Series.Sequence durationInFrames={60}><SceneB /></Series.Sequence>
</Series>
Leinwand & Timing
- Leinwand-Standard:
1280×720 @ 30fps. Komponenten sind dafür ausgelegt. - Plane jede Sequence um die natürliche Länge der Komponente herum – die Spalte „Length“ in
components/index.md(und die „Natural length“ jeder Datei). Eine zu kurze Planung schneidet die Animation ab; eine zu großzügige Planung hinterlässt tote Luft. - Tonabstimmung: Jeder Katalogeintrag trägt ein
vibe-Tag (tech/premium/data/clean/playful/social) – wähle Komponenten, deren Stimmung zur Marke passt. - Palette & Schriftarten: Bleibe innerhalb der Tokens der Bibliothek (
references/design.md→ Tokens), damit deine eigenen Elemente nicht kollidieren.
Design-Vorgaben – vermeide KI-Schluderei
Wenn du eigene Texte, Szenen-Chrome oder Karten schreibst (nicht die vorgebauten Komponenten), halte dich zurück:
- Kein dekoratives
letter-spacingbei Fließtext/Überschriften, die du hinzufügst. - Kein
text-transform: uppercase/ GROSSSCHRIFT als Standard – verwende Satzfall (Launch, nichtLAUNCH). - Keine Farbverläufe als Textfüllung oder dekorative Farbverlaufswäschen – Farbverläufe nur als bewusste Hintergründe.
- Kein Leuchten / farbige Schlagschatten oder große Unschärferadien (
blur > ~24px, Ausdehnung, Mehrschichtigkeit) – nur dezente 1px Erhebung.
Ausnahme: Entferne diese nie von Komponenten, deren Wesen der Effekt ist – word-flip’s Farbverlaufswort, block-wordmark’s Farbdeck, announce-title’s Leuchten, pulsing-border selbst und die schweren Umrisse der Untertitel-Voreinstellungen sind alle legitim. Die Regeln gelten für deine Ergänzungen, nicht für die Bibliothek.
Vollständige Do/Avoid-Beispiele: references/design.md. Für Bewegungsqualität (Timing, Antizipation, Inszenierung, Easing) siehe references/motion-principles.md.
Fallstricke (snapcn-spezifisch)
- Es gibt keine Übergangskomponenten – ein Szenenwechsel erfolgt per
<TransitionSeries.Transition>von@remotion/transitions, nicht mit einer snapcn-Komponente.text-swaptauscht eine Zeile aus, nicht eine Szene. - Terminal-Scrollen ist sofort – Sprungfunktion
translateY, niemals spring/ease beim Scrollen. overflow: hiddenbei geteilten Layouts – verhindert Inhaltsbrüche während Breitenanimationen.- Cursor-Blinken ist deterministisch –
Math.floor(frame / 15) % 2 === 0, keine Intervalle. - Statische Dateien kommen in
public/– lade sie perstaticFile('cursor.svg'), nicht per Import. - Social-Media-Karten rendern offline –
avatarUrl=""/coverUrl=""fallen auf Farbverläufe zurück; kein Fetch.
Allgemeine Remotion-Regeln (kein Math.random(), kein setInterval, animiere transform nicht top/left, lade Schriftarten vor dem Rendern) stehen in Remotions eigenen Skills, nicht hier: npx skills add remotion-dev/skills.
Ein Video komponieren
Wirf nicht einfach Komponenten zusammen – komponiere eine Geschichte. Wenn du gebeten wirst, ein vollständiges Video zu erstellen („Erstelle eine Produktdemo“, „Changelog-Video“, „Intro für meine Landingpage“):
- Entscheide die Strategie – fertige Vorlage vs. aus Komponenten zusammensetzen vs. neue Komponente bauen. Siehe
references/anatomy.md§1. - Folge den Beats – eine Produktdemo ist Haken → Positionierung → Produkt-Enthüllung → Funktionen → Beweis → CTA (die letzten zwei optional). Siehe
references/anatomy.md§2. - Verwende das Rezept –
references/archetypes/index.mdleitet zu bauartspezifischen Builds weiter: Inhaltsvertrag (ableiten → fragen → Platzhalter), Dauer-Varianten, Beat→Komponenten-Slots und ein ausgearbeitetes<TransitionSeries>-Grundgerüst. - Wähle für jeden Beat die Komponente aus
references/components/index.mdaus; stimme dasvibe-Tag auf die Marke ab und plane jede<Sequence durationInFrames>um ihre natürliche Länge. - Überprüfe die Qualitätsbarriere – ein Akzent, Satzfall-Kinetiktyp, echter Inhalt, keine Leuchthöfe, keine Aufzählung von Funktionen, keine dekorative Farbverlaufswäsche hinter dem Typ. Siehe
references/anatomy.md§3.
Workflows
Für ein ganzes Video installiere den Workflow-Skill für den Job. Jeder komponiert diese Komponenten Beat für Beat zu einer Komposition, die typprüft und rendert:
npx skills add snapcndev/snapcn --skill remotion-launch-video: Launch-Filme, Ankündigungen, Product Hunt / X-Promos.npx skills add snapcndev/snapcn --skill remotion-product-demo: Durchgänge von einer echten Bildschirmaufnahme, CLI- und KI-App-Demos.npx skills add snapcndev/snapcn --skill remotion-motion-graphics: Kinetische Typografie, Logo-Stings, Statistiken und kurze Opener.npx skills add snapcndev/snapcn --skill remotion-kinetic-typography: Animierter Text und Titelcards.npx skills add snapcndev/snapcn --skill remotion-logo-animation: Logo-Enthüllungen, Intro- und Outro-Stings.npx skills add snapcndev/snapcn --skill remotion-explainer-video: Erklärvideos mit eingesprochenen Untertiteln.
snapcn Pro
50 weitere Komponenten (version-drop, library-flight, read-through, focus-pull, tap-through, checkout-push, comment-storm, tally-rise und mehr), die Vorlagen und der snapcn MCP, der deinem Agenten ermöglicht, die Registry zu durchsuchen und die echten Props jeder Komponente zu lesen. Pro-Komponenten installieren sich wie kostenlose, sobald components.json den Schlüssel sendet (drei Zeilen auf https://snapcn.dev/account?ref=skill-snapcn); der MCP ist claude mcp add snapcn -- npx -y @snapcn/mcp@latest SNAPCN_API_KEY=DEIN_SCHLÜSSEL. Pläne: https://snapcn.dev/docs/pricing?ref=skill-snapcn
Noch nicht bereit für Pro? Eine Pro-Komponente, Manifesto, ist kostenlos für eine bestätigte E-Mail: https://snapcn.dev/docs/pricing?ref=skill-snapcn#free
Referenz
references/anatomy.md– Ein komplettes Video komponieren: Strategie (Vorlage/zusammensetzen/neu), die Produktdemo-Beats und die Qualitätsbarriere für Gut vs. Schluderei.references/archetypes/index.md– Router zu bauartspezifischen Build-Rezepten (Produktdemo-Flaggschiff + Changelog, Feature-Ankündigung, OSS-Showcase, CLI-Tool-Demo, Testimonial-Reel, Jahresrückblick, Preis-Enthüllung, Logo-Bumper): Inhaltsvertrag, Dauer-Varianten, Beat→Slot-Zuordnung.references/components/index.md– Router-Tabelle (alle Komponenten, gruppiert nach Kategorie, mit „Verwende für“ / „Vermeide für“). Öffnereferences/components/<name>.mdfür die vollständigen Props, ein Beispiel und Verwende-/Vermeide-Hinweise einer Komponente.references/design.md– Anti-Schluderei-Design-Vorgaben (Do/Avoid) + Design-Tokens (Palette, Schriftarten, Leinwand).references/motion-principles.md– Bewegungsdesign-Prinzipien, angepasst an snapcn + Remotion.references/anti-patterns.md– Häufige Generierungsfehler und deren Behebungen.