bsmnt

bsmnt is a CLI for scaffolding basement projects, adding integrations, and installing optional hooks and agent setup.

Overview

• Scaffold new projects from basement starter templates
• Add Sanity to an existing project
• Copy optional hooks into an existing codebase
• Set up supported agent tooling

Templates

| Template | Includes | | --- | --- | | Default | Next.js, React, TypeScript, Tailwind, Biome, and Zustand | | WebGPU | Default stack plus React Three Fiber, Three.js, and 3D/WebGPU-ready setup | | Experiment | Default stack plus creative coding utilities and navigation UI |

Install

Run without installing:

npx bsmnt
bunx bsmnt

Install globally:

npm install -g bsmnt

Usage

Create a new project:

bsmnt
npx bsmnt
bunx bsmnt

Add Sanity to an existing project:

bsmnt integrate --sanity
npx bsmnt integrate --sanity
bunx bsmnt integrate --sanity

Add hooks to an existing project:

bsmnt add
npx bsmnt add
bunx bsmnt add

Skip prompts with flags:

bsmnt create my-app --webgpu --sanity --gsap --claude --no-hooks

Command Summary

bsmnt
bsmnt create [project-name]
bsmnt integrate --sanity
bsmnt add
bsmnt --help

Options

Global

| Option | Description | | --- | --- | | -h, --help | Show help | | -V, --version | Show the CLI version |

create

| Option | Description | | --- | --- | | -d, --default | Use the default template | | --webgpu | Use the WebGPU template | | --webgl | Deprecated alias for --webgpu | | --experiment | Use the experiment template | | --sanity | Add Sanity | | --no-cms | Skip CMS setup | | --gsap | Use GSAP | | --motion | Use Motion | | --no-animation | Skip animation setup | | --claude | Set up Claude Code | | --opencode | Set up OpenCode | | --cursor | Set up Cursor | | --codex | Set up Codex | | --gemini | Set up Gemini CLI | | --no-agent | Skip agent setup | | --no-hooks | Skip hook selection |

integrate

| Option | Description | | --- | --- | | --sanity | Add Sanity to the current project |

add

No command-specific flags currently.

Templates

• Default
• WebGPU
• Experiment

Included Features

• Starter templates
• Optional Sanity integration
• Optional hooks
• Optional agent setup

Local Development

bun install
npm link .

License

ISC