heyo

Scaffold Next.js projects and Turborepo monorepos with your favorite tools — fast.

Quick Start

npx heyo-cli

Or install globally:

npm install -g heyo-cli
heyo

What it does

heyo walks you through an interactive setup to create a new project:

1. Project name — the directory to create
2. Project type — Single Next.js app or Turborepo monorepo
3. Package manager — pnpm, npm, yarn, or bun
4. Tools — pick from a curated list (always installs latest versions)
5. Scaffold — creates the project, installs packages, writes config files

Available Tools

Tool	Description
shadcn/ui	Accessible components built with Radix UI + Tailwind
Zustand	Lightweight state management
React Hook Form	Performant, flexible forms
Zod	TypeScript-first schema validation
Zod + RHF (resolver)	Zod + React Hook Form with @hookform/resolvers
NestJS (monorepo only)	Progressive Node.js API framework
TanStack React Query	Async state management & data fetching
nuqs	Type-safe search params for Next.js
Motion	Production-ready animation library
Axios	Promise-based HTTP client

Project Structures

Single App

my-app/
├── src/
│   ├── app/
│   ├── lib/           ← axios client, query client, validations
│   ├── store/         ← zustand store
│   ├── providers/     ← react query provider
│   └── components/
├── package.json
└── ...

Monorepo

my-project/
├── apps/
│   ├── web/           ← Next.js app with your selected tools
│   └── api/           ← NestJS API (if selected)
├── packages/
│   └── ui/            ← shared component library (from Turborepo template)
├── turbo.json
├── package.json
└── ...

Development

git clone <repo>
cd heyo-cli
pnpm install
pnpm run build
node bin/heyo.js

To link it globally during development:

npm link
heyo

License

MIT