Document the Superwall CLI and modernize the agent skills docs#249
Merged
Conversation
Adds a full guide for the superwall CLI (npm package `superwall`) and updates every page that referenced the old skills installer. New: Superwall CLI guide (dashboard/guides/superwall-cli) - Install (npm global / npx), login via browser device auth, whoami, logout, orgs, CI auth with --api-key, and real screenshots of the login handshake (terminal + browser) - Workflows: integrate, migrate, review [--fix], doctor, feedback, and the --skill flag with reasons to drive your own agent - Resource commands (bootstrap, apps, products, entitlements, campaigns, paywalls) with scoping and --json conventions - ClickHouse queries with examples verified against live data (sw.events_rep; the README's `transactions` table does not exist) - Raw API verbs, the schema-aware App Store Connect proxy, the skills installer, agent/scripting flags, and telemetry opt-out - Screenshot of a real `superwall review` report on an iOS app Rewritten: Superwall Skill guide - Installer is now `npx superwall skills` (interactive picker, all skills pre-selected; --skill/--force; auto-installed on login) - Documents the three current skills: superwall, superwall-editor, wwdc; the platform quickstart skills no longer exist upstream - Auth section now covers CLI login, replacing the removed sw-api.sh Updated cross-references - Shared vibe-coding page: new CLI section + corrected install command and skill descriptions - Query ClickHouse guide: pointer to `superwall query` - Superwall MCP guide: related link to the CLI guide - Dashboard nav lists the CLI guide after the Skill guide New/edited content is wrapped in temporary yellow review highlights; they are removed in the follow-up commit. Co-Authored-By: Claude Fable 5 <[email protected]>
Strips the yellow <mark> wrappers and review container divs used to flag new content during review. Prose, structure, images, and code examples are unchanged from the reviewed version. Co-Authored-By: Claude Fable 5 <[email protected]>
Corrects agent-facing docs that no longer match the repo: - Dev server runs on port 3000 (was documented as 8293) - `clear:cache` and `.next` are gone; cache clearing is `rm -rf node_modules/.vite` - `generate:llm`, `generate:md`, `copy:docs-images`, and `watch:images` are not script names; images auto-copy via predev/prebuild - The referenced `content/README/AGENTS.md` writing guide does not exist; point authors at existing page conventions instead - Documents the preview-server gotcha: its Cloudflare cache emulation serves the previous build until restarted Co-Authored-By: Claude Fable 5 <[email protected]>
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
superwall-docs | 9e0ca1b | Commit Preview URL Branch Preview URL |
Jul 22 2026, 04:37 PM |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a complete guide for the
superwallCLI and brings the agent-skills docs in line with what actually ships today. Follows up on thenpx superwall skills/npx superwall integratelaunch (superwall.com/skills).New page
dashboard/guides/superwall-cli): install and auth (browser device flow with real screenshots of both halves of the handshake),integrate/migrate/review [--fix]workflows with a realreviewreport screenshot, the--skillplaybook flag and when to use it, resource commands, ClickHouse queries, raw API verbs, the schema-aware App Store Connect proxy, the skills installer, agent/scripting flags (--json,--no-interactive), and telemetry opt-out.Rewritten
dashboard/guides/superwall-skill): installer is nownpx superwall skills(picker with all skills pre-selected;--skill/--force; auto-installed and kept updated bysuperwall login). Documents the three skills that actually exist upstream (superwall,superwall-editor,wwdc); the four platform-quickstart skills were removed from superwall/skills and their old install commands no longer work. The stalesw-api.shsection is replaced with CLI-based auth.Updated
superwall queryas the wrapper for the same API.Notes for reviewers
SELECT count() FROM transactionsexample fails (UNKNOWN_TABLE); the docs use verified queries againstsw.events_repinstead. The README fix belongs in superwall/cli.npx skills add superwall/skillsbecause that is what the editor UI displays today (verified against paywall-next main).--skillplaybook composition.Verification
bun run build(same asbuild:cf) passes; all 64 tests pass;git diff --checkclean.🤖 Generated with Claude Code