Vibe3D

Vibe3D is a source-first model registry for Three.js. It installs models, materials, and their small runtime helpers directly into an application's codebase, where they can be inspected, configured, and changed without an opaque package boundary.

Sci-Fi Kit is the first reference library. The registry is deliberately open: independent authors can publish compatible kits through npm or host the same manifest from another source.

Try the workspace

Requires Bun 1.3+ and Node.js 22.12+.

bun install
bun run dev

The docs app opens the model catalog and gives every model its own interactive Three.js preview. The model viewport contains a portable GLB export action.

CLI

bunx vibe3d init
bunx vibe3d add @scifi-kit/modular-wall
bunx vibe3d add @scifi-kit

init writes models.json and the shared ownership contracts. add resolves registry dependencies, preserves locally edited files by default, and records the installed source hashes in models.lock.json.

Useful inspection commands:

bunx vibe3d view @scifi-kit/modular-wall
bunx vibe3d list wall
bunx vibe3d diff
bunx vibe3d doctor
bunx vibe3d registry validate ./registry.json

Model authoring skill

Install the preview-first hard-surface modeling workflow into a project:

bunx vibe-model
# npm works too
npx vibe-model

The local workspace keeps the canonical skill at .agents/skills/vibe-model. The published package bundles the same files, so the install does not depend on this repository layout.

For source-first WebGPU terrain with game-ready compiled topology caches:

bunx vibe-terrain
# npm works too
npx vibe-terrain

The terrain recipe remains authoritative. The optional compiled representation stores reusable connectivity, domain coordinates, LODs, adjacency, and collision—not a final GLB—and falls back to source generation when its fingerprint does not match.

Workspace

apps/docs/                 Vite, React, TypeScript, and Tailwind docs site
packages/cli/              vibe3d command-line interface
packages/registry/         registry loading, dependency resolution, installer
packages/schema/           models.json, registry, and lock schemas
packages/terrain/          compiled-topology contracts, validation, and cache
packages/vibe-model/       distributable model-authoring skill installer
packages/vibe-terrain/     distributable terrain-authoring skill installer
registries/scifi-kit/      first-party registry builder and npm package
assets/prototypes/         canonical Sci-Fi Kit model sources
src/asset-forge/generator/ shared primitives, materials, batching, and GLB

The complete system design is in docs/vibe3d-architecture.md. The Sci-Fi Kit asset bible starts at docs/README.md.

Build and verify

bun run build
bun run typecheck
bun test

Releases

Published packages are versioned and released with Changesets. Add release intent alongside a package change with:

bun run changeset

The release workflow maintains a version pull request and publishes packages in dependency order after that pull request is merged. See docs/releases.md for the one-time npm setup and the full maintainer workflow.

All Vibe3D packages and the Sci-Fi Kit registry are released under the MIT License.