Install the plugin
Download the free plugin zip, then in wp-admin go to Plugins → Add New → Upload Plugin, choose the zip, and activate. (A WordPress.org listing is in review and this page will update once it is live.) The plugin works on WordPress 6.9 and up; WordPress 7.0 (May 20, 2026) is required for dsgo.ai.prompt() and the in-admin Riff builder. Ability consumption depends on the site's Abilities API availability and degrades when the API or a named ability is absent.
Once activated you’ll see DSGo Apps in the wp-admin sidebar.
Which paths work on which plan?
| Path / feature | Free | Pro | Studio |
|---|---|---|---|
| Path A, upload an HTML artifact in wp-admin | yes, 1 active app | yes, unlimited active apps | yes, unlimited active apps |
| Path B, upload a packaged bundle in wp-admin | yes, 1 active app | yes, unlimited active apps | yes, unlimited active apps |
| Path C, CLI scaffold + deploy from your editor | init only; deploy is Pro | yes, unlimited active apps | yes, unlimited active apps |
| Riff, in-admin AI builder | no | included | included |
Apps-as-Abilities publishing ( abilities.publishes) | installs, inactive | active | active |
| Scheduled jobs / webhook endpoints | installs, inactive | active | active |
Live dynamic routes ( wp:posts, wc:products) | installs, inactive | active | active |
Multi-site CLI deploy ( --sites=a,b,c) | no | Studio tier | included |
| White-label | no | no | included |
Free installs as many bundles as you want via wp-admin upload but only one is active at a time (switchable per app in the apps list). Pro-only runtime declarations can be installed on Free, but the gated behavior stays inactive until a Pro license or trial is active. See pricing →
Path A, Upload an artifact (no terminal)
You downloaded a Claude, ChatGPT, v0, or static HTML artifact. Install it without leaving wp-admin:
- WordPress admin → DSGo Apps.
- Use the first-run chooser to install the starter app, or stay on Upload artifact and drop your
.htmlor static.zip. - Confirm the app ID and display name, then install.
- Use the success actions to open the app, copy the URL, embed it in a post, or make it your site’s home page.
To uninstall, hover the row in Installed apps and click Delete.
Path B, Upload a packaged bundle
If you have a built bundle with a dsgo-app.json manifest, choose Upload bundle on the DSGo Apps screen, drop the zip, review the capability list, rendering mode, and network policy, then approve the install.
Path C, Use the CLI
Recommended for iteration speed. You’ll use @designsetgo/cli. The CLI is open and apps init works locally, but CLI deploy to a site is a Pro feature; the server gates Application-Password installs at the plan boundary. Free covers 1 active app via the wp-admin upload paths (Path A and Path B).
Want your AI agent to know all this without reading the page?
npx skills add DesignSetGo/skills drops five Agent Skills (scaffold, manifest, bridge, CLI, abilities) into Claude Code, Cursor, Codex, or Claude Desktop. The agent loads them on demand, so it can answer bridge and manifest questions before apps init runs. See DesignSetGo/skills.
One-time setup on your site
- Activate the DesignSetGo Apps plugin.
- Generate a WordPress Application Password:
https://your-site.com/wp-admin/profile.php#application-passwords-section - Copy the 24-character value, you’ll see it once.
Scaffold an app
npxnpx @designsetgo/cli apps init my-app
cd my-app Creates a single-file starter ( index.html + dsgo-app.json + CLAUDE.md) with no build step. Add --astro if you want the multi-page Astro project with file-based routing instead, then npm install inside it.
Authenticate
loginnpx @designsetgo/cli apps login You’ll be prompted for the site URL, your WordPress username, and the Application Password you copied. Credentials are stored at ~/.config/designsetgo/credentials.json with 0600 permissions. Run logout to remove them.
Iterate locally
devnpx @designsetgo/cli apps dev Starts a local dev server at http://localhost:3838 with hot reload and a mocked bridge. No WP site needed. Add --bridge proxy --site=https://your-site.com (Pro) to route bridge calls to your real site. File saves reflect in the iframe within 500ms.
Deploy
deploynpx @designsetgo/cli apps deploy --build Runs npm run build, shows you the capabilities the app is asking for, pushes the bundle, and prints the live URL. Re-running deploy updates the existing install, same app id means atomic update.
Preview before going live (Pro): Add --preview to get a shareable URL at /dsgo-preview/slug/token/ without touching the installed-apps catalog. Share with clients, then run --promote <id> to install when they approve. Preview URLs expire after 7 days (configurable with --ttl).
Compatibility
The plugin works on WordPress 6.9 and up. WordPress 7.0 is required for dsgo.ai.prompt() and Riff. Commerce features require WooCommerce. Static routes work on Free; dynamic routes backed by live sources are Pro-gated. When Pro is active, wc:products resolves to an empty list if WooCommerce is inactive.
Trust model matters too: use iframe mode for untrusted bundles or saved artifacts; use inline mode when the app is reviewed, trusted, and needs native SEO, root-mount behavior, or multi-page crawlable routes.
Reference and troubleshooting
The manifest schema, bridge API, CLI commands, permissions, and hosting troubleshooting now live on two dedicated pages.
Manifest
The dsgo-app.json schema: routes, permissions, and claim rules.
Bridge API
Every dsgo.* method, what it returns, and the permission it needs.
CLI commands
Scaffold, deploy, and manage apps from your terminal.
Permissions
What each permission grants and what the install dialog shows.
Caching and CDNs
How DSGo Apps works with page caches, CDNs, and hosting.
Troubleshooting
Fixes for the errors people hit most: REST 401s, CSP rejections, and 404s.
Something missing? Email us. The bridge spec is public; the bridge client and CLI are MIT-licensed on GitHub.