VibesOS cloudflare

Self-contained deploy automation — invoke directly, do not decompose. Deploys a Vibes app to Cloudflare Workers via the Deploy API. Use when deploying, publishing, going live, pushing to production, or hosting on the edge.

install

source · Clone the upstream repo

git clone https://github.com/popmechanic/VibesOS

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/popmechanic/VibesOS "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cloudflare" ~/.claude/skills/popmechanic-vibesos-cloudflare && rm -rf "$T"

manifest: skills/cloudflare/SKILL.md

source content

Plan mode: If you are planning work, this entire skill is ONE plan step: "Invoke /vibes:cloudflare". Do not decompose the steps below into separate plan tasks.

  ╔═══════════════════════════════════════════════╗
  ║   ☁️  CLOUDFLARE WORKERS DEPLOY               ║
  ║   Deploy API · Pocket ID · Edge Functions      ║
  ╚═══════════════════════════════════════════════╝

Deploy to Cloudflare

Deploy your Vibes app to Cloudflare Workers via the Deploy API.

Prerequisites

Assembled HTML file (from
```
/vibes:vibes
```
or
```
/vibes:factory
```
)
Vibes account (browser login on first deploy)

No Cloudflare account or wrangler CLI needed — the Deploy API handles infrastructure.

Quick Deploy

VIBES_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "${CLAUDE_SKILL_DIR}")")}"
bun "$VIBES_ROOT/scripts/deploy-cloudflare.js" --name myapp --file index.html

On first run, a browser window opens for Pocket ID authentication. Tokens are cached for subsequent deploys.

Static Assets: Place images, fonts, or other static files in an

assets/

directory next to the app file. The deploy script auto-discovers and includes them (binary files are base64-encoded). Reference in code with absolute paths like

/assets/logo.png

Deploy with AI enabled

VIBES_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "${CLAUDE_SKILL_DIR}")")}"
bun "$VIBES_ROOT/scripts/deploy-cloudflare.js" --name myapp --file index.html --ai-key "sk-or-v1-your-key"

The

--ai-key

flag configures the OpenRouter API key for the

useAI()

hook. Without it,

/api/ai/chat

returns

{"error": "AI not configured"}

Endpoints

Endpoint	Method	Description
`/registry.json`	GET	Public registry read
`/check/:subdomain`	GET	Check subdomain availability
`/claim`	POST	Claim a subdomain (auth required)
`/api/ai/chat`	POST	AI proxy to OpenRouter (requires AI key)

Important: Custom Domain Required for Subdomains

Workers.dev domains only support one subdomain level for SSL. For multi-tenant apps with subdomains (tenant.myapp.workers.dev), you MUST use a custom domain.

Won't work:

tenant.myapp.username.workers.dev

(SSL error) Will work:

tenant.myapp.com

(with custom domain)

On workers.dev, use the

?subdomain=

query parameter for testing:

```
myapp.username.workers.dev
```
→ landing page

myapp.username.workers.dev?subdomain=tenant

→ tenant app

myapp.username.workers.dev?subdomain=admin

→ admin dashboard

Custom Domain Setup

Add domain to Cloudflare (get nameservers from Cloudflare DNS dashboard)
Point registrar nameservers to Cloudflare's assigned nameservers
Delete conflicting DNS records for the apex domain (A, AAAA, CNAME)
Add Custom Domain in Workers & Pages → your worker → Settings → Domains & Routes → Add → Custom Domain (apex: yourdomain.com)
Add wildcard CNAME in DNS: Name:
```
*
```
, Target:
```
<worker-name>.<username>.workers.dev
```
(Proxied: ON)
Add Route in Workers & Pages → your worker → Settings → Domains & Routes → Add → Route:
```
*.yourdomain.com/*
```

After setup:

```
yourdomain.com
```
→ landing page
```
tenant.yourdomain.com
```
→ tenant app
```
admin.yourdomain.com
```
→ admin dashboard

Troubleshooting

Problem	Cause	Fix
Browser doesn't open for auth	Headless environment	Copy the printed URL and open manually
Deploy API returns 401	Expired or invalid token	Delete `~/.vibes/auth.json` and retry
404 on subdomain URL	Workers.dev doesn't support nested subdomains	Set up a custom domain (see Custom Domain Setup above)
`/api/ai/chat` returns "AI not configured"	Missing OpenRouter key	Redeploy with `--ai-key`
Stale content after redeploy	Browser cache	Hard refresh (Cmd+Shift+R) or clear cache

What's Next?

After successful deployment, present these options:

AskUserQuestion: question: "Your app is deployed! What would you like to do next?" header: "Next steps" options: - label: "Set up custom domain" description: "Configure DNS for subdomain routing (required for multi-tenant)" - label: "Enable AI features" description: "Add OpenRouter API key for the useAI() hook" - label: "Add auth & SaaS features" description: "Transform into SaaS with /vibes:factory, then redeploy" - label: "Open in browser" description: "Visit the deployed URL to verify everything works"