Take the book with you

Download the introduction and all 28 chapters as one Markdown file. Read it offline, upload it to an AI chat, or add it to your project’s reference files.

Markdown · 1.0 MB · Includes code examples, tables and Mermaid diagram source.

https://architectingoncloudflare.com/downloads/architecting-on-cloudflare.md

Use it with your AI

Upload the downloaded file, or give a tool with web access the book link. Ask it to use the book as a reference and cite the chapter behind its advice. If your tool cannot fetch links, upload the file instead.

The complete book may exceed your tool’s reading or context limit. For a focused question, use the relevant chapter below. Check the introduction’s platform-state note when using advice about pricing, limits or product availability.

For tools that discover content automatically, llms.txt lists the chapters in reading order. llms-full.txt contains the same complete Markdown as the download. These links always serve the version from the latest site build; downloaded copies are snapshots.

Individual chapters

Choose a chapter to open its Markdown file, then save it or pass its link to your tool.

• Introduction

  Decisions, Trade-offs, and Patterns for the Developer Platform

• Chapter 1: The Cloudflare Developer Platform

  What makes Cloudflare architecturally different, and why does it matter?

• Chapter 2: Strategic Assessment

  Should we adopt the Cloudflare Developer Platform, and what are the implications?

• Chapter 3: Workers: The Core Compute Primitive

  How do Workers actually work, and how do I use them effectively?

• Chapter 4: Full-Stack Applications

  How do I build and deploy a full-stack application with server-side rendering and static assets?

• Chapter 5: Local Development, Testing, and Debugging

  How do I develop, test, and debug Workers effectively before deploying?

• Chapter 6: Building with Coding Agents

  How do we use coding agents to explore, build and maintain Cloudflare applications well?

• Chapter 7: Durable Objects: Stateful Compute at the Edge

  How do I build applications that need coordination, real-time updates, or consistent state?

• Chapter 8: Workflows: Durable Execution

  How do I build processes that must complete even if individual steps fail?

• Chapter 9: Queues: Asynchronous Processing

  How do I handle work that doesn't need immediate response?

• Chapter 10: Containers: Beyond V8 Isolates

  What do I do when Workers' constraints genuinely don't fit?

• Chapter 11: Realtime: Audio and Video at the Edge

  How do I build applications with real-time audio and video?

• Chapter 12: Choosing the Right Storage

  Where should I store this data, and what trade-offs am I making?

• Chapter 13: D1: SQLite at the Edge

  Can D1 replace my PostgreSQL/MySQL, and when should I use it?

• Chapter 14: R2: Object Storage Without Egress Fees

  How much can we actually save with R2, and when does it matter?

• Chapter 15: KV and Hyperdrive

  How do I cache effectively and connect to existing databases?

• Chapter 16: The AI Stack on Cloudflare

  Can we build AI-powered applications on Cloudflare, and what's the architecture?

• Chapter 17: Workers AI: Inference at the Edge

  How do I run AI inference, and what are the trade-offs?

• Chapter 18: Building RAG Applications

  How do I build applications that combine search with generation?

• Chapter 19: AI Agents and Advanced Patterns

  How do I build AI agents that can take actions and maintain state?

• Chapter 20: Cost Modelling and Optimisation

  What will this actually cost, and how do we optimise?

• Chapter 21: Observability and Operations

  How do I know what's happening in production and respond to issues?

• Chapter 22: Security, Compliance, and Deployment

  How do we meet security and compliance requirements?

• Chapter 23: Designing for Failure and Recovery

  How do I keep the application useful during a partial failure, and restore correct service afterwards?

• Chapter 24: Architectural Patterns and Reference Designs

  What patterns should I follow for common architectural challenges?

• Chapter 25: Multi-Tenant and Platform Architectures

  How do I build a platform that serves multiple tenants securely and efficiently?

• Chapter 26: When Not to Use Cloudflare

  When is Cloudflare the wrong choice?

• Chapter 27: Migration Playbooks

  How do I move existing workloads to Cloudflare, and when should I?

• Chapter 28: Building on Cloudflare

  The mental models that matter and the path forward

Prefer reading online? Return to the book.