add

Bolt a functional block onto an existing ds-start or compatible Next.js project.

add installs a functional block — end-to-end capability, not a raw component pack — onto an existing app. See Philosophy.

Usage

npx ds-start add <module>

Run from inside a supported Next.js project to install a module. Auto-merges package.json, .gitignore, and .env.schema. Prompts for resolution on file-level conflicts only. Dependencies are not auto-installed.

Best experience on ds-start projects and compatible App Router projects that follow similar conventions.

Available Modules

ModuleDescription
emailTransactional email with Resend and React Email
file-uploadsS3-compatible file uploads with presigned URLs
zustandClient state management with typed stores
formsJSON-driven form renderer with multiple view modes
github-workflowsGitHub Actions CI pipeline
vercel-deployVercel CD pipeline with preview and production deploys

Examples

Email Module

npx ds-start add email

File Uploads

npx ds-start add file-uploads

Zustand State Management

npx ds-start add zustand

Forms Module

npx ds-start add forms

CI Pipeline

npx ds-start add github-workflows

Vercel CD

npx ds-start add vercel-deploy

On this page