@whop/cli 0.26.0 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whop/cli",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "The Whop CLI — build and manage Whop apps from your terminal. Human and agent friendly.",
   "keywords": [
     "agent",

package/skills/whop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: whop
-description: "Run a business on Whop from the `whop` CLI: economic intelligence for business next steps, websites on *.whop.site, products, checkout, payments, ads, LLC/C-corp formation, hiring, and stats. Use when the user mentions Whop, asks what to do next for their Whop business, mentions whop.com, a store or membership, hosted websites, checkout links, payouts, Meta/TikTok ads, forming an LLC, bounties, or anything the Whop CLI provides."
+description: "Run a business on Whop from the `whop` CLI: economic intelligence for business next steps, websites on whop.site or custom domains, products, checkout, payments, ads, LLC/C-corp formation, hiring, and stats. Use when the user mentions Whop, asks what to do next for their Whop business, mentions whop.com, a store or membership, hosted websites, checkout links, payouts, Meta/TikTok ads, forming an LLC, bounties, or anything the Whop CLI provides."
 requires_bin: whop
 command: whop
 ---
@@ -42,7 +42,7 @@ When the caller asks how to grow, improve their business, or decide what to do n
 | --- | --- | --- |
 | Sign in / pick a business | `whop login`, `whop quickstart`, `whop auth account` | — |
 | Find or generate business next steps | `whop economic-intelligence list`, `whop economic-intelligence create` | Find the best next steps above |
-| Ship a website (`*.whop.site`) | `whop apps init --app_type website`, then `whop apps deploy` | [references/websites.md](references/websites.md) |
+| Ship a website (whop.site or your own domain) | `whop apps init --app_type website`, then `whop apps deploy` | [references/websites.md](references/websites.md) |
 | Sell | `whop products create`, `whop plans create`, `whop checkout-configurations create` | — |
 | Customers | `whop members`, `whop memberships` | — |
 | Run ads | `whop media generate`, `whop ads create`, `whop ad-campaigns update` | [references/ads.md](references/ads.md) |

package/skills/whop/references/websites.md

@@ -1,19 +1,21 @@
-# Websites and apps (`*.whop.site`)
+# Websites and apps
 
 Read this before `whop apps init` or `whop apps deploy`. Flag lists live in `whop apps <command> --help` — do not invent them.
 
-`--app_type` is `website` (visitors browse `<route>.whop.site`) or `b2c_app` (creators install it). Ask; do not guess. A website cannot be turned back into an app.
+`--app_type` is `website` (visitors browse it at its domains) or `b2c_app` (creators install it). Ask; do not guess. A website cannot be turned back into an app.
 
 ## New website
 
 ```sh
-whop apps init --app_type website --name "Acme" --route acme
+whop apps init --app_type website --name "Acme" --domain acme
 whop apps deploy
 ```
 
+`--domain` takes a whop.site name (`acme` → `acme.whop.site`) or a domain the account already has. It defaults to the name's whop.site address. A custom domain not yet on the account is bought when it can be registered — this only creates a purchase link, nothing is charged — and otherwise connected by DNS verification. `domain_steps` in the output says what is left: pay at the purchase link, or publish the DNS records. Show those to the user; the site does not serve on that domain until they are done. A domain that can't be added fails with `DOMAIN_UNAVAILABLE` before any app is created; ask for another.
+
 Agents and scripts must pass `--app_type`. Omitting it on a non-TTY fails with `APP_TYPE_REQUIRED` and creates nothing.
 
-`init` registers the app on Whop **before** it writes files. If it fails after that, retry the same flags — do not `create` a second app.
+`init` registers the app on Whop **before** it writes files. If it fails after that, run the `whop apps init --app app_xxx` command the error prints — do not `create` a second app.
 
 `--template app_xxx` only inherits `website` from the template. Any other type still needs an explicit `--app_type`.
 
@@ -26,7 +28,14 @@ whop apps deploy
 
 `pull` requires git. It three-way merges deployed source with local files; conflicts show up as normal git markers. Default pull is the **production** build, not the latest preview. `--build abld_xxx` also needs `--app` (builds do not carry the app id).
 
-Code already on disk, no scaffold: `whop apps create --help`, then `whop apps deploy --app app_xxx`.
+An app that has never been deployed, such as a website created on whop.com, has nothing to pull: `pull` fails with `APP_HAS_NO_SOURCE`. Start its code instead, then deploy:
+
+```sh
+whop apps init --app app_xxx
+whop apps deploy
+```
+
+Code already on disk, no scaffold: `whop apps create --help`, then `whop apps deploy --app app_xxx`. Link with `--app`; never write `whop.app.json` by hand.
 
 ## Deploy, preview, promote
 
@@ -40,7 +49,11 @@ whop apps builds promote abld_xxx
 
 Looks like deploy will scaffold a missing project. Actually it only ships an existing Vite app. Agents get `NOT_A_VITE_APP` with init/pull CTAs — follow those, do not invent a scaffold flag.
 
-The project must be linked (`whop.app.json`) or you must pass `--app`. Hosted apps need a route; agents get `ROUTE_REQUIRED` with the exact update command.
+The project must be linked (`whop.app.json`) or you must pass `--app`. A deploy needs somewhere to serve: any domain on the app — a whop.site address or a custom domain — will do. Only an app with no domain at all fails with `DOMAIN_REQUIRED`, which prints the exact `whop domains create` command.
+
+## Domains
+
+`whop apps get app_xxx` lists the app's `domains` with their status; `base_url` is where visitors land. Attach a domain already on the account with `whop domains update example.com --website '{"app_id":"app_xxx"}'`. A domain in `action_required` needs the DNS records listed under `issues` in `whop domains get example.com`; after they are added, run `whop domains check example.com`.
 
 The app must use the `whop()` Vite plugin (`@whop/cli/vite`). Missing it fails with `NO_BUILD_ARCHIVE`.