vybekiit 0.1.0 → 0.5.0

package/README.md

@@ -1,19 +1,31 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/VybeKiit/vybekiit/main/assets/brand/vybekiit-profile.svg" width="160" height="160" alt="VybeKiit logo">
+</p>
+
 # vybekiit
 
-Scaffold a VybeKiit template into your own repo, then build it by describing what you
-want to your AI coding agent (Claude Code, Codex, or Cursor) — it does the heavy lift.
+Scaffold a VybeKiit kit workspace into your own folder, then build by describing what you
+want to your AI coding agent (Claude Code, Codex, or Cursor). It does the heavy lift.
 
 ## Get started
 
+After you purchase and accept the GitHub invite:
+
 ```sh
-npx vybekiit new web my-app
+npx vybekiit setup
+npx vybekiit create app --web
 ```
 
-This creates `my-app/` from the `web` template. Open the folder in your AI coding tool
-and tell it `"Set up my app."` — the agent reads its instructions and walks you through
-the rest one step at a time.
+Or run `npx vybekiit` in a terminal for the interactive menu.
+
+`create app --web|--mobile|--extension` builds a **kit workspace** (shared pieces + that
+surface), not an app-only folder. Open the folder in your AI coding tool and say
+`"Set up my app."` — the agent walks you through the rest one step at a time.
+
+You do **not** need Download ZIP or the green Code button on GitHub for day-one setup.
 
-Before your first build, install and check the tools your app needs:
+`setup` / `doctor` install and check the full toolchain (agents, `gh`, cloud CLIs, skills,
+assistant tools):
 
 ```sh
 vybekiit doctor
@@ -24,7 +36,7 @@ vybekiit doctor
 | Layer | Tools |
 | ----- | ----- |
 | Agent | `claude` (Claude Code), `codex` (OpenAI Codex), `skills` (platform skills installer) |
-| Base | `gh` (download templates + GitHub login) |
+| Base | `gh` (download kit + GitHub login) |
 | Default cloud | `supabase` (database), `wrangler` (hosting) |
 | When configured | `aws`, `gcloud` (Google sign-in), `vercel`, `eas` + `launch` (mobile) |
 
@@ -35,22 +47,34 @@ doctor installs and checks `gcloud` auth.
 ## Commands
 
 ```
-vybekiit new <template> [directory]   Scaffold a template into your own repo
-vybekiit doctor                       Set up + check the tools your app needs
-vybekiit sync-agent-layer [template]  Refresh agent instructions from the latest mirror
+vybekiit setup                              Welcome + full doctor + next step
+vybekiit create app --web|--mobile|--extension [dir]
+vybekiit doctor                             Full toolchain pass
+vybekiit sync-agent-layer [template]        Refresh agent instructions
 
-  -h, --help       Show help
+  -h, --help       Buyer help
+  --help --all     Full command list
   -v, --version    Show the CLI version
 ```
 
 Examples:
 
 ```sh
-vybekiit new web my-app
-vybekiit new web .
+vybekiit setup
+vybekiit create app --web my-app
+vybekiit create app --mobile
 vybekiit doctor
 ```
 
+`vybekiit new` is deprecated; use `create app` instead.
+
+## Maintainer contract
+
+CLI command cores should return a structured result and let the entrypoint render once. Human output
+goes to the normal terminal renderer; `--json` writes stable JSON to stdout; logs and status messages
+stay on stderr or are suppressed for JSON mode. Prompt code belongs behind the interactive boundary
+(`@clack/prompts`), never inside command core logic.
+
 ### Templates
 
 | Template    | Stack                                  | Status         |
@@ -64,12 +88,13 @@ follows to set up, build, and ship your app.
 
 ## How delivery works
 
-Templates are proprietary and live in private per-template mirror repos; the published
-npm package ships **no** template files. When you run `vybekiit new`, the CLI clones the
-template you've purchased access to using GitHub's `gh` CLI — one browser login, no
-tokens to create or paste. The copied project starts as a fresh repo (the mirror's git
-history is not carried over), and any `@vybekiit/*` workspace dependencies are rewritten
-to pinned npm versions so it builds on its own.
+The paid product lives in gated private repos. The public npm package ships **no** template
+files. When you run `create app`, the CLI uses GitHub's `gh` tool to download the gated
+**kit** workspace (`VybeKiit/kit`: packages + templates), then writes your app folder.
+One browser login via `gh auth login --web` — no tokens to create or paste.
+
+Template-only mirrors (`web` / `mobile` / `extension`) remain for advanced flows; day-one
+buyers always get a kit workspace so shared pieces resolve locally.
 
 If you haven't signed in yet, the CLI tells you exactly what to run:
 `gh auth login --web`. `doctor` installs `gh` for you.

package/dist/bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import {
+  runBinEntrypoint
+} from "./chunk-HFT4CUOY.js";
+export {
+  runBinEntrypoint
+};