Copilot-Skills cloudflare.instructions.md

Cloudflare Instructions

Auto-loaded when: **/*.js, **/*.ts, **/*.tsx, **/*.jsx, **/*.toml, **/wrangler.toml

Default Behaviors

When working with Cloudflare code:

1. Use Wrangler CLI - The official tool for development
2. TypeScript Recommended - Type-safe development
3. Environment Variables - Use wrangler.toml for config
4. Error Handling - Always catch and handle errors
5. Async/Await - Workers are async by default

Common Workflows

Local Development

# Install Wrangler
npm install -D wrangler

# Create new project
npm create cloudflare@latest

# Local development server
npm run dev

# Deploy
wrangler deploy

Worker Development

export default {
  async fetch(request, env, ctx) {
    try {
      // Your code here
      return new Response('Success');
    } catch (error) {
      return new Response(`Error: ${error.message}`, { 
        status: 500 
      });
    }
  }
};

Environment Configuration (wrangler.toml)

name = "my-worker"
type = "javascript"
account_id = "xxx"
workers_dev = true
route = "example.com/*"
zone_id = "xxx"

[env.production]
route = "example.com/*"

[build]
command = "npm run build"
cwd = "./src"

Using D1 Database

export default {
  async fetch(request, env) {
    const db = env.DB;
    
    // Query
    const { results } = await db
      .prepare('SELECT * FROM users WHERE id = ?')
      .bind(1)
      .all();
    
    // Insert
    await db
      .prepare('INSERT INTO users (name) VALUES (?)')
      .bind('John')
      .run();
    
    return Response.json(results);
  }
};

Using R2 Storage

export default {
  async fetch(request, env) {
    const bucket = env.MY_BUCKET;
    
    // Upload
    await bucket.put('path/file.txt', 'content');
    
    // Download
    const file = await bucket.get('path/file.txt');
    
    // Delete
    await bucket.delete('path/file.txt');
    
    // List
    const files = await bucket.list();
    
    return new Response('Done');
  }
};