next-stack-cli

CLI to scaffold Next.js projects with opinionated defaults.

Usage

npx @be-included/next-stack-cli my-app

You can also skip the project name and the CLI will prompt you:

npx @be-included/next-stack-cli

Skip prompts

Use --yes (or -y) to skip all feature prompts and use defaults:

npx @be-included/next-stack-cli my-app --yes

What's always included

• Next.js 16 + React 19 + TypeScript
• Tailwind CSS v4 with design tokens via CSS variables
• ESLint + Prettier (opinionated config)
• Husky + lint-staged + git-commit-msg-linter
• Framer Motion + clsx
• Button, ButtonLink, Container components
• cn utility
• src/components/ui/, src/features/, src/hooks/, src/utils/ structure

Optional features

| Feature | What it adds | |---|---| | Contentful | GraphQL client, fetchLocalized, codegen.ts, RichTextRenderer, sitemap | | i18n | Middleware, locales.ts, app/[locale]/ structure | | Forms | react-hook-form, Input, FormField, Textarea components | | Resend | sendEmail utility, /api/contact route | | Cookie Consent | CookieBanner component | | Dayjs | Date formatting library |

After scaffolding

cd my-app

# If Contentful or Resend were selected:
cp .env.example .env.local

# If Contentful was selected:
npm run codegen

npm run dev

Publishing

npm run build
npm publish