model-x-studio README

The project's README from github.com/ashemag/model-x-studio. As one markdown file: README.md.

Model X Studio

Interactive 3D Tesla Model X studio with a circular display platform, component descriptions, individual-piece isolation, and a progressive explosion slider covering all 334 mesh pieces.

Local development

Requires Node.js 22.13+ and npm.

npm ci
npm run dev -- --port 3015

Vercel

Import this repository into Vercel with the repository root as the project root. The checked-in vercel.json builds the browser application with npm run build:vercel and serves dist/vercel. No environment variables or database are required.

The Vercel entry point reuses the same React page, styles, component library, Three.js scene and local model assets as the existing development app. The original npm run build remains available for the Vinext / Cloudflare output.

Configuration reference: https://vercel.com/docs/project-configuration/vercel-json

Validation

npx tsc --noEmit
node --experimental-strip-types scripts/validate-explosion.mjs
npm run build:vercel

The geometry check verifies 334 distinct layout slots and camera coverage at three viewport proportions. It is not a browser frame-rate measurement.

Model source and scope

The Model X asset is by cgi Moon on BlendKit, used under the BlendKit Royalty Free license. Asset redistribution is subject to that license; this repository is private and the asset is embedded in the application.

This source depicts a pre-refresh Model X, with an unverified exact model year. The 334 pieces are artist-authored mesh islands, not verified Tesla service-part identifiers. Battery, drive units and suspension are illustrative geometry. This is an independent educational project, not a complete OEM parts catalog or a Tesla-affiliated product.

model-x-studio (ashemag/model-x-studio)

Searching Database…

265 ·GitHub
Model-x-studio
这是什么？这是浏览器中的交互式 3D Tesla Model X 工作室：带一个圆形展示平台，配有部件说明、单个零件隔离查看，以及一个可渐进炸开全车全部 334 个网格零件的滑块。
这是可以自定义的配置器，还是只是查看器/浏览器？它是查看器/浏览器，不是配置器：你可以在圆形平台上旋转汽车、单独隔离查看各个部件、拖动滑块渐进炸开全部 334 个零件，没有任何购买或自定义功能。
本地怎么运行？怎么部署？克隆仓库并用 Node.js 运行，本地开发使用 vinext；部署时把仓库原样导入 Vercel 即可，因为仓库内已包含 vercel.json，会用 npm run build:vercel 构建并服务 dist/vercel 目录。
除了 Node 和 npm 还需要别的吗？不需要。你只需要 Node.js 22.13+ 和 npm；Vercel 部署路径不需要环境变量或数据库，因为模型资源已打包在仓库中。
这是准确的 Tesla 零件目录吗？不是。这 334 个零件是美术人员制作的网格孤岛，而不是经过核实的 Tesla 维修零件标识，电池、驱动单元和悬架也只是示意性的几何体。
我可以复用这个 3D 模型资源吗？Model X 模型本身是第三方的 BlendKit 资源，不属于本仓库自身许可证的覆盖范围，因此复用受 BlendKit 条款而非本项目约束。
爆炸滑块到底做什么？拖动它会分阶段把全部 334 个网格零件从底盘逐渐向外拉开，让你看到平时隐藏的内部结构。
这个 3D 模型来自哪里？Model X 网格是 BlendKit 上 “cgi Moon” 制作的付费资源，按 BlendKit 的 Royalty Free 许可使用，直接嵌入应用中，而非来自 Tesla。
我可以部署自己的副本吗？可以：把仓库导入 Vercel 后，它会通过仓库内的 vercel.json 自动构建（npm run build:vercel），或者使用默认的 npm run build 路径生成 Vinext/Cloudflare Workers 输出。
334 个零件的布局是如何验证的？一个几何检查会确认恰好有 334 个不同的布局槽位，并在三种视口比例下都有合适的相机覆盖；它检查的是布局正确性，而不是浏览器帧率性能。
What are similar projects?human-atlas, clay-safari, empire, vistep, RhineLabUI, Jelly-Baby, canvas-ui, blobatar
Which topics is it in?vercel-deployment, shadcn-ui, icons, cloudflare-workers, interactive, threejs, webgl, visualization, vite, component-library, 3d, ui-components
Creator
ashemag
Size
10.3 MB
Stars
265
Updated
CommitSep 04
Age
1mo
Commits · 90 Days