Skip to content

Add the V4D viewer at /v4d/ - #10

Merged
MehranMarxian merged 1 commit into
mainfrom
feature/v4d-viewer
Oct 29, 2026
Merged

MehranMarxian merged 1 commit into
mainfrom
feature/v4d-viewer

Conversation

@MehranMarxian

@MehranMarxian MehranMarxian commented Oct 29, 2026 •

Copy link
Copy Markdown
Owner

What changed and why

Puts the V4D viewer live at https://mehran-ahmadi.com/v4d/. The V4D source repo is private, and GitHub Pages on a private repo needs a paid plan, so this folder holds only the built site.

  • v4d/: the build of apps/viewer from V4D (branch claude/eloquent-thompson-3qaf3u), built with VITE_BASE=/v4d/. It includes the Mixamo walker, the nine presets, the particle looks (colour modes, palettes, grain) and the new edge layout with the new icon.
  • CLAUDE.md: one line under "Where things are", saying v4d/ is a build and shouldn't be edited by hand.
  • CHANGELOG.md: one line.

No existing page, style, script or URL changes. Nothing links to /v4d/ yet, and it isn't in the sitemap.

How it was tested

  • Served the repo root locally (python3 -m http.server 8899) and opened /v4d/?block=walker-2m&preset=STROBE in headless Chromium at 1440 px:
    • the walker model loads from /v4d/models/;
    • there are no 4xx responses and no JavaScript errors;
    • nothing scrolls sideways.
  • Checked the phone layout at 390 px on the V4D side.
  • The site checks only cover root pages and sitemap entries, so v4d/ is outside them. They pass on this PR.
  • In the V4D repo, all 130 unit tests and the typecheck pass.

Risks and follow-ups

  • Size: about 29 MB, mostly the 27 MB ONNX runtime used when you drop in your own video. Its file name only changes when the library version changes, so redeploys won't keep adding another 27 MB copy.
  • Browser support: WebGPU is needed (Chrome, Edge, recent Safari). Other browsers see a short message instead of the viewer.
  • Mixamo licence: the Ch36 character ships as a .glb inside the app. That is normal use inside a project, but it can be downloaded from the site.
  • Redeploying: rebuild in V4D, replace v4d/, and open a new PR.

Suggestions

  1. Add a V4D card to works.html or experiments.html linking to /v4d/, with an OG image cut from the ECHO icon.
  2. Add /v4d/ to sitemap.xml once you're happy with it publicly.
  3. Later, a small script in V4D that builds and copies straight into this repo.

A built copy of the V4D app (private repo): the WebGPU point viewer with the
Mixamo walker, the nine presets, the particle looks and the new edge layout.
Rebuild with VITE_BASE=/v4d/ pnpm build in apps/viewer and copy dist/ here.
@MehranMarxian
MehranMarxian merged commit 5b4de15 into main Oct 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant