dioramas README

The project's README from github.com/blendi-remade/dioramas. As one markdown file: README.md.

Dioramas

A free, open-source framework for cinematic, interactive 3D websites — with AI-generated hero assets.

Dioramas is a way of building landing pages where the 3D scene is the page: a hyper-detailed object, real lighting, a choreographed camera, and one interaction you can touch. It ships with 20 complete example sites built with it.

Everything is free. No paid tier, no account, no CLI to install.

The twenty examples The twenty examples

The framework

Dioramas is three layers that work together:

1. Asset pipeline — prompt → image → 3D model

Hero objects are generated, not modelled:

  1. Nano Banana 2 (on fal) renders a clean product plate of the object on white.
  2. Meshy 7.1 image-to-3D (on fal) turns it into a 60k–250k-triangle PBR model at 4K geometry (optionally rigged + animated).
  3. scripts/optimize.mjs welds, compresses (meshopt) and converts textures to WebP — a 25 MB raw model becomes 3–8 MB.
cp .env.example .env            # add your FAL_KEY
node scripts/gen.mjs all assets/jobs/<your-job>.json   # images + meshes (resumable)
node scripts/optimize-all.mjs                          # → public/models/<example>/

Every prompt used for the 20 examples is in assets/jobs/ and assets/manifest.json. A textured model costs about $1.20; the whole collection (65 models, 111 images) cost roughly $90.

2. Engine — src/core/

A small three.js layer that makes generated models look expensive: HDR post stack (N8AO ambient occlusion, mip-chain bloom, AgX tone mapping, grain, vignette), raymarched volumetric spotlights, planar reflections with roughness blur, GPU-baked procedural textures, Lenis + GSAP scroll choreography, custom cursor, preloader and cross-site navigation. See docs/ENGINE.md.

3. Method — brief → build → review → revise

Each example started as a one-page brief (docs/briefs/) and was built by an AI coding agent against the engine, then iterated with a headless-GPU screenshot battery (scripts/review.mjs) and a brutal art-direction review until every scroll stop was a composed frame. Hand a brief plus docs/ENGINE.md to your agent to build your own world, or re-theme an example.

The 20 examples

Example Signature interaction
01 Reliquary Explore a dark museum by lantern; photograph relics to light them
02 Abyssal Scroll is an 11 km dive; steer the submersible's floodlights
03 Hammer & Ember Scroll heats a damascus blade; click to strike sparks
04 Bell & Moss Wipe condensation off a glass cloche
05 Still Water A koi pond with real ripple simulation; feed the fish
06 Florae 200k-particle flowers that morph and scatter in your breeze
07 Velocity Lab An X-ray / thermal / CAD lens that sees through a shoe
08 Hangar Nine Press and hold to power up a mech
09 Maison Sucre Real physics with photoreal pastries
10 Monolith Drag the sun across a cliff house
11 Low Frequency Play and scratch a record (synthesized audio)
12 Gambit The Immortal Game replayed on scroll, then free play
13 Atlas of Drifting Isles Fly between floating islands
14 Lithos Press and hold to crack a geode open
15 Artemis Scroll to walk a rigged astronaut on the Moon
16 The Keeper Aim a lighthouse beam through a storm
17 Kōen One bonsai through four seasons
18 Nocturne A perfume bottle with sloshing liquid
19 Nightshift Motor Co. Hold to rev a café racer in the rain
20 Aurel Horologie Take a watch movement apart

Run it

git clone https://github.com/blendi-remade/dioramas && cd dioramas
npm install
npm run dev        # http://127.0.0.1:5190 — the gallery; each example at /examples/<name>/

Models ship in the repo (plain git, ~330 MB, no LFS). A desktop GPU is recommended; everything is tuned for 60 fps.

Layout

examples/<name>/   the 20 example sites (index.html, main.js, style.css)
src/core/          the engine
src/index/         the gallery
scripts/           asset pipeline + QA (gen, optimize, shot, review, thumbs)
assets/jobs/       every prompt used to generate the assets
public/models/     optimized GLBs     docs/   engine guide, briefs, media

License

Code is MIT. Generated models and images are released under CC BY 4.0 — see ASSET-LICENSES.md. Third-party libraries keep their own licenses — see THIRD_PARTY_NOTICES.md.

dioramas (blendi-remade/dioramas)

Searching Database…

这是什么?Dioramas 是一个免费开源的框架,用于构建电影感、可交互的 3D 网站——3D 场景本身就是页面:一个精细的物体、真实的光照、编排好的运镜,外加一处可触摸的交互。它附带 20 个用该框架构建的完整示例站点。
Dioramas 是模板包,还是真正的框架?它是一个由三层组成的框架:把提示词变成 3D 模型的资产管线、以电影化方式渲染它们的 three.js 引擎,以及用于创建 20 个内置示例的“简报-构建-评审”工作流。
怎么让 Dioramas 站点跑起来?克隆仓库——生成的 3D 模型已经以普通 git 形式包含在仓库里(约 330 MB,无 Git LFS),不需要单独下载,也不用通过 CLI 安装。然后直接打开 20 个示例站点之一即可。
使用它需要 fal API 密钥吗?运行内置示例不需要,因为它们的模型已预先生成并打包在仓库里。只有当你想自己生成新的主视觉资产时,才需要用于 Nano Banana 2 和 Meshy 7.1 的 fal 账号。
流畅运行这些站点需要强大的 GPU 吗?需要,建议使用桌面级 GPU,因为每个场景都以 60 fps 为目标进行调优,而且仓库本身是一个约 330 MB 的庞大克隆,没有 LFS。
生成一个主视觉资产要花多少钱?通过 fal 的 Nano Banana 2 和 Meshy 7.1,每个带贴图的模型约 1.20 美元;完整的 20 个示例共 65 个模型和 111 张图片,总花费约 90 美元。
引擎自带哪些渲染效果?three.js 引擎包含 HDR 后期处理栈(环境光遮蔽、泛光、AgX 色调映射、颗粒、暗角)、光线步进的体积聚光灯、带粗糙度模糊的平面反射、GPU 烘焙的程序化纹理,以及 Lenis+GSAP 滚动编排。
这 20 个示例站点实际是怎么做出来的?每一个都始于一页简报,由 AI 编程代理基于该引擎构建,然后通过无头 GPU 截图评审脚本和多轮美术指导反复打磨,直到每个滚动停顿点都成为一幅构图完整的画面。
可以不用现成示例、构建自己的 3D 站点吗?可以——把你自己的简报连同 docs/ENGINE.md 交给编程代理,从零构建一个新场景,或者给 20 个内置示例中的某一个重新定主题。
Size
299.4 MB
Stars
371
Updated
CommitSep 30
Age
20d
Commits · 90 Days