Skip to content

Code-first video & image, rendered natively on WebGPU.

add to examples

okanasl60299abf6f3f
diff --git a/.agent/rules/general-information.md b/.agent/rules/general-information.md
index d3d33080..e12f72cb 100644
--- a/.agent/rules/general-information.md
+++ b/.agent/rules/general-information.md
@@ -31,7 +31,7 @@ Framefields is a code-first video engine on native WebGPU (Dawn) in Node, with n
- `packages/core`: shared types, `Effect` base, signals. Other packages: `renderers`, `media`, `node-sdk` (node authoring: `shared/` + `renderer/`), `server-utils`, `client-utils`, `tensor-webgpu`, `vision`, `tsconfig`.
- `nodes/node-*` (59): one VFX/audio/layout node each. Layout: `src/shared/` (config and schema), `src/renderers/` (WebGPU), `src/index.ts`. Only `node-compositor` has a `SKILL.md`; update it when Compositor behavior changes (`packages/compositions/src/program/skillmd-check.test.ts` guards it).
- `apps/renderer-service`: HTTP render service (Docker, RunPod worker).
-- `examples/NN_*`: reference films/ads that import `framefields` via workspace. Study `19_framefields_film` (best structure), `22_framefields_launch` before writing a new film.
+- `examples/NN_*`: reference films/ads that import `framefields` via workspace. Study `19_framefields_film` (best structure), `22_framefields_launch` (lyric sync), and `28_physics_dancer` (physics, live vision, GPU particles) before writing a new film.
- `plugins/framefields/skills/framefields{,-compose,-effects,-render}`: agent skills, symlinked from `.agents/skills` and `.claude/skills`.
- `examples/22_framefields_launch`: reference for a lyric-driven launch film.
- Package `exports` have a `development` condition pointing at `src/`. Otherwise consumers resolve `dist/`, so run `pnpm build` after changing a dependency.
diff --git a/README.md b/README.md
index 6dc0d8ae..1d297769 100644
--- a/README.md
+++ b/README.md
@@ -30,28 +30,37 @@ Every frame is rendered by framefields directly from TypeScript in [`examples/`]
<table>
<tr>
+ <td width="50%" align="center">
+ <a href="https://youtu.be/POC7rKnuoE4"><img src="assets/showcase/physics-dancer.jpg" alt="Physics dancer showcase film" width="100%"></a>
+ <br><a href="https://youtu.be/POC7rKnuoE4"><b>Physics dancer</b></a>
+ <br><sub><a href="examples/28_physics_dancer"><code>28_physics_dancer</code></a></sub>
+ </td>
<td width="50%" align="center">
<a href="https://youtu.be/k2lgbdL6_TA"><img src="assets/showcase/mac-keyboard.jpg" alt="Mac keyboard from 3D primitives" width="100%"></a>
<br><a href="https://youtu.be/k2lgbdL6_TA"><b>Mac Keyboard</b></a>
<br><sub><a href="examples/26_mac_keyboard_from_3d_primitives"><code>26_mac_keyboard_from_3d_primitives</code></a></sub>
</td>
+ </tr>
+ <tr>
<td width="50%" align="center">
<a href="https://youtu.be/FVXTqAozAv8"><img src="assets/showcase/framefields-launch.jpg" alt="Framefields launch film" width="100%"></a>
<br><a href="https://youtu.be/FVXTqAozAv8"><b>Framefields launch</b></a>
<br><sub><a href="examples/22_framefields_launch"><code>22_framefields_launch</code></a></sub>
</td>
- </tr>
- <tr>
<td width="50%" align="center">
<a href="https://youtu.be/9BF1snfmg3o"><img src="assets/showcase/full-circle.jpg" alt="Full Circle film" width="100%"></a>
<br><a href="https://youtu.be/9BF1snfmg3o"><b>Full Circle</b></a>
<br><sub><a href="examples/21_full_circle"><code>21_full_circle</code></a></sub>
</td>
+ </tr>
+ <tr>
<td width="50%" align="center">
<a href="https://youtu.be/RQ3yi_lzPqI"><img src="assets/showcase/dancer.jpg" alt="Dancer showcase film" width="100%"></a>
<br><a href="https://youtu.be/RQ3yi_lzPqI"><b>Dancer showcase</b></a>
<br><sub><a href="examples/19_framefields_film"><code>19_framefields_film</code></a></sub>
</td>
+ <td width="50%" align="center">
+ </td>
</tr>
</table>
diff --git a/assets/showcase/physics-dancer.jpg b/assets/showcase/physics-dancer.jpg
new file mode 100644
index 00000000..dc4c572c
Binary files /dev/null and b/assets/showcase/physics-dancer.jpg differ