Files
dotfiles/dot_agents/skills/cloudflare/references/static-assets
Prad Nukala 6406208b35 shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents
- 16 cross-shell utilities converted to sh/bash chezmoi executables:
  ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone
  ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj
  (ghg-clone not named ghg: unrelated cargo binary owns that name)
- cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho
  cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files
- fish keeps only shell-state functions; converted ones now hit PATH
- cp-appid ignore gating moved to .local/bin path
- dot_agents/skills: 82 skills materialized from dotstate storage so
  dot_claude skill symlinks resolve on fresh bootstrap; dotstate
  profile/symlinks.json released .agents/skills .bashrc .zshrc
2026-08-10 15:15:06 -04:00
..

Cloudflare Static Assets Skill Reference

Expert 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.

Quick Start

// wrangler.jsonc
{
  "name": "my-app",
  "main": "src/index.ts",
  "compatibility_date": "2025-01-01",
  "assets": {
    "directory": "./dist"
  }
}
// src/index.ts
export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    return env.ASSETS.fetch(request);
  }
};

Deploy: wrangler deploy

When to Use Workers Static Assets vs Pages

Factor Workers Static Assets Cloudflare Pages
Use case Hybrid apps (static + dynamic API) Static sites, SSG
Worker control Full control over routing Limited (Functions)
Configuration Code-first, flexible Git-based, opinionated
Dynamic routing Worker-first patterns Functions (_functions/)
Best for Full-stack apps, SPAs with APIs Jamstack, static docs

Decision tree:

  • Need custom routing logic? → Workers Static Assets
  • Pure static site or SSG? → Pages
  • API routes + SPA? → Workers Static Assets
  • Framework (Next, Nuxt, Remix)? → Pages

Reading Order

  1. configuration.md - Setup, wrangler.jsonc options, routing patterns
  2. api.md - ASSETS binding API, request/response handling
  3. patterns.md - Common patterns (SPA, API routes, auth, A/B testing)
  4. gotchas.md - Limits, errors, performance tips

In This Reference

See Also