create-jellybolt

create-jellybolt

CLI that scaffolds a Jellybolt web app using official generators (Next.js or Vite) and adds focused, idempotent recipes: Tailwind v4, Convex, Auth (Clerk/Convex Auth), Stripe, state (React Query/Zustand), shadcn/ui, AI helper files, and a docs/ folder.

Features

• Official scaffolds: Next.js (App Router) or Vite (React + TS)
• Recipes (opt‑in via prompts/flags):
  • Convex backend (+ minimal providers and env hints)
  • Auth: Clerk or Convex Auth
  • Stripe wiring
  • State: React Query or Zustand
  • UI: shadcn/ui
• AI helper files: CLAUDE.md, AGENTS.md, and .cursor/rules/* from templates
• Docs: creates docs/ and copies any files from templates/docs/ (non‑destructive)
• Idempotent changes and safe provider injection

Requirements

• Node.js >= 18.17
• Git (optional; used for init/commit)
• A package manager (pnpm|npm|yarn|bun)

Install & Run

• Build: pnpm build
• Link globally: pnpm link --global
• Run: create-jellybolt (or node dist/cli.mjs)

Note: After publishing, pnpm create jellybolt will work as well.

Usage

Interactive mode asks a few questions and applies the chosen recipes.

create-jellybolt [options]

Options (flags override prompts):

• --dir <name>: target directory
• --framework next|vite (default: next)
• --convex / --no-convex (default: --convex)
• --auth clerk|convex|none (default: none; convex only offered when --convex)
• --stripe / --no-stripe (default: --no-stripe)
• --state react-query|zustand|none (default: none)
• --ui shadcn|none (default: shadcn)
• --ai-files / --no-ai-files (default: --ai-files)
• --ai-template-dir <path>: custom folder for CLAUDE.md, AGENTS.md, and .cursor/rules/*
• --pm <npm|pnpm|yarn|bun>: force a package manager
• --no-install: skip installing deps
• --skip-git: skip git init/commit
• --debug: extra logging

Examples

• Next.js + Convex + Clerk + shadcn + AI files: create-jellybolt --dir my-app --framework next --convex --auth clerk --ui shadcn --ai-files

• Vite + Zustand, no backend/auth/ai: create-jellybolt --dir sandbox --framework vite --state zustand --no-convex --no-stripe --auth none --ui none --no-ai-files

What gets generated

• Tailwind v4 config/imports and @ alias
• Convex (when selected):
  • convex/schema.ts
  • Minimal Convex client and provider wrapper in app/providers or src/providers.tsx
  • Env placeholder in .env.local (NEXT_PUBLIC_CONVEX_URL or VITE_CONVEX_URL)
• Auth (when selected): Clerk or Convex Auth setup hints/integration
• Stripe (when selected): basic wiring and scripts
• State (when selected): React Query or Zustand starter
• UI (when selected): shadcn/ui
• AI helper files (when selected): CLAUDE.md, AGENTS.md, .cursor/rules/*
• Docs (always): docs/ with a starter README.md

Docs seeding (templates/docs)

• Any files in this package’s templates/docs/ are copied recursively into each new project’s docs/ directory.
• No overwrites: existing files in the target project are preserved.
• Include any structure you like (subfolders supported). Example files in this repo:
  • templates/docs/README.md
  • templates/docs/convex_instructions.md

AI templates and tokens (templates/ai)

AI files are rendered from templates and support tokens. Defaults live in templates/ai/ or you can point to your own folder with --ai-template-dir.

Available tokens include:

• FRAMEWORK, AUTH, CONVEX, STRIPE, STATE, UI, PM
• VERSIONS_NEXT, VERSIONS_REACT, VERSIONS_REACT_DOM, VERSIONS_TAILWINDCSS, VERSIONS_CONVEX, VERSIONS_CLERK_NEXTJS, VERSIONS_CLERK_REACT, VERSIONS_STRIPE, VERSIONS_STRIPE_JS, VERSIONS_RQ, VERSIONS_ZUSTAND
• APP_DIR (e.g. app or src/app)
• STACK_LIST — a readable list of the selected stack. Versions are shown only when present in package.json; otherwise items are listed without a version.

Where this is implemented:

• Token build and render: src/recipes/ai.ts
• Template files: templates/ai/CLAUDE.md, templates/ai/AGENTS.md, templates/ai/cursor/*.mdc

Design goals

• Prefer official generators; keep diffs small and safe
• Idempotent writes; avoid clobbering existing files
• Minimal, composable recipes; clear next steps

Contributing / Local dev

• Build: pnpm build
• Run locally without linking: node dist/cli.mjs
• Link globally for create-jellybolt: pnpm link --global