Code shaping the world — one line at a time.
The official site for Aurelius Dynamic — a single, self-contained web experience with zero runtime dependencies, plus the TSL node library behind it.
This repository is the production source for the Aurelius Dynamic site: the landing page, four dossier pages, the Shader Lab, the Lab applications deployed on the same domain, and tsl-lib/ — the shared TSL node library the studio's projects draw on.
The landing experience — markup, styling, scripts, fonts, and two three.js r178 builds — is delivered from a single index.html. There is no build step, no bundler, and no CDN.
- WebGPU + TSL hero. The hero renders a live electromagnetic-helix particle field — a Three.js
WebGPURenderercompute pass written in TSL (Three.js Shading Language). Pointer-reactive particles spring-assemble into twin helical strands, rotate into a tunnel the camera flies down, and — flanked by a procedural Sun (granulated photosphere, prominences, flux-rope CMEs) and Earth (continents, storms, aurora-lit night side) — dissolve into a pair of glimmering Dyson swarms in a finale. It scales from ~500k particles on desktop WebGPU to a 100k WebGL2 fallback and 20k on mobile (the HUD readsRENDER // WEBGPU · TSLorWEBGL2 · TSL), respectsprefers-reduced-motion, idles off-screen, and removes itself cleanly if graphics init fails. - Single-file landing page. The complete landing page is one self-contained
index.html; every style, script, font, and the Three.js builds are inlined. No bundler, no CDN, no install. - Privacy by design. The landing page makes no external requests at runtime — no analytics, no cookies, no backend — with one deliberate exception: the hero Earth's storms are painted from a live public weather feed (Open-Meteo), fetched client-side with no key, account, or personal data, falling back silently to a procedural storm pattern if it is unavailable. The contact form opens a pre-addressed email draft. (One honest caveat: the dossier sub-pages still link a Google Fonts stylesheet — see Known gaps.)
- Measured, not asserted. Every node in
tsl-libships with a verified cost on both WGSL and GLSL backends, measured on named hardware. The numbers on this site come fromtsl-lib/docs/REGISTRY.json, not from estimates. - Fully responsive. Layouts, typography, and interactions adapt from mobile through ultrawide displays.
- Interactive by default. A live hero console (try
help,solve <your problem>,helix,ikos, orgalaxy), a simulated three-engine pipeline demo, scrollspy navigation, animated counters, and an engagement-brief form.
| Page | Path | What it is |
|---|---|---|
| Landing | / |
The single-file experience described above |
| Philosophy | /philosophy/ |
How the studio decides what to build and what to claim |
| Capabilities | /capabilities/ |
What is proven today, what is active R&D, what is a future program |
| Case Studies | /cases/ |
Four projects, each written to a different structural angle |
| Roadmap | /roadmap/ |
Near, mid, and long-term sequence — with the reasoning attached |
| Privacy | /privacy/ |
Data practices, primarily for the echoGalaxy app |
The five dossier pages are plain index.html files sharing pages.css, linked relatively so they open correctly from file:// as well as over HTTP.
Working instruments, featured from the landing page's Lab section. The first five are deployed on this domain; PulseMask is hosted from its own repository and linked out to.
| App | Path | What it is |
|---|---|---|
| Shader Lab | /shader-lab/ |
Live TSL material browser — every material compiled in the page, source visible, frame cost attached. Built from tsl-lib by tsl-lib/tools/build-lab.mjs. |
| Electromagnetic Helix Reactor | /helix/ |
Browser-native plasma simulation built around charged-particle dynamics and interactive diagnostics — ~18k macro-electrons under a Boris integrator, Monte-Carlo collisions, live 3D diagnostics, and a dusty-plasma module. Fully self-hosted (React, Babel, and Three.js are vendored in helix/vendor/). |
| IKOS — Iterative Knowledge OS | /ikos/ |
A knowledge-graph runtime rendered four ways — Book, Graph, Terminal, and Orbit — from one living state. Ships as a self-contained bundle with an offline-first service worker; the optional 3D Orbit view loads Three.js modules from a CDN at runtime. |
| echoGalaxy | /galaxy/ |
Free educational universe explorer — planet → star system → galaxy → Local Group — installable PWA, offline after first visit, built on the studio's verified TSL node library. Android TWA package: com.aureliusdynamic.echogalaxy (Digital Asset Links stub in .well-known/assetlinks.json). |
| Aurelius Learn | /learn/ |
Assembly training runtime — a procedure stepped one operation at a time beside a live exploded view of the part being described, with knowledge checks against the same geometry. Every component is a turned profile built through geo-lib, shaded with tsl-lib nodes. Runs on a sample dataset: the figures are illustrative, not measured results, and the authoring pipeline it shows is a storyboard. Source: ZachBach/aureliusLearn. |
| PulseMask | zachbach.github.io/pulsemask | Photo-fitted parametric geometry: one portrait and one interpupillary measurement become thirty named, watertight parts, exported as STL, OBJ or GLB. The geometry engine has no browser dependencies, so the same code runs headless in Node. Published as a wearable-art design study — not a respirator, not protective equipment, not a medical device; its germicidal figures are modelled, never measured. Source: ZachBach/pulsemask. |
Helix, IKOS, echoGalaxy and Learn are deployed build output copied in, not source — edit the upstream project, rebuild, copy the result. The copy step is manual, though Learn's upstream carries a tools/deploy.mjs that does it. echoGalaxy's upstream sets base: './' precisely so one build serves both standalone and from a subdirectory. PulseMask is the exception to the pattern: it is not copied in at all, it is linked, because it is a separate product on its own GitHub Pages deployment.
118 modules under tsl-lib/src/ (materials, pattern, noise, fresnel, ramp, util), consumed two ways: inlined into the landing bundle's Lab section, and vendored one-way into echoGalaxy.
The contract that makes them portable — full rules in tsl-lib/docs/CONVENTIONS.md:
- Nodes import nothing. Every factory takes the TSL namespace as its first argument:
fresnel(TSL, opts). - Domain input is positional, tunables are an options object. Every tunable has a default.
- Nodes never own uniforms and never bake
time. Callers pass both in. - Each module exports
source(), returning the readable snippet the Lab displays — it lives in the same file and changes in the same commit. - Brand colors come only from
src/util/palette.js, never hex literals. - three.js is pinned to r178, the build embedded in the bundle.
tsl-lib/docs/REGISTRY.json is the single source of truth for status, parity, and cost; NODES.md, the Lab badges, and the gallery are generated from it. Modules land in src/ before they are benched, so the registry is the smaller number — see Known gaps.
cd tsl-lib/bench && npm install # once (puppeteer-core)
node run.mjs # full matrix: every node x {webgpu, webgl2}
node tools/gen-docs.mjs # regenerate NODES.md from the registry
node tools/verify-site.mjs after # hero + Lab smoke, both backends, error gateThe site is fully static and requires no tooling.
git clone https://github.com/ZachBach/AureliusDynamic.git
cd AureliusDynamicOpen index.html in any modern browser — that is the entire stack. For a local server that mirrors production paths:
python -m http.server 8000
# then visit http://localhost:8000Never hand-edit index.html. It is generated, and editing it directly breaks the encoding contract. The round-trip is the only supported path:
python tsl-lib/tools/extract.py # decode -> tsl-lib/build/template.html
python tsl-lib/tools/extract.py --check # prove encode(decode(x)) == x byte-for-byte
# ... edit tsl-lib/build/template.html ...
python tsl-lib/tools/pack.py --dry # preview the splice
python tsl-lib/tools/pack.py # write index.htmltsl-lib/build/ and tsl-lib/bench/vendor/ are generated and gitignored — the bundle is the source of truth, including for the embedded three.js builds.
The site is deployed on Vercel from this repository. Pushing to master deploys; the project is git-linked, so no vercel.json or .vercel/ directory is needed and none exists.
CNAME and .nojekyll are inert leftovers from an earlier GitHub Pages setup. They are harmless and kept only so a Pages fallback stays one setting away — they are not evidence of the deploy target.
Stated here rather than left for you to find:
- Sub-pages load Google Fonts. The landing page inlines every face and contacts nobody, but the six sub-pages still link a
fonts.googleapis.comstylesheet, which hands Google the visitor's IP — including on/privacy/, which does not disclose it. The fix is to self-host the three families next topages.css. - The node registry lags
src/. 18 materials have a module but no registry entry and no bench entry, so they are missing from every generated surface —NODES.md, the Lab badges, and the gallery. Registering one means authoring a bench entry and running the bench, not editing a table. - The Android asset-links fingerprint is a placeholder, pending Play Console signup.
Separate products with their own remotes, not deployed from here: echoGalaxy, PulseMask, Electromagnetic Helix Reactor, IKOS, Aurelius Learn.
Actively maintained. Console and pipeline-demo output is a scripted demonstration, not live data — the Lab applications above are the real artifacts.
Released under the MIT License.
Copyright © 2026 Zachary Auerbach, dba Aurelius Dynamic. The Aurelius name, wordmark, and hexagon mark are used for identification and demonstration; no trademark rights are granted.
Solve · Validate · Ship · Repeat