dmitrykurash/holospot
Media & DesignDrop-in three.js materials for physically accurate holographic foil, glitter and volume holograms, designed to be wired up by an AI agent.
What it does
holospot brings the holographic foil look of trading cards, glitter stickers and security holograms into ordinary three.js scenes. Instead of faking the rainbow with a moving gradient, it solves, per pixel and per wavelength, how fine surface grooves bend light from each lamp; the sparkle comes from individual flakes and facets catching light at their own angles, and volume holograms replay a recorded 3D subject.
The kit ships seven materials — Prism Rainbow, Gold Shatter, Nebula Glitter, Sky Sparkle, Gilded Vortex, Volume Hologram and Foil Emboss — each with plain-language settings for tint, grain, shine and wear. It targets web 3D work: product models, cards that tilt with the cursor, logos and short rendered videos. The engine is holo.spot's own code, copied unchanged, and the repository runs a pixel comparison against the website to keep them in sync same-code note.
Quick start
Requirements: Node.js 22.18 or newer and a three.js scene (r170+).
git clone https://github.com/dmitrykurash/holospot.git
cd holospot
npm install
npx vite
Open the card recipe and the other pages under recipes/ — each is a complete, copyable example covering applying a material to a mesh, embedding one holographic object in an existing scene, dragging in a .glb, pointer-tilting cards, paper cards with stickers, volume holograms, transparent canvases and video turntables.
Integration is three calls on a normal scene:
import { Holo } from "holospot";
const holo = new Holo(renderer);
holo.apply(mesh, { material: "nebula", sizeMm: 120 });
renderer.setAnimationLoop(() => holo.render(scene, camera));
The holographic object is composited into your existing render, so other objects, lights and tone mapping still draw normally. For a single page, load dist/holo.js from the jsDelivr build through an import map instead of installing.
To tune a look visually, open holo.spot, adjust material, lights and colours, press the Copy settings button, then hand the pasted settings to your agent or pass them as settings.
Agent-oriented workflow
The repository is written to be used through a coding agent: give it the repo, describe the desired result in plain words, and let it copy files, run the page and check a screenshot. AGENTS.md is the one-page manual the agent starts from, and it is readable by people too. Three inputs improve results: real-world object size (sizeMm), a material name or description, and whether the page is dark or light.
Constraints
- Lighting is fixed to a studio rig. The object is lit by its own studio lights rather than your scene's lamps; those lights can be moved and changed, but the look depends on them.
- Heavy graphics. Tuned on a recent laptop; there are three quality levels and phones should use the lowest. Test on the devices you care about.
- WebGL only. It requires
THREE.WebGLRenderer; the WebGPU renderer is not supported. - Bring your own models. No 3D models are included apart from the seven small hologram subjects; the site's animated scenes (wind-blown flag, pullable cloth, peelable stickers) are not part of the kit.
- Design site is optional. Nothing loads from holo.spot at runtime; it is only a place to design settings.
Licensed MIT, so commercial use, modification and shipping are allowed as long as the licence text stays with the code licence.
HotRepo's take
holospot entered HotRepo's new-project list for TypeScript on 2026-11-18 with 102 stars and 4 forks reported over a growth window starting 2026-11-17, and it has no recorded GitHub daily all-language rank. That is a single short observation window, so it says little about sustained traction. On substance, the unusual bet is the agent-first interface: the repository is documentation and manual for a coding agent as much as a three.js package, and the pixel-comparison test against holo.spot is concrete evidence that the distributed materials match the website rather than a decorative claim.
Troubleshooting
If the foil looks flat or dull, the README suggests giving the object a slow turn or tilt, verifying real-world size and checking the dark-or-light setting. Holographic effects need light and motion to read.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- wesbos/3d-model-anythingTurn an iPhone LiDAR room scan into an editable Three.js scene through an AI coding agent workflow.
- Leonxlnx/athenaionA procedurally generated ancient Greek 3D world in three.js, useful as a reference for code-only scene building and offline rendering.
- AIRzZ90/study-materials-forkA Tauri 2 desktop app for browsing and playing media, with React UI and hls.js playback.
- mromidev/claude-animated-shortsClaude skill for rendering 55–70 second vertical animated story shorts with three.js and Remotion on your own machine.