create-basis
v2.1.1
Published
CLI to scaffold Next.js projects with Darkroom conventions
Maintainers
Readme
create-basis
CLI to scaffold Next.js apps with Darkroom conventions: typed App Router, Bun, Biome, Tailwind v4, and optional integrations (Lenis, GSAP/Tempus, Sanity, Shopify, HubSpot, Mailchimp, Orchestra HUD, WebGL/Theatre).
Quick start
bunx create-basis my-project
# or
bun create basis my-projectFlags:
--yes/-y— skip prompts, use defaults (Lenis + GSAP, git init)--no-git— skipgit init(only meaningful with--yes)
What it generates
- Next.js App Router + TypeScript with Turbopack and React Compiler enabled
- Tailwind v4 + custom viewport utilities, PostCSS pipeline
- Biome for lint/format; Bun as package manager
- Wrapper + Theme wired for Lenis/GSAP/Tempus;
data-themedefaults todark .env.localprefilled with placeholders for selected integrations
Develop locally (contributors)
bun install # once
bun run dev # watch mode for the CLI
bun run build # outputs dist/cli.js
bun run typecheck # repo-wide TSRelease (workspace package)
- Bump
versioninpackages/create-basis/package.json - From repo root:
npm run publish:create-basis- Runs typecheck + build via prepublish hooks
Links
- Docs:
docs/cli.md - Templates:
packages/create-basis/templates/ - License: MIT © Darkroom Engineering
