sj-design
jayvee6/sj-design
a claude skill that builds beautiful and professional presentations
Instalação
npx convez-ai jayvee6/sj-design1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
sj-design — Motion, Graphics & Presentation Toolkit for Claude Code
A Claude Code skill that produces self-contained, animated HTML from natural language prompts. It ships motion primitives — hero backgrounds, loading states, celebration moments, atmospheric FX, emoji visualizations, dancing emoji formations, WebGPU 3D scenes, and image FX — plus a complete Apple-style slide-deck generator built on the same primitives. Every output is a single .html file with no dependencies to install — ready to open in any browser.
See it in action → studiojoe.dev — live demos of the motion primitives, themes, and generated decks.
Building native iOS under the Studio Joe design system? See docs/swiftui-conventions.md for the iOS 26 Liquid Glass mappings.

What's in the box
| Motion primitives | Copy-pasteable, zero-dependency demos for hero backgrounds, loaders, and celebration moments. Each runs on a synthetic time pulse with a one-line hook to wire back to audio. |
| Presentations | A full slide-deck generator — narrative planning, Apple Style Guide copy, 8 layouts, 17 themes, cinematic GSAP animation. |
Both share the same lib (lib/), design tokens, and Glass Refraction system.
Motion primitives
Standalone demos live in showcase/. Reference docs in references/.
Emoji visualizations
Self-contained canvas-2D techniques — see references/emoji-visualizations.md.
showcase/emoji-waves.html— concentric delayed-bass ringsshowcase/emoji-vortex.html— golden-angle phyllotaxis tunnelshowcase/emoji-fireworks.html— themed parabolic bursts (peony / ring / star / heart / smiley)
Dancing formations
showcase/emoji-formations/ — triangle-orbit · hex-swarm · heart-pulse · infinity-loop · star-formation · shape-morph
WebGPU scenes
showcase/scenes/ — raw WebGPU; needs a WebGPU-capable browser, degrades to a message otherwise.
wire-terrain— raymarched FBM terraindisco-chrome— ray-sphere mirror ballneon-oscilloscope— four ribbon wavescosmic-disco— physical tile-bounced volumetric beams + mirror ball (also a Three.js variant)
Pattern + perf knobs (maxDPR, renderScale) live in lib/webgpu-bootstrap.js (SJGpu). Reference: WebGPU Fundamentals.
Image FX
Recipes in references/image-fx.md — independent reimplementations of techniques by akella (Yuri Artyukh); generated output must keep a visible akella credit.
- 3D object/logo explosion — pre-fractured GLB shards driven by one
progressuniform - fake-3D depth-map photo parallax — cursor/gyro UV offset with inertia
- hover image distortion/reveal — per-tile displacement + RGB split + cross-fade
Atmospheric FX
showcase/atmosphere.html (combined, interactive) plus split single-effect files atmosphere-{gobo,starfield,bokeh,fog,grain}.html.
Shared lib
lib/ — canvas-size.js (SJCanvas, DPR sizing) · synthetic-pulse.js (SJPulse) · envelopes.js (VizEnv attack/release) · webgpu-bootstrap.js (SJGpu). Demos load these with an inline fallback so each file stays single-file portable.
Presentations
Every deck is a single .html file with no external dependencies:
- 8 slide layouts — title, content, stats, quote, two-column, gallery, media, closing
- 17 themes — dark, light, and atmospheric (see below)
- Cinematic GSAP animations — Apple
cubic-bezier(0.16, 1, 0.3, 1)expo-out, spring easing, per-element stagger - Ambient atmosphere — Perlin-noise gobo blobs, starfields, bokeh discs, SF fog layers, fireflies, rain, confetti — unique per theme, no config needed
- Glass Refraction — physics-based frosted glass fills with 4-edge specular bezels, SVG
feDisplacementMaprim refraction, andfeGaussianBlur— works in Chrome, Firefox, and Safari - Stats count-up — animated number counters that spring in from zero; supports
$,%,+, commas - Ken Burns gallery — photo slideshow with continuous pan/zoom crossfades
- YouTube / video / image embeds — auto-detected from URL; local files base64-embedded
- HUD controls — slide counter, text-size presets (persisted in localStorage), emoji rain toggle, progress bar
- Keyboard + click + swipe navigation —
→/Spaceadvance,←back,Ffullscreen
Usage
Claude Code picks up the skill automatically. Just describe what you want:
Make me a 6-slide presentation about the history of the internet
Create a pitch deck for a SaaS startup. Use the Obsidian theme.
Build a property overview for 740 37th Ave — stats: $5,340 current rent,
$10,400 market potential, $1.66M projected 2031 value. Gallery of exterior photos.
Quarterly business review — revenue stats, Q3 vs Q4 two-column comparison,
key wins, strong closing. Dark theme.
10-slide product launch deck for our AI writing tool. B2B audience.
Include a demo slide with this YouTube link and a quote from a beta user.
Claude plans a narrative arc, writes content following Apple Style Guide rules, builds a JSON spec, runs the build script, and opens the result.
Or ask for a motion primitive directly:
Give me a landing-page hero background — the dancing emoji heart-pulse,
subtle, behind centered headline text.
Make a signup-success screen that fires the emoji fireworks (star burst)
once on load, then idles.
Drop the Wire Terrain WebGPU scene in dim behind a "No results yet" message.
Give this product photo a 3D depth effect that follows the mouse.
Themes
| Theme | Key | Atmosphere |
|---|---|---|
| Blue Hour | dark | Starfield · Perlin gobo blobs · SF fog · bokeh |
| Crissy Field | light | Warm bokeh · blue gradient · Perlin blobs |
| Obsidian | obsidian | Floating dust particles · green-tinted gobos |
| Deep Space | deep-space | 200-star field · cyan/violet/pink nebula |
| Noir | noir | Film grain · venetian blinds · rain streaks · crimson bloom |
| Golden Hour | golden-hour | Warm amber bokeh · amber-to-cream gradient |
| Twin Peaks | twin-peaks | City glow · teal fog · night purple/teal gobos |
| Embarcadero | embarcadero | Steel-blue fog · grey-blue bokeh |
| Muir Woods | muir-woods | Blinking fireflies · deep forest green gobos |
| The Mission | the-mission | Warm orange/pink gradients · vivid saturated gobos |
| Santa Cruz | santa-cruz | Aqua/seafoam bokeh · ocean blue gobos |
| Sausalito | sausalito | Soft teal/silver bokeh · harbour mist |
| Half Moon Bay | half-moon-bay | Coastal fog · storm grey/slate gobos |
| Redwood | redwood | Amber fireflies · deep burgundy/forest gobos |
| The Richmond | the-richmond | SF fog · cool lavender/grey gobos |
| Nob Hill | nob-hill | Champagne bokeh · gold/ivory gobos · light mist |
| Haight | haight | Floating emoji · spinning mandala · confetti · explosion on nav |
Specify a theme in your prompt or let Claude choose based on context.
Theme gallery
![]() | ![]() |
| Blue Hour — deep indigo night sky, SF fog, Perlin gobo blobs | Noir — pure black, crimson bloom, film grain, rain streaks |
![]() | ![]() |
| Crissy Field — California coastal daylight, warm blue gradient | Obsidian — matte charcoal, floating dust particles, terminal green |
![]() | ![]() |
| Muir Woods — deep forest, blinking fireflies, green gobos | Deep Space — 200-star field, cyan/violet/pink nebula |
![]() | ![]() |
| Golden Hour — warm amber gradient, low sun bokeh | Nob Hill — champagne bokeh, gold/ivory gobos, light mist |
![]() | ![]() |
| Twin Peaks — city glow, teal fog, night purple gobos | The Mission — warm orange/pink gradients, vivid saturated gobos |
![]() | |
| Haight — floating emoji, spinning mandala, confetti explosion |
Slide types
| Type | Best for |
|---|---|
title | Opening slide, section breaks |
content | Bullets, features, key points |
stats | Metrics, financials, KPIs — animated count-up |
quote | Social proof, pull quotes |
two-column | Comparisons, before/after, side-by-side |
gallery | Photo showcases — Ken Burns slideshow |
media | YouTube, video files, images |
closing | CTA, thank you, contact info |
Navigation
| Input | Action |
|---|---|
→ / Space / click right half | Next slide |
← / click left half | Previous slide |
F | Fullscreen |
| Swipe left / right | Next / previous (touch) |
⏮ ⏭ buttons | Jump to first / last slide |
A− A A+ A++ | Text size presets |
File structure
sj-design/
├── SKILL.md # Skill definition — Claude reads this
├── scripts/
│ └── build_presentation.py # Builds HTML from a JSON spec
├── assets/
│ └── template.html # GSAP template with all 17 themes
├── lib/ # Shared zero-dependency modules
│ ├── canvas-size.js # SJCanvas — DPR-aware sizing
│ ├── synthetic-pulse.js # SJPulse — synthetic time pulse
│ ├── envelopes.js # VizEnv — attack/release envelopes
│ └── webgpu-bootstrap.js # SJGpu — WebGPU setup + perf knobs
├── references/
│ ├── emoji-visualizations.md # Concentric Waves / Vortex / Fireworks
│ ├── image-fx.md # 3D explosion · fake3d · hover distortion
│ ├── slide-animations.md # Per-slide GSAP choreography
│ └── apple-hig/ # Apple Human Interface Guidelines notes
├── showcase/
│ ├── index.html # Design system showcase
│ ├── glass-refraction-demo.html # Interactive Glass Refraction technique demo
│ ├── emoji-{waves,vortex,fireworks}.html
│ ├── atmosphere*.html # Combined + split atmospheric FX
│ ├── emoji-formations/ # 6 dancing emoji formations
│ ├── scenes/ # WebGPU 3D scenes
│ └── decks/ # Example generated decks
├── docs/
│ ├── swiftui-conventions.md # iOS 26 Liquid Glass mappings
│ └── screenshots/ # README imagery
└── evals/
└── evals.json # Eval test cases
Build manually
python3 scripts/build_presentation.py spec.json -o deck.html
open deck.html
Pipe via stdin:
echo '{"title":"My deck","theme":"dark","slides":[...]}' \
| python3 scripts/build_presentation.py
Glass Refraction

The template uses a physics-based glass refraction technique, ported from @hashintel/refractive (MIT/Apache-2.0) to vanilla JS/CSS/SVG:
- Surface equations —
convexCircle,convex,concave,lip(x)model light refraction through curved glass using Snell's law - 64×64 displacement map — generated at runtime in a canvas, encoded as PNG, fed into
feImage→feDisplacementMap - Rim-focused displacement — peak refraction at ~6–10% inward from each edge; exact border pixels are always neutral (card shape never warps)
- 4-edge specular bezel —
insetbox-shadows on all four edges with per-theme accent tints simulate light catching each face of the glass rim - Cross-browser —
feGaussianBlurin the SVG filter chain handles blur; the displacement is applied to the background element rather than the glass card itself, avoiding Safari'sfilter + backdrop-filtercompositing limitation
See showcase/glass-refraction-demo.html for an interactive breakdown of each technique layer.
Live demos at studiojoe.dev · Built with Claude Code · Animations by GSAP · Canvas 2D + WebGPU · Apple design tokens










