@hype-stack/cli 1.9.0 → 1.11.0

package/README.md

@@ -0,0 +1,85 @@
+# Hype Stack CLI
+
+<p>
+  <a href="https://www.npmjs.com/package/@hype-stack/cli"><img src="https://img.shields.io/npm/v/@hype-stack/cli?color=e8590c&label=npm" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@hype-stack/cli"><img src="https://img.shields.io/npm/dm/@hype-stack/cli?color=e8590c" alt="npm downloads" /></a>
+  <a href="https://github.com/BetterTyped/hype-stack"><img src="https://img.shields.io/github/stars/BetterTyped/hype-stack?style=flat&color=e8590c" alt="GitHub stars" /></a>
+</p>
+
+One command scaffolds a full-stack TypeScript app: React 19 frontend, Hono API, Postgres with Prisma and Kysely, and typed requests end to end. A second command composes features into it: auth, billing, notifications, a mobile app, a browser extension. The code lands in your repo and you own every line of it.
+
+```bash
+npx @hype-stack/cli create my-app
+```
+
+Built on the open-source [Hype Stack template](https://github.com/BetterTyped/hype-stack). See it in action at [hype-stack.dev](https://www.hype-stack.dev).
+
+## Why this instead of a boilerplate
+
+Boilerplates hand you one frozen snapshot. Hype Stack works like shadcn/ui, but for whole features: the CLI copies real source files into your project, runs codemods, merges the Prisma schema, and wires the routes. There is no runtime dependency on us and no npm version to be locked into. Delete what you don't like, rewrite what you do.
+
+- **Typed end to end.** Backend routes in [Hono](https://hono.dev) become a typed frontend SDK through [HyperFetch](https://hyperfetch.bettertyped.com). Rename a field on the server and the frontend fails to compile.
+- **Pick your features.** [Feature packs](https://www.hype-stack.dev/packs) cover auth with organizations, Stripe billing, notifications, file uploads, and more. `compose` resolves their dependencies and installs them together.
+- **Every platform from one codebase.** Web, admin panel, [mobile app](https://www.hype-stack.dev/mobile-app) on Expo, desktop, and a [browser extension](https://www.hype-stack.dev/browser-extension).
+- **Deploys itself.** `hype-stack deploy` ships to Railway or Fly.io, provisions Postgres, Valkey, and a storage bucket, sets env vars, and runs migrations.
+
+## Quick start
+
+```bash
+# Scaffold a new project
+npx @hype-stack/cli create my-app
+
+# Set up env vars and get the start command
+cd my-app
+npx @hype-stack/cli onboard
+
+# Add features when you need them
+npx @hype-stack/cli compose
+```
+
+Prefer starting from a finished app? Browse the [templates](https://www.hype-stack.dev/templates) and install one by id with `npx @hype-stack/cli template <id>`.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `create` | Scaffold a new Hype Stack project from the template |
+| `onboard` | Set up env vars and print the start command |
+| `compose` | Pick feature packs and install them into your project |
+| `template <id>` | Install a full template, with starter and layout swaps on top |
+| `init` | Initialize `stack.json` in an existing project |
+| `deploy` | Deploy web apps and the server, and provision Postgres, Valkey, and a bucket |
+| `deploy mobile` | Build (and optionally submit) the Expo app through EAS |
+| `deploy extension` | Build the browser extension and publish it to the Chrome, Edge, and Firefox stores |
+| `mcp install` | Register the MCP server in your AI editor's config |
+| `login` / `logout` | Authenticate to install packs your organization owns |
+
+Every command has `--help`, and the deploy commands take `--dry-run` to print every step without creating anything.
+
+## What's in the stack
+
+React 19, [TanStack Router](https://tanstack.com/router), Tailwind CSS v4, and shadcn/ui on the frontend. [Hono](https://hono.dev) on the backend with [Prisma](https://www.prisma.io) migrations, [Kysely](https://kysely.dev) queries, Postgres, and Valkey caching. WorkOS auth with sessions and organizations in the SaaS starters. Expo for mobile. Vite, pnpm, and oxc for tooling. The full breakdown is in the [docs](https://www.hype-stack.dev/docs).
+
+## MCP server for AI editors
+
+The CLI ships a [Model Context Protocol](https://www.hype-stack.dev/mcp) server, so Claude Code, Cursor, and other MCP clients can browse packs and compose features into your project directly from the editor:
+
+```bash
+npx @hype-stack/cli mcp install
+```
+
+## Links
+
+- [Website](https://www.hype-stack.dev)
+- [Documentation](https://www.hype-stack.dev/docs)
+- [Feature packs](https://www.hype-stack.dev/packs)
+- [Templates](https://www.hype-stack.dev/templates)
+- [Pricing](https://www.hype-stack.dev/pricing)
+- [Blog](https://www.hype-stack.dev/blog)
+- [Roadmap](https://www.hype-stack.dev/roadmap)
+- [Template source on GitHub](https://github.com/BetterTyped/hype-stack)
+- [X / Twitter](https://x.com/HypeStackDev)
+
+## License
+
+The template and free packs are open source. Paid packs fund maintenance of the whole stack; see [pricing](https://www.hype-stack.dev/pricing) for what each tier includes.