Smarthive CLI

shive is Smarthive’s internal project bootstrap CLI.

It is used to create company-standard web apps, mobile apps, backend APIs, and fullstack workspaces with approved architecture, auth foundations, database setup, and shared defaults already wired in.

Use this tool when starting a new project instead of creating apps manually.

Why We Use It

shive exists to make sure new projects start from the same baseline:

• consistent project structure
• approved auth and database patterns
• reusable workspace/package conventions
• standard starter pages and modules
• fewer hand-built one-off setups

The goal is not just speed. The goal is repeatability and internal engineering consistency.

What It Generates

• Web apps: next, react, vite-react
• Mobile apps: expo
• Backend APIs: express, nest
• Fullstack workspaces: web + api + shared packages

Recommended Usage

For most internal work, prefer a preset instead of building a stack manually.

Recommended commands:

shive init --preset next-better-auth-supabase
shive init --preset api-jwt-prisma
shive init --preset saas-dashboard
shive init --preset marketplace-workspace

Use manual flags only when you need to create a stack that does not match an existing preset.

Internal Presets

Core MVP Presets

• next-better-auth-supabase Next.js web starter with Better Auth and Supabase infrastructure.
• expo-supabase Expo mobile starter with Supabase client and secure session storage.
• express-better-auth-supabase Express backend starter with Better Auth and Supabase-backed services.
• nest-better-auth-supabase NestJS backend starter with Better Auth and Supabase-backed services.
• api-jwt-prisma Express API starter with JWT auth and Prisma.
• fullstack-web-api-shared Fullstack workspace starter with web, api, shared, and types packages.

Domain-Oriented Presets

• saas-dashboard SaaS-style web starter with auth pages, dashboard layout, and state/query defaults.
• marketplace-workspace Fullstack workspace baseline for marketplace-style products with shared package structure.

Quick Start

If the CLI is linked locally:

shive list
shive doctor
shive init --preset next-better-auth-supabase

If you want to run it directly from the repo:

node --import tsx src/index.ts list
node --import tsx src/index.ts doctor
node --import tsx src/index.ts init --preset next-better-auth-supabase

To link it locally during development:

pnpm install
pnpm build
npm link

Commands

shive list

Lists:

• supported frameworks
• supported features
• registered presets

Example:

shive list

shive doctor

Runs local CLI diagnostics and reports:

• Node version
• platform
• current working directory
• pnpm availability
• git availability
• missing template registrations

Example:

shive doctor

shive init [type]

Creates a new project interactively or from direct flags.

Supported type values:

• web
• mobile
• api
• fullstack

Examples:

shive init
shive init --preset next-better-auth-supabase --yes
shive init web --framework next --auth better-auth --db supabase-postgres --yes
shive init api --framework express --auth jwt --db postgres --orm prisma --migrate --yes
shive init fullstack --web --api --auth better-auth --db supabase-postgres --yes

init Flags

General:

--preset <preset>
--framework <framework>
--auth <auth>
--db <db>
--orm <orm>
--target-dir <dir>
--project-name <name>
--package-name <name>
--app-name <name>
--primary-color <color>
--database-url <url>
--yes

Install and git:

--install
--skip-install
--git
--skip-git

Database and migration flow:

--migrate
--no-migrate
--seed
--skip-db

Fullstack app selection:

--web
--api
--mobile

Feature flags:

--tailwind
--shadcn
--zustand
--tanstack-query
--auth-pages
--dashboard-layout
--docker
--swagger
--feature <feature...>

Supported Values

Frameworks:

next
react
vite-react
expo
express
nest

Auth providers:

better-auth
supabase
jwt
none

Database providers:

supabase-postgres
postgres
mysql
none

ORM providers:

prisma
drizzle
raw-sql
none

Features:

better-auth
supabase
jwt-auth
prisma
drizzle
tailwind
shadcn
zustand
tanstack-query
dashboard-layout
auth-pages
docker
swagger

Standard Internal Workflows

Create a standard web starter:

shive init --preset next-better-auth-supabase --yes

Create a SaaS-style starter:

shive init --preset saas-dashboard --yes

Create a JWT API starter:

shive init --preset api-jwt-prisma --yes

Create a marketplace workspace baseline:

shive init --preset marketplace-workspace --yes

Create a custom stack manually:

shive init api \
  --framework express \
  --auth jwt \
  --db postgres \
  --orm prisma \
  --migrate \
  --yes

Internal Contribution Workflow

When updating this CLI:

1. Add or update templates under templates/.
2. Register frameworks, features, or presets in src/config/.
3. Keep the generator flow deterministic and config-driven.
4. Add or update tests for the new behavior.
5. Run:

pnpm lint
pnpm test
pnpm build

Ownership

This repository should be treated as internal developer platform infrastructure.

Changes should prioritize:

• maintainability
• predictable project generation
• backward-safe additions to presets/features
• preserving company standards across generated projects

Development

pnpm install
pnpm lint
pnpm test
pnpm build