deno-deploy

# Deno Deploy Skill (Standalone)

Deploy simple web pages and HTML apps to Deno Deploy using a bundled Python script that calls the Deno REST API directly. No MCP tool required.

---

## Credentials Setup (First Time)

Before deploying, the user must create a **Deno Subhosting organization** and retrieve their credentials:

1. Go to [dash.deno.com/subhosting/new_auto](https://dash.deno.com/subhosting/new_auto) and create a new subhosting org
2. From the org dashboard, copy the **org ID** and **access token**

Then save them as config files under `~/.config/deno-deploy/`:

```bash
mkdir -p ~/.config/deno-deploy
echo "your_token_here" > ~/.config/deno-deploy/access_token
echo "your_org_id_here" > ~/.config/deno-deploy/org_id
```

If these files don't exist, the deploy script will print a clear error with setup instructions. Direct the user to [dash.deno.com/subhosting/new_auto](https://dash.deno.com/subhosting/new_auto) to get started.

---

## Step 1: Plan the App

Before writing code, think about:
- What HTML/CSS/JS is needed?
- Does it need external libraries? (Use CDN links — no npm installs)
- Is it purely static, or does it need a simple backend (e.g., an API route)?

For simple pages: serve everything from a single `main.ts` file with inline HTML.

---

## Step 2: Write Good Deno-Compatible Code

### Standard Pattern

All Deno Deploy apps must export a `fetch` handler:

```typescript
export default {
  async fetch(req: Request): Promise<Response> {
    const html = `<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My App</title>
</head>
<body>
  <!-- content here -->
</body>
</html>`;

    return new Response(html, {
      headers: { "Content-Type": "text/html; charset=utf-8" },
    });
  },
};
```

### Key Rules

- **No Node.js APIs** — no `require()`, no `fs`, no `path`
- **No npm packages** — use CDN links (e.g. `https://cdn.tailwindcss.com`)
- **Single file** —...