CLI Reference

Commands

driftgrid (no args)

Starts the Next.js dev server and opens the browser.

node bin/driftgrid.js
# → localhost:3000

driftgrid init

Create a new project. Interactive when no args provided.

# Interactive
node bin/driftgrid.js init
 
# Non-interactive
node bin/driftgrid.js init "Acme" "Landing Page" --canvas desktop

Options:

• First arg: client name
• Second arg: project name
• --canvas <preset>: a4-portrait, landscape-16-9, desktop, tablet, mobile, freeform

Creates:

• projects/{client}/{project}/ with 3 concept slots
• projects/{client}/brand/guidelines.md (if new client)
• manifest.json with project metadata

driftgrid doctor

Validate project health. Checks manifests, HTML files, IDs, paths.

node bin/driftgrid.js doctor

driftgrid generate-thumbs

Generate grid thumbnails for all projects.

node bin/driftgrid.js generate-thumbs

Requires Playwright. Thumbnails are cached in .thumbs/ directories.

npm Scripts