1# Cloudflare Static Assets Skill Reference
2 
3Expert guidance for deploying and configuring static assets with Cloudflare Workers. This skill covers configuration patterns, routing architectures, asset binding usage, and best practices for SPAs, SSG sites, and full-stack applications.
4 
5## Quick Start
6 
7```jsonc
8// wrangler.jsonc
9{
10  "name": "my-app",
11  "main": "src/index.ts",
12  "compatibility_date": "2025-01-01",
13  "assets": {
14    "directory": "./dist"
15  }
16}
17```
18 
19```typescript
20// src/index.ts
21export default {
22  async fetch(request: Request, env: Env): Promise<Response> {
23    return env.ASSETS.fetch(request);
24  }
25};
26```
27 
28Deploy: `wrangler deploy`
29 
30## When to Use Workers Static Assets vs Pages
31 
32| Factor | Workers Static Assets | Cloudflare Pages |
33|--------|----------------------|------------------|
34| **Use case** | Hybrid apps (static + dynamic API) | Static sites, SSG |
35| **Worker control** | Full control over routing | Limited (Functions) |
36| **Configuration** | Code-first, flexible | Git-based, opinionated |
37| **Dynamic routing** | Worker-first patterns | Functions (_functions/) |
38| **Best for** | Full-stack apps, SPAs with APIs | Jamstack, static docs |
39 
40**Decision tree:**
41 
42- Need custom routing logic? → Workers Static Assets
43- Pure static site or SSG? → Pages
44- API routes + SPA? → Workers Static Assets
45- Framework (Next, Nuxt, Remix)? → Pages
46 
47## Reading Order
48 
491. **configuration.md** - Setup, wrangler.jsonc options, routing patterns
502. **api.md** - ASSETS binding API, request/response handling
513. **patterns.md** - Common patterns (SPA, API routes, auth, A/B testing)
524. **gotchas.md** - Limits, errors, performance tips
53 
54## In This Reference
55 
56- **[configuration.md](configuration.md)** - Setup, deployment, configuration
57- **[api.md](api.md)** - API endpoints, methods, interfaces
58- **[patterns.md](patterns.md)** - Common patterns, use cases, examples
59- **[gotchas.md](gotchas.md)** - Troubleshooting, best practices, limitations
60 
61## See Also
62 
63- [Cloudflare Workers Docs](https://developers.cloudflare.com/workers/)
64- [Static Assets Docs](https://developers.cloudflare.com/workers/static-assets/)
65- [Cloudflare Pages](https://developers.cloudflare.com/pages/)
66