@moneydevkit/create 0.3.0 → 0.3.1

package/README.md

@@ -2,22 +2,33 @@
 
 Developer onboarding CLI for Money Dev Kit. This package publishes the interactive `npx @moneydevkit/create` flow that provisions API keys, webhook secrets, and a Lightning mnemonic for local development.
 
-## Local Development
+## Getting Started
+
+1. Run `npx @moneydevkit/create@latest` from the root of your project. The CLI walks you through login, webhook verification, and writes your secrets to `.env.local` (or a path you pick) while also copying them to the clipboard by default.
+2. Follow the prompts. When you reach your editor again, `MDK_ACCESS_TOKEN`, `MDK_WEBHOOK_SECRET`, and `MDK_MNEMONIC` are ready to go.
+
+### Customize the flow with flags
+
+Pass any of the options from the table below to skip prompts or run non-interactively (add `--json` for machine-readable output). Example:
 
 ```bash
-npm install
-npm run dev          # watch mode via tsup
-npm run build        # produce dist/ bundle + types
-npm run run:local    # talk to a dashboard at http://localhost:3900
+npx @moneydevkit/create@latest \
+  --dir ./apps/storefront \
+  --env-target .env.production \
+  --webhook-url https://example.com/webhooks/mdk \
+  --project-name "Storefront" \
+  --no-open --no-clipboard
 ```
 
-## Releasing to npm
+### Manual login (optional)
 
-1. Bump the version in `packages/create/package.json` (for example: `npm version 0.2.0 --workspace packages/create --no-git-tag-version`) and commit the resulting `package-lock.json` change.
-2. Push the commit, then create a GitHub release (or annotated tag) named `create-vX.Y.Z` that matches the new version string.
-3. The `publish-create` workflow will detect that tag, run the build, and execute `npm publish packages/create --access public` using the repo’s `NPM_TOKEN`.
+You can reuse an existing dashboard session instead of waiting for device auth:
 
-Once that workflow succeeds, `npx @moneydevkit/create` automatically downloads the freshly published build.
+1. Sign into https://moneydevkit.com in the browser and keep the tab open.
+2. Copy the `better-auth.session_token` cookie (`name=value`).
+3. Run `npx @moneydevkit/create@latest --manual-login "better-auth.session_token=..." --webhook-url https://yourapp.com --no-open` (combine with `--json` for scripts).
+
+The CLI still creates a device code but immediately authorises it using your cookie, then prints the same outputs as the interactive flow.
 
 ## What the CLI does
 
@@ -26,28 +37,6 @@ Once that workflow succeeds, `npx @moneydevkit/create` automatically downloads t
 3. Polls until the dashboard authorises the device, then provisions an API key + webhook secret, and generates a mnemonic locally via BIP-39.
 4. Shows an env diff, writes `.env.local` (or a user-specified file), and optionally copies secrets to the clipboard.
 
-### Running headlessly (for LLMs/automation)
-
-Manual mode still uses the device-auth flow—the only difference is that you reuse an *existing* dashboard session instead of waiting for a browser round trip. The steps are:
-
-1. **Sign in via the dashboard UI** (browser) and keep the tab open.
-2. **Copy the `better-auth.session_token` cookie** from your browser’s developer tools (Application → Storage → Cookies or the Network panel). Copy the full `name=value` pair.
-3. **Pass that cookie to the CLI** using `--manual-login`. Example:
-
-```bash
-SESSION_COOKIE='better-auth.session_token=eyJhbGciOiJI...'
-
-npx @moneydevkit/create \
-  --base-url http://localhost:3900 \
-  --dir /tmp/mdk-demo \
-  --env-target .env.local \
-  --webhook-url https://example.com \
-  --manual-login "$SESSION_COOKIE" \
-  --json --no-open --no-clipboard
-```
-
-The CLI still requests a device code, immediately authorises it using the provided cookie, and emits a JSON payload containing the secrets plus the env-file path—no username/password ever touch the terminal.
-
 ## Flags
 
 | Flag | Description |
@@ -64,3 +53,20 @@ The CLI still requests a device code, immediately authorises it using the provid
 | `--force-new-webhook` | Force creation of a new webhook even if one already exists for the URL. |
 
 Manual login mode calls `POST /api/cli/device/authorize` with the supplied session cookie. When used with `--json`, pass `--webhook-url` to avoid interactive prompts.
+
+## Local Development
+
+```bash
+npm install
+npm run dev          # watch mode via tsup
+npm run build        # produce dist/ bundle + types
+npm run run:local    # talk to a dashboard at http://localhost:3900
+```
+
+## Releasing to npm
+
+1. Bump the version in `packages/create/package.json` (for example: `npm version 0.2.0 --workspace packages/create --no-git-tag-version`) and commit the resulting `package-lock.json` change.
+2. Push the commit, then create a GitHub release (or annotated tag) named `create-vX.Y.Z` that matches the new version string.
+3. The `publish-create` workflow will detect that tag, run the build, and execute `npm publish packages/create --access public` using trusted publishing.
+
+Once that workflow succeeds, `npx @moneydevkit/create@latest` automatically downloads the freshly published build.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moneydevkit/create",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Interactive CLI for bootstrapping Money Dev Kit credentials.",
   "type": "module",
   "bin": {
@@ -50,9 +50,10 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/moneydevkit/nextjs.git",
+    "url": "git+https://github.com/moneydevkit/mdk-checkout.git",
     "directory": "packages/create"
   },
+  "homepage": "https://github.com/moneydevkit/mdk-checkout/blob/main/packages/create/README.md",
   "publishConfig": {
     "access": "public"
   },