Skip to content

TODO.md

Latest commit

 

History

History
66 lines (45 loc) · 2.8 KB

TODO.md

File metadata and controls

66 lines (45 loc) · 2.8 KB

Examples cleanup TODO

Tracked issues from the examples audit. See AGENTS.md in this folder for the conventions each example should follow.

Missing README.md

  • resumable-stream-chat/ — add README
  • x402/ — add README

Add frontend + Vite plugin

All examples must be full-stack (frontend + backend). These worker-only examples need a frontend, index.html, vite.config.ts, and src/client.tsx added:

  • email-agent/ — added a full-stack Email Service demo UI
  • mcp-elicitation/ — added landing page with connection instructions
  • mcp-server/ — removed (redundant with mcp-worker/)
  • mcp-worker/ — added MCP tool tester frontend
  • mcp-worker-authenticated/ — added info page with endpoint docs
  • x402/ — added React+Kumo frontend with "Fetch & Pay" UI
  • x402-mcp/ — added React+Kumo frontend with tool forms and payment modal

Vite plugin fix

  • cross-domain/ — add @cloudflare/vite-plugin to existing vite.config.ts (currently uses @vitejs/plugin-react only)

Type declarations

  • x402/ — renamed worker-configuration.d.ts to env.d.ts, regenerated
  • x402-mcp/ — renamed worker-configuration.d.ts to env.d.ts, regenerated

Missing env.d.ts

  • a2a/ — generate env.d.ts with npx wrangler types
  • email-agent/ — generated env.d.ts
  • mcp-worker-authenticated/ — generated env.d.ts

Secrets examples

Standardise on .env / .env.example (not .dev.vars / .dev.vars.example).

  • github-webhook/ — rename .dev.vars.example to .env.example
  • mcp-client/ — renamed .dev.vars.example to .env.example
  • playground/ — renamed .dev.vars.example to .env.example
  • resumable-stream-chat/ — renamed .dev.vars.example to .env.example
  • tictactoe/ — renamed .dev.vars.example to .env.example

SPA routing

Check which full-stack examples with client-side routing are missing "not_found_handling": "single-page-application" in their assets config:

  • codemode/ — audit whether it needs SPA fallback
  • github-webhook/ — audit whether it needs SPA fallback
  • tictactoe/ — no client-side routing, not needed
  • workflows/ — audit whether it needs SPA fallback

Kumo migration

Migrate examples to use Kumo components and Tailwind.

  • mcp/ — migrated from Hello World to full Kumo tool tester
  • mcp-client/ — migrated from custom CSS to Kumo, replaced agentFetch with @callable
  • mcp-worker/ — added Kumo frontend
  • mcp-worker-authenticated/ — added Kumo frontend
  • mcp-elicitation/ — added Kumo landing page
  • x402/ — migrated from worker-only to Kumo frontend
  • x402-mcp/ — migrated from inline HTML to React+Kumo, replaced raw WebSocket with useAgent