Skip to content
christianstamatiPublic

About

cstack is a template for full-stack TypeScript apps, plus a CLI that turns it into a new project

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

cs-stack

create-cs-stack starts a new full-stack TypeScript project by handing the setup to Claude Code or Codex. It creates the project folder, writes a bootstrap prompt into it, and opens the agent there. The agent interviews you (structure, toolchain, framework, data layer, auth, deploy target, UI styling), shows a plan, and builds the project only after you approve it, using each tool's official generator.

npx @cs-stack/create my-app

npm create @cs-stack my-app, pnpm create @cs-stack my-app and bunx @cs-stack/create my-app do the same. Any of them asks which agent to use when both are installed:

Bootstrap with:
  [1] Claude Code
  [2] Codex
>

Options

Flag What it does
--agent claude|codex Agent to use. Without it, the CLI asks when both are installed
--model <name> Model passed through to the agent CLI
--defaults Skip the interview and go straight to the plan with the cs-stack defaults
--config <file> Reuse a config.json saved by an earlier run
--pr-agent Add PR-Agent AI pull request review without asking
--no-pr-agent Leave PR-Agent out without asking
-- <args> Everything after -- goes to the agent CLI, e.g. -- --permission-mode acceptEdits

The cs-stack defaults: a Vite+ monorepo on Bun, TanStack Start, Convex with Convex Auth v2 and Google sign-in, shadcn/ui on Base UI, Vercel, plus an example feature, CI, tests and agent docs.

Before starting the agent, the CLI asks whether to add PR-Agent (default: no). On yes, the agent adds a GitHub Action that describes, reviews and suggests committable fixes on every PR, plus a .pr_agent.toml tuned to work like CodeRabbit. It needs an OPENAI_API_KEY repository secret. Without a terminal and without either flag, the agent asks about it instead.

What happens

  1. The CLI checks the folder name is kebab-case and the folder is new or empty.
  2. It records machine facts: OS and which of git, gh, node, bun, pnpm, npm, yarn, docker, claude and codex are installed.
  3. It writes .cs-stack/BOOTSTRAP.md (the prompt with those facts filled in) and, with --defaults or --config, .cs-stack/config.json.
  4. It starts the agent in the new folder with a one-line instruction to read that file. If neither agent is installed, it prints the file's path so you can paste it into any agent.

The agent works in four phases: interview, plan, build (one commit per step), verify (fresh install, check, test, build, dev server responds). At the end it deletes BOOTSTRAP.md and keeps config.json, so the same setup can be run again with --config.

Requirements

Node 20.12 or later, and Claude Code or Codex.

Editing the prompt

The prompt lives in .github/BOOTSTRAP.md. The CLI embeds a copy in src/bootstrap-prompt.ts, which is generated. After editing the Markdown file:

bun run sync-prompt

vp test fails if the two differ, or if the "cs-stack defaults" JSON in the prompt doesn't match what --defaults writes (src/prompt.ts).

Development

bun install
vp check
vp test
bun src/index.ts my-app   # run from source
vp pack                   # build dist/index.mjs, the published bin

Publishing

npm version patch
npm publish

prepublishOnly runs vp check, vp test and vp pack first, so a broken build can't be published.

About

cstack is a template for full-stack TypeScript apps, plus a CLI that turns it into a new project

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages