launchframe 0.4.0 → 0.4.2

package/.codex/skills/launchframe/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: launchframe
+description: Scaffold a Next.js app with npx launchframe@latest into the current folder — no CLI arguments required. Invoked as /launchframe.
+argument-hint: ""
+user-invocable: true
+---
+
+# Launchframe
+
+Help the user create a **new** Launchframe project. The CLI is **parameterless**:
+
+```bash
+npx launchframe@latest
+```
+
+It unpacks the full template into the **current working directory** (the folder root where the user runs the command). They should `mkdir`, `cd` into an **empty** folder first.
+
+## What you do
+
+1. Ensure the user has an **empty** directory (no existing `package.json`, `src/`, or `next.config.ts` there). If the workspace is already a Launchframe/Next project, they may only need `/clone-website` instead — clarify.
+
+2. Run exactly:
+
+   ```bash
+   npx launchframe@latest
+   ```
+
+   Optional: `LAUNCHFRAME_SOURCE_URL` and `LAUNCHFRAME_SAAS_IDEA` environment variables in the same shell if they want values pre-filled without editing files later.
+
+3. **Never** run this with the output target **inside** the `launchframe` package directory (the npm-installed template). If the open folder is this monorepo/template, have them `mkdir ../my-app && cd ../my-app` (sibling path), then run `npx launchframe@latest` there.
+
+4. Optional flags (same as CLI): `--dir <path>` to scaffold into another folder instead of cwd, `--skip-install` to skip `npm install`.
+
+5. After it finishes: they should **`npm run dev`** from **that same folder** (no extra `cd` if they scaffolded into cwd). Then they edit **`src/lib/launchframe-config.ts`** for reference URL and SaaS idea, and run **`/clone-website`** with that URL.
+
+## If $ARGUMENTS are present
+
+The user may still paste a URL or idea in chat — **do not** require them for the CLI. Put any extra context into **`src/lib/launchframe-config.ts`** or `launchframe.context.json` for them after scaffold.
+
+## Fallback (local dev only)
+
+From a checkout of this repo: `node bin/launchframe.mjs` with the same empty-folder rules (optionally `--dir` outside the package root).