Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 17 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,30 +13,36 @@
</p>

<p align="center">
<em>Above: <code>gallery/loop-studio/showcase.gif</code> — a 10-second, 160-frame showcase loop rendered directly by the <code>loop</code> CLI (`seamScore: 1.00`, `duplicateFrames: 0`, `WCAG contrast: 13.7:1`).</em>
<em>Above: <code>gallery/loop-studio/showcase.gif</code> — a 10-second, 160-frame showcase loop rendered directly by the <code>loop</code> CLI (`seamScore: 1.032`, `duplicateFrames: 0`, `PASS`).</em>
</p>

---

## Gallery

Every animation below is pure deterministic code (`sketch.js`), measured by `loop audit`, and committed with its exact `showcase.json` or `brief.json`, contact sheet (`sheet.png`), storyboard (`storyboard.png`), and `seam.json`. Pick any folder in [`gallery/`](./gallery), change one number, and re-render.
Every animation below is pure deterministic code (`sketch.js`), measured by `loop audit`, and committed with its exact `showcase.json` or `brief.json`, contact sheet (`sheet.png`), storyboard (`storyboard.png`), and `seam.json`. Pick any folder in [`gallery/`](./gallery), change one number, and re-render (including `30–60 fps` Animated WebP & MP4).

### Showcase Loops (What a Repository Does)

| Preview | Subject & Scene Pack | Seam & Audit | Artifacts |
| Preview | Subject, Scene Pack & Real Use Case | Seam & Audit | Artifacts |
| :--- | :--- | :--- | :--- |
| <img src="./gallery/loop-studio/showcase.gif" width="380" alt="Loop Studio Flow Showcase"> | **Loop Studio Pipeline** (`scenes/flow` · `studio-dark`)<br><em>"Loop Studio turns a one-line request into a checked, seamless loop."</em> | `seamScore: 1.00`<br>`dups: 0` · `PASS` | [showcase.json](./gallery/loop-studio/showcase.json) · [sketch.js](./gallery/loop-studio/sketch.js) · [storyboard.png](./gallery/loop-studio/storyboard.png) · [audit.json](./gallery/loop-studio/audit.json) |
| <img src="./gallery/cli-audit-session/showcase.gif" width="380" alt="Loop CLI Terminal Showcase"> | **Loop CLI Audit Session** (`scenes/terminal` · `phosphor`)<br><em>"The loop CLI audits any sketch for seam jumps, caption legibility, and source citations."</em> | `seamScore: 1.02`<br>`dups: 0` · `PASS` | [showcase.json](./gallery/cli-audit-session/showcase.json) · [sketch.js](./gallery/cli-audit-session/sketch.js) · [storyboard.png](./gallery/cli-audit-session/storyboard.png) · [audit.json](./gallery/cli-audit-session/audit.json) |
| <img src="./gallery/loop-studio/showcase.gif" width="380" alt="Loop Studio Flow Showcase"> | **Loop Studio Pipeline** (`scenes/flow` · `studio-dark`)<br>**Use case**: README hero diagram explaining an end-to-end tool or compiler pipeline.<br><em>"Loop Studio turns a one-line request into a checked, seamless loop."</em> | `10s · 16fps`<br>`seamScore: 1.032` (`PASS`) | [showcase.json](./gallery/loop-studio/showcase.json) · [sketch.js](./gallery/loop-studio/sketch.js) · [storyboard.png](./gallery/loop-studio/storyboard.png) · [audit.json](./gallery/loop-studio/audit.json) |
| <img src="./gallery/cli-audit-session/showcase.gif" width="380" alt="Loop CLI Terminal Showcase"> | **Loop CLI Audit Session** (`scenes/terminal` · `phosphor`)<br>**Use case**: CLI documentation showing real flags, terminal telemetry, and pass/fail checks.<br><em>"The loop CLI audits any sketch for seam jumps, caption legibility, and source citations."</em> | `10s · 16fps`<br>`seamScore: 0.989` (`PASS`) | [showcase.json](./gallery/cli-audit-session/showcase.json) · [sketch.js](./gallery/cli-audit-session/sketch.js) · [storyboard.png](./gallery/cli-audit-session/storyboard.png) · [audit.json](./gallery/cli-audit-session/audit.json) |
| <img src="./gallery/api-pipeline-code/showcase.gif" width="380" alt="Phase Contract SDK Code Showcase"> | **Phase Contract SDK** (`scenes/code` · `studio-dark`)<br>**Use case**: Library & SDK docs pairing live-stepping code lines with a synchronized state monitor.<br><em>"Every Loop Studio sketch exports meta and a pure render(ctx, phase) function."</em> | `10s · 20fps`<br>`seamScore: 1.006` (`PASS`) | [showcase.json](./gallery/api-pipeline-code/showcase.json) · [sketch.js](./gallery/api-pipeline-code/sketch.js) · [storyboard.png](./gallery/api-pipeline-code/storyboard.png) · [audit.json](./gallery/api-pipeline-code/audit.json) |
| <img src="./gallery/mcp-mesh-topology/showcase.gif" width="380" alt="Agent Orchestrator Architecture Showcase"> | **Agent Orchestrator Mesh** (`scenes/architecture` · `aurora`)<br>**Use case**: System architecture & multi-agent / MCP service topology diagrams for RFCs & READMEs.<br><em>"The Loop Studio orchestrator coordinates the CLI renderer, seam analyzer, and cold-read subagent."</em> | `10s · 20fps`<br>`seamScore: 0.985` (`PASS`) | [showcase.json](./gallery/mcp-mesh-topology/showcase.json) · [sketch.js](./gallery/mcp-mesh-topology/sketch.js) · [storyboard.png](./gallery/mcp-mesh-topology/storyboard.png) · [audit.json](./gallery/mcp-mesh-topology/audit.json) |

### Ambient Loops (Mood, Backgrounds & Generative Motion)
### Ambient Loops (Mood, Backgrounds, 30–60 fps UI & Social Motion)

| Preview | Style Pack & Prompt | Specs & Seam Score | Artifacts |
| Preview | Style Pack & Real Use Case | Specs & Seam Score | Artifacts |
| :--- | :--- | :--- | :--- |
| <img src="./gallery/deep-sea-orbits/loop.gif" width="220" alt="Abyssal Bioluminescence"> | **`styles/particle-orbit`** (`abyss`)<br><em>"Make a 4-second square loop. Deep sea, slow, bioluminescent."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.00` (`PASS`) | [brief.json](./gallery/deep-sea-orbits/brief.json) · [sketch.js](./gallery/deep-sea-orbits/sketch.js) · [sheet.png](./gallery/deep-sea-orbits/sheet.png) · [seam.json](./gallery/deep-sea-orbits/seam.json) |
| <img src="./gallery/aurora-flow-field/loop.gif" width="220" alt="Arctic Currents Flow Field"> | **`styles/flow-field`** (`aurora`)<br><em>"Drifting aurora currents, organic silk streamlines, 4-second loop."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.02` (`PASS`) | [brief.json](./gallery/aurora-flow-field/brief.json) · [sketch.js](./gallery/aurora-flow-field/sketch.js) · [sheet.png](./gallery/aurora-flow-field/sheet.png) · [seam.json](./gallery/aurora-flow-field/seam.json) |
| <img src="./gallery/nordic-isometric/loop.gif" width="220" alt="Harmonic Architecture Isometric Grid"> | **`styles/isometric-grid`** (`nordic`)<br><em>"Clean architectural blocks on an isometric grid rising and falling in waves."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.00` (`PASS`) | [brief.json](./gallery/nordic-isometric/brief.json) · [sketch.js](./gallery/nordic-isometric/sketch.js) · [sheet.png](./gallery/nordic-isometric/sheet.png) · [seam.json](./gallery/nordic-isometric/seam.json) |
| <img src="./gallery/cad-planetary/loop.gif" width="220" alt="Epicyclic Telemetry Blueprint CAD"> | **`styles/blueprint-cad`** (`blueprint`)<br><em>"Precision engineering blueprint with planetary gear linkages at 1x and -2x speeds."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.00` (`PASS`) | [brief.json](./gallery/cad-planetary/brief.json) · [sketch.js](./gallery/cad-planetary/sketch.js) · [sheet.png](./gallery/cad-planetary/sheet.png) · [seam.json](./gallery/cad-planetary/seam.json) |
| <img src="./gallery/deep-sea-orbits/loop.gif" width="220" alt="Abyssal Bioluminescence"> | **`styles/particle-orbit`** (`abyss`)<br>**Use case**: Calm dark-mode app background, stream overlay, or loading state.<br><em>"Deep sea, slow, bioluminescent particle orbits."</em> | `4s · 20fps · 320×320`<br>`seamScore: 0.972` (`PASS`) | [brief.json](./gallery/deep-sea-orbits/brief.json) · [sketch.js](./gallery/deep-sea-orbits/sketch.js) · [sheet.png](./gallery/deep-sea-orbits/sheet.png) · [seam.json](./gallery/deep-sea-orbits/seam.json) |
| <img src="./gallery/aurora-flow-field/loop.gif" width="220" alt="Arctic Currents Flow Field"> | **`styles/flow-field`** (`aurora`)<br>**Use case**: Organic generative header for landing pages and music visualizers.<br><em>"Drifting aurora currents, organic silk streamlines."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.037` (`PASS`) | [brief.json](./gallery/aurora-flow-field/brief.json) · [sketch.js](./gallery/aurora-flow-field/sketch.js) · [sheet.png](./gallery/aurora-flow-field/sheet.png) · [seam.json](./gallery/aurora-flow-field/seam.json) |
| <img src="./gallery/nordic-isometric/loop.gif" width="220" alt="Harmonic Architecture Isometric Grid"> | **`styles/isometric-grid`** (`nordic`)<br>**Use case**: Cloud platform, cluster orchestration, or modular infrastructure tile.<br><em>"Architectural blocks on an isometric grid rising in waves."</em> | `4s · 20fps · 320×320`<br>`seamScore: 0.927` (`PASS`) | [brief.json](./gallery/nordic-isometric/brief.json) · [sketch.js](./gallery/nordic-isometric/sketch.js) · [sheet.png](./gallery/nordic-isometric/sheet.png) · [seam.json](./gallery/nordic-isometric/seam.json) |
| <img src="./gallery/cad-planetary/loop.gif" width="220" alt="Epicyclic Telemetry Blueprint CAD"> | **`styles/blueprint-cad`** (`blueprint`)<br>**Use case**: Robotics, hardware, CAD, and precision engineering project badges.<br><em>"Planetary gear linkages rotating at 1x and -2x harmonic speeds."</em> | `4s · 20fps · 320×320`<br>`seamScore: 1.023` (`PASS`) | [brief.json](./gallery/cad-planetary/brief.json) · [sketch.js](./gallery/cad-planetary/sketch.js) · [sheet.png](./gallery/cad-planetary/sheet.png) · [seam.json](./gallery/cad-planetary/seam.json) |
| <img src="./gallery/readme-hero-3d/loop.webp" width="220" alt="Nebula 3D Raymarched Sculpture"> | **`styles/sdf-raymarch`** (`nebula`)<br>**Use case**: Zero-dependency 3D product hero & smooth WebP/MP4 shader sculpture.<br><em>"30 fps 3D raymarched smooth-union torus and orbiting spheres."</em> | `3s · 30fps · 280×280` (WebP)<br>`seamScore: 1.061` (`PASS`) | [loop.webp](./gallery/readme-hero-3d/loop.webp) · [loop.gif](./gallery/readme-hero-3d/loop.gif) · [sketch.js](./gallery/readme-hero-3d/sketch.js) · [sheet.png](./gallery/readme-hero-3d/sheet.png) |
| <img src="./gallery/retro-crt-loader/loop.gif" width="220" alt="Amber CRT Bayer Dither Radar"> | **`styles/dither-mono`** (`amber-crt`)<br>**Use case**: Low-bandwidth CLI/game splash screen & zero-shimmer retro loader.<br><em>"30 fps amber CRT sphere and radar sweep via ordered 4×4 Bayer dithering."</em> | `3s · 30fps · 280×280`<br>`seamScore: 1.005` (`PASS`) | [loop.gif](./gallery/retro-crt-loader/loop.gif) · [loop.webp](./gallery/retro-crt-loader/loop.webp) · [sketch.js](./gallery/retro-crt-loader/sketch.js) · [sheet.png](./gallery/retro-crt-loader/sheet.png) |
| <img src="./gallery/kinetic-release-banner/loop.webp" width="220" alt="60 fps Editorial Kinetic Wave"> | **`styles/kinetic-type`** (`editorial`)<br>**Use case**: Silky **60 fps** social release announcement card & talk title slide.<br><em>"60 fps editorial kinetic typography wave with WCAG-verified focal pill."</em> | `2s · 60fps · 280×280` (WebP)<br>`seamScore: 0.987` (`PASS`) | [loop.webp](./gallery/kinetic-release-banner/loop.webp) · [loop.gif](./gallery/kinetic-release-banner/loop.gif) · [sketch.js](./gallery/kinetic-release-banner/sketch.js) · [sheet.png](./gallery/kinetic-release-banner/sheet.png) |
| <img src="./gallery/sonar-bathymetry/loop.gif" width="220" alt="Abyssal Bathymetry Topographic Isolines"> | **`styles/topographic-contour`** (`abyss`)<br>**Use case**: Geospatial, weather, sonar, and telemetry elevation backgrounds.<br><em>"30 fps bathymetric contour isolines over a cyclic scalar noise field."</em> | `3s · 30fps · 280×280`<br>`seamScore: 0.951` (`PASS`) | [loop.gif](./gallery/sonar-bathymetry/loop.gif) · [loop.webp](./gallery/sonar-bathymetry/loop.webp) · [sketch.js](./gallery/sonar-bathymetry/sketch.js) · [sheet.png](./gallery/sonar-bathymetry/sheet.png) |

---

Expand Down
15 changes: 15 additions & 0 deletions gallery/api-pipeline-code/audit.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"id": "api-pipeline-code",
"title": "Phase Contract SDK Showcase (Code)",
"mode": "showcase",
"useCase": "SDK / library docs pairing live-stepping code with a synchronized state monitor",
"fps": 20,
"pass": true,
"seamScore": 1.006,
"duplicateFrames": 0,
"flickerScore": 0.08,
"legiblePass": true,
"sourcesPass": true,
"gifKB": 2343.8,
"totalFrames": 200
}
120 changes: 120 additions & 0 deletions gallery/api-pipeline-code/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Phase Contract SDK Showcase (Code) · Loop Studio</title>
<style>
:root {
--bg: #0E1120; --surface: #171B2E; --stage: #0A0C18; --ink: #E7E9F4;
--muted: #9BA1BC; --line: #2A3050; --accent: #FF6B9D; --spark: #7FA2FF;
--mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
}
body {
margin: 0; padding: 2rem 1rem; background: var(--bg); color: var(--ink);
font-family: system-ui, -apple-system, sans-serif;
}
.wrap { max-width: 56rem; margin: 0 auto; display: flex; flex-direction: column; gap: 1.25rem; }
header { display: flex; justify-content: space-between; align-items: baseline; flex-wrap: wrap; gap: 0.5rem; }
h1 { margin: 0; font-size: 1.35rem; font-weight: 700; }
.badge { font-family: var(--mono); font-size: 0.78rem; color: var(--spark); background: var(--surface); border: 1px solid var(--line); padding: 0.25rem 0.6rem; border-radius: 4px; }
.stage-box { border: 1px solid var(--line); border-radius: 8px; background: var(--stage); overflow: hidden; }
.canvas-holder { display: flex; justify-content: center; align-items: center; padding: 1rem; background: var(--stage); }
canvas { display: block; max-width: 100%; height: auto; border-radius: 4px; box-shadow: 0 8px 24px rgba(0,0,0,0.35); }
canvas.mobile-width { max-width: 400px; }
.transport {
display: flex; flex-wrap: wrap; align-items: center; gap: 0.75rem;
padding: 0.75rem 1rem; background: var(--surface); border-top: 1px solid var(--line);
}
button {
font: 500 0.82rem var(--mono); color: var(--ink); background: var(--bg);
border: 1px solid var(--line); border-radius: 4px; padding: 0.4rem 0.75rem; cursor: pointer;
}
button:hover { border-color: var(--accent); }
input[type="range"] { flex: 1 1 12rem; accent-color: var(--accent); }
output { font-family: var(--mono); font-size: 0.8rem; color: var(--muted); font-variant-numeric: tabular-nums; }
</style>
</head>
<body>
<div class="wrap">
<header>
<h1>Phase Contract SDK Showcase (Code)</h1>
<span class="badge" id="meta-badge">loading sketch.js...</span>
</header>
<div class="stage-box">
<div class="canvas-holder">
<canvas id="stage-canvas"></canvas>
</div>
<div class="transport">
<button type="button" id="play-btn">Pause</button>
<input type="range" id="scrubber" min="0" max="119" value="0" step="1">
<output id="readout">frame 000 / 120 · phase 0.00</output>
<button type="button" id="phone-btn">400px Phone View</button>
</div>
</div>
</div>
<script type="module">
import * as sketch from "./sketch.js";
import { createKit } from "./loop-kit.js";

const cv = document.getElementById("stage-canvas");
const ctx = cv.getContext("2d");
const playBtn = document.getElementById("play-btn");
const phoneBtn = document.getElementById("phone-btn");
const scrubber = document.getElementById("scrubber");
const readout = document.getElementById("readout");
const badge = document.getElementById("meta-badge");

const meta = sketch.meta || { seconds: 4, fps: 30, width: 640, height: 640 };
const totalFrames = Math.round((meta.seconds || 4) * (meta.fps || 30));
cv.width = meta.width || 640;
cv.height = meta.height || 640;
scrubber.max = String(totalFrames - 1);
badge.textContent = `${meta.mode || "loop"} · ${meta.seconds}s @ ${meta.fps}fps (${totalFrames}f) · ${cv.width}×${cv.height}`;

const kit = createKit({ showcase: sketch.showcase });
let frame = 0;
let playing = true;
let startedAt = null;

function drawFrame() {
const phase = frame / totalFrames;
sketch.render(ctx, phase, kit);
scrubber.value = String(frame);
readout.textContent = `frame ${String(frame).padStart(3, "0")} / ${totalFrames} · phase ${phase.toFixed(3)}`;
}

function tick(now) {
if (playing) {
if (startedAt === null) startedAt = now - (frame / totalFrames) * meta.seconds * 1000;
const u = (((now - startedAt) / 1000 / meta.seconds) % 1 + 1) % 1;
const nextF = Math.floor(u * totalFrames) % totalFrames;
if (nextF !== frame) {
frame = nextF;
drawFrame();
}
}
requestAnimationFrame(tick);
}

playBtn.addEventListener("click", () => {
playing = !playing;
startedAt = null;
playBtn.textContent = playing ? "Pause" : "Play";
});
phoneBtn.addEventListener("click", () => {
cv.classList.toggle("mobile-width");
});
scrubber.addEventListener("input", () => {
playing = false;
startedAt = null;
playBtn.textContent = "Play";
frame = parseInt(scrubber.value, 10) || 0;
drawFrame();
});

drawFrame();
requestAnimationFrame(tick);
</script>
</body>
</html>
71 changes: 71 additions & 0 deletions gallery/api-pipeline-code/legible.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
{
"pass": true,
"width": 800,
"height": 320,
"phoneWidth": 400,
"frame0ShowsAllStageLabels": true,
"stageLabelsChecked": 4,
"captions": [
{
"step": 1,
"caption": "declare duration and fps in meta",
"words": 6,
"chars": 32,
"windowSeconds": 2.5,
"requiredSeconds": 2.3,
"passReadingTime": true,
"contrastRatio": 14.25,
"passContrast": true,
"minEdgeMarginPx": 37,
"phoneFontPx": 6.5,
"passMobileWidth": true,
"pass": true
},
{
"step": 2,
"caption": "pass normalized phase to render()",
"words": 5,
"chars": 33,
"windowSeconds": 2.5,
"requiredSeconds": 2,
"passReadingTime": true,
"contrastRatio": 14.25,
"passContrast": true,
"minEdgeMarginPx": 37,
"phoneFontPx": 6.5,
"passMobileWidth": true,
"pass": true
},
{
"step": 3,
"caption": "convert phase to integer cycles",
"words": 5,
"chars": 31,
"windowSeconds": 2.5,
"requiredSeconds": 2,
"passReadingTime": true,
"contrastRatio": 14.25,
"passContrast": true,
"minEdgeMarginPx": 37,
"phoneFontPx": 6.5,
"passMobileWidth": true,
"pass": true
},
{
"step": 4,
"caption": "last frame meets frame 0 cleanly",
"words": 6,
"chars": 32,
"windowSeconds": 2.5,
"requiredSeconds": 2.3,
"passReadingTime": true,
"contrastRatio": 14.25,
"passContrast": true,
"minEdgeMarginPx": 37,
"phoneFontPx": 6.5,
"passMobileWidth": true,
"pass": true
}
],
"reasons": []
}
Binary file added gallery/api-pipeline-code/loop.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gallery/api-pipeline-code/poster.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading