Cloudflare Roadmap
This Cloudflare Roadmap is a free, full-text syllabus of 97 lessons in 18 stages, starting with Workers KV and ending with Development Tools. It suits anyone who wants to learn Cloudflare, whether new to it or filling gaps. There is no fixed length: every lesson is open from the start, so you go at your own pace and skip what you already know.
Last updated
Reading is open to everyone. Sign in to join this roadmap and track what you finish.
Continue learning
1. Workers KVWorkers KV
0%Workers KV
29 topics · 4 sub-topics · 0 completed
The last 24 topics are drawn beside this stage on the original roadmap. Which stage they belong to is not recorded, so they are listed here rather than filed under one.
The diagram draws the same 97 lessons as a map, with lines showing the order. It needs JavaScript; the full syllabus below lists every lesson as text.
Full syllabus: every lesson in the Cloudflare roadmap
18 stages and 97 lessons, in the order the roadmap suggests. Every lesson is free to read and open from the start.
Stage 1: Workers KV
Workers KV
Workers KV is a data storage that allows you to store and retrieve data globally. With Workers KV, you can build dynamic and performant APIs and websites that support high read volumes with low latency.
Key-value Operations
Cloudflare Workers provide a simple API for reading and writing data to a Key-Value store. You can use the put method to store data, and the get method to retrieve it. The delete method allows you to remove data from the store. KV stores are ideal for storing configuration data, user sessions, and other data that…
Metadata Handling
Cloudflare Workers allow you to access metadata about the request, including the request method, URL, headers, and more. You can use this metadata to customize your application's behavior or to implement features like caching, authentication, or rate limiting. Metadata is available in both the fetch event and the…
Bulk Operations
Cloudflare Workers allow you to perform bulk operations on KV stores. You can use the batch method to perform multiple operations in a single request. This is useful for tasks like importing data from an external source or updating multiple records at once. Bulk operations are efficient and scalable, allowing you…
Caching Patterns
Caching is a critical aspect of building performant and scalable applications. Cloudflare Workers provide several caching patterns that you can use to optimize your application's performance. These patterns include:
JavaScript Fundamentals
JavaScript is a versatile, high-level programming language primarily used for adding interactivity and dynamic features to websites. It runs in the browser, allowing for client-side scripting that can manipulate HTML and CSS, respond to user events, and interact with web APIs.
Node.js and NPM
Node.js is an open source, cross-platform runtime environment and library that is used for running web applications outside the client’s browser. It is used for server-side programming, and primarily deployed for non-blocking, event-driven servers, such as traditional web sites and back-end API services, but was…
Basic Command-line Knowledge
Knowing basic command-line commands is a must-have, not when working with Cloudflare but also as a developer. Learn the basics of navigating directories, file management, text editing, package management etc.
TypeScript Fundamentals
TypeScript is a superset of JavaScript that adds static typing. It enhances code maintainability and reduces errors by catching type-related issues during development. For Cloudflare Workers, TypeScript can improve the development experience. You define types for variables, function parameters, and return values,…
HTTP and Web Protocols
Understanding HTTP and web protocols is crucial for leveraging Cloudflare's features. HTTP methods (GET, POST), status codes, headers, and caching mechanisms directly influence how Cloudflare interacts with your application. Cloudflare supports modern protocols like HTTP/2 and HTTP/3, improving performance.…
Understand Serverless Architecture
Serverless architecture allows you to run code without managing servers, and Cloudflare Workers is a key implementation of this. With Cloudflare Workers, you deploy JavaScript/TypeScript functions to Cloudflare's edge network, where they execute in response to HTTP requests. Serverless means you don't provision or…
Git Basics
Git is a distributed version control system designed to handle projects of any size with speed and efficiency. Created by Linus Torvalds in 2005, it tracks changes in source code during software development, allowing multiple developers to work together on non-linear development. Git maintains a complete history of…
Hono
Hono is a small, simple and ultra-fast web framework built on web standards. It works on any JavaScript runtime: Cloudflare Workers, Fastly Compute, Deno, Bun, Vercel, Netlify, AWS Lambda, Lambda@Edge, and Node.js. Hono is more known for supporting a lot more than the basics.
Itty Router
Itty Router is a lightweight router with the motto "less is more" that supports Cloudflare workers and pages. While other libraries may suffer from feature creep/bloat to please a wider audience, Itty Router painfully consider every single byte added to Itty. Our router options range from ~450 bytes to ~970 bytes…
Workers Runtime Environment
The Workers runtime environment is a lightweight JavaScript execution environment running on Cloudflare's edge network. It's based on V8, the same engine that powers Chrome and Node.js, but optimized for speed and security. Workers have limited access to global variables and APIs compared to a traditional Node.js…
Edge Computing Fundamentals
Edge computing brings computation closer to the user, minimizing latency. Cloudflare Workers embodies this: your code runs on Cloudflare's global network of servers, near your users. This reduces network hops and improves response times. By executing logic at the edge, you can personalize content, filter requests,…
Request/Response Handling
Cloudflare Workers excel at intercepting and modifying HTTP requests and responses. When a request hits Cloudflare, a Worker can inspect the request details (headers, URL, method) and take actions: rewrite the URL, modify headers, or even serve a completely different response. Similarly, Workers can intercept…
Fetch API and Runtime APIs
Within Cloudflare Workers, the Fetch API is your primary tool for making HTTP requests to external services or your origin server. It's similar to the Fetch API in browsers but adapted for the Workers environment. Runtime APIs provide access to Cloudflare-specific features like KV storage (for persistent data),…
Workers Lifecycle
A Cloudflare Worker's lifecycle is short and stateless. Each invocation starts when a request hits the Cloudflare edge. The Worker executes its code to handle the request. Once the response is sent (or an error occurs), the Worker instance terminates. There's no persistent state between requests unless you use…
Service Bindings
Service Bindings allow Cloudflare Workers to seamlessly integrate with other Cloudflare services. They provide a secure and efficient way for a Worker to access resources like KV storage, Durable Objects, R2 storage, and other Workers. Instead of using API keys or direct network calls, Service Bindings create a…
Caching Strategies
Cloudflare Workers allow fine-grained control over caching. You can use the Cache API to store and retrieve responses directly within your Worker, bypassing the origin server. Strategies include:
Middleware Patterns
Middleware patterns in Cloudflare Workers allow you to chain functions to process requests or responses in a modular way. Each middleware function performs a specific task (e.g., authentication, logging, header modification) before passing the request/response to the next function in the chain. This promotes code…
Bindings
In Cloudflare Workers, Bindings are configurations that connect your Worker to external resources or services. These can include:
Logging and Monitoring
Effective logging and monitoring are crucial for understanding and debugging Cloudflare Workers. You can use console.log for basic logging during development. For production, consider using a dedicated logging service to collect and analyze logs from your Workers. Cloudflare provides metrics like request counts,…
Any Frontend Framework
Several frontend frameworks can be deployed on Cloudflare Pages or used with Cloudflare Workers. Popular choices include:
Wrangler
Wrangler is the command-line interface (CLI) for Cloudflare Workers. It simplifies the process of developing, testing, and deploying Workers. With wrangler, you can:
Miniflare
Miniflare is a local simulator for Cloudflare Workers. It mimics the Cloudflare Workers runtime environment on your local machine, allowing you to test your Workers without deploying them to Cloudflare. Miniflare supports features like KV storage, Durable Objects, and Service Bindings, making it a valuable tool for…
DevTools Integration
Cloudflare Workers can be debugged using standard browser DevTools. When running Workers in a local environment (e.g., with Miniflare), you can use Chrome DevTools or similar tools to inspect code, set breakpoints, and step through execution. You can also use console.log statements to output information to the…
CI/CD Pipelines
CI/CD (Continuous Integration/Continuous Deployment) pipelines automate the process of building, testing, and deploying Cloudflare Workers. Common CI/CD platforms like GitHub Actions, GitLab CI, and CircleCI can be used to create pipelines that automatically deploy Workers whenever code changes are pushed to a…
Stage 2: R2 Storage
R2 Storage
Cloudflare R2 Storage is a distributed object storage service that offers fast, reliable, and affordable storage without egress fees. It's designed to compete with services like Amazon S3 and Google Cloud Storage. R2 allows you to store large amounts of unstructured data (images, videos, documents) and access it…
Object Storage
Cloudflare R2 is object storage that offers fast, reliable, and affordable storage without egress fees. It's designed to work seamlessly with Cloudflare Workers, allowing you to store and retrieve data close to your users. R2 is ideal for storing static assets, user-generated content, and other data that needs to…
Large File Handling
Handling large files on Cloudflare requires strategies to avoid exceeding size limits and ensure efficient delivery. Techniques include:
Asset Management
Cloudflare R2 can be used for efficient asset management. You can store images, videos, and other static assets in R2 and serve them directly through Cloudflare's CDN. This reduces the load on your origin server and improves website performance. R2's integration with Cloudflare Workers allows you to perform…
Bucket Operations
In Cloudflare R2, buckets are containers for storing objects. You can perform various bucket operations, including:
Bucket Lifecycle
The lifecycle of an R2 bucket involves creation, usage (storing and retrieving objects), and eventual deletion. You create a bucket to house your data. Objects are then uploaded, accessed, and managed within the bucket. Cloudflare doesn't have built-in lifecycle rules like some other storage providers, so object…
Stage 3: D1
D1
Cloudflare D1 is a serverless SQL database designed to run on Cloudflare's edge network. It allows you to store and query data closer to your users, reducing latency and improving application performance. D1 is based on SQLite and is accessible directly from Cloudflare Workers, making it easy to build dynamic and…
Stage 4: Durable Objects
Durable Objects
Cloudflare Durable Objects provide a strongly consistent, single-actor execution environment on Cloudflare's edge network. Unlike Workers, which are stateless, Durable Objects maintain state, enabling you to build applications that require coordination and data consistency across multiple requests and users. They…
State Management
Durable Objects excel at state management. Each Durable Object instance has its own persistent storage and can maintain state across multiple requests. You can store data within a Durable Object and access it consistently, regardless of which Cloudflare edge server handles the request. This eliminates the need for…
Coordination
Durable Objects facilitate coordination between different clients or Workers. Because each object has a single, consistent view of its state, it can act as a central point for coordinating actions. Multiple clients can interact with the same Durable Object, and the object can ensure that actions are performed in a…
Persistence
Durable Objects offer built-in persistence. Data stored within a Durable Object is automatically persisted to Cloudflare's storage infrastructure. You don't need to explicitly save or load data; the Durable Object handles persistence automatically. This simplifies development and ensures that your application's…
Transactional Operations
Durable Objects support transactional operations. You can perform multiple operations within a single transaction, ensuring that either all operations succeed or none of them do. This helps maintain data consistency and prevents partial updates. If an error occurs during a transaction, the Durable Object…
Schema Management
Managing the structure of your database in Cloudflare D1 involves defining tables, columns, data types, primary keys, foreign keys, and indexes using standard SQL Data Definition Language (DDL) statements. Since D1 is based on SQLite, you'll use SQLite-compatible syntax. Tools like wrangler provide commands to…
Migrations
As your application evolves, your database schema will likely need to change. Database migrations provide a structured way to apply these changes in a controlled and repeatable manner. In D1, you'll typically write SQL scripts that contain the necessary ALTER TABLE statements to modify your schema (e.g., adding new…
Query Optimization
Optimizing your SQL queries is crucial for achieving good performance with Cloudflare D1, especially as your database grows. D1 leverages SQLite's query optimizer, which automatically attempts to find the most efficient way to execute your queries. However, you can significantly improve performance by following…
Drizzle
Drizzle ORM is a TypeScript ORM (Object-Relational Mapper) that can be used with Cloudflare D1 to provide a type-safe and more developer-friendly way to interact with your database. It allows you to define your database schema using TypeScript code and provides a query builder that helps you construct SQL queries…
Prisma
Prisma is a popular open-source ORM that provides a type-safe database client and migration tools. While not directly compatible with Cloudflare D1 due to its reliance on specific database adapters, Prisma can be used in conjunction with a D1 adapter or a custom data access layer within your Cloudflare Workers.…
Stage 5: Queues
Queues
Cloudflare Queues is a message queuing service that allows you to decouple different parts of your application. It enables you to reliably send and receive messages between Workers or other services. This asynchronous communication is useful for tasks like background processing, handling spikes in traffic, and…
Message Processing
With Cloudflare Queues, message processing involves sending messages to a queue from a producer (usually a Worker) and then consuming those messages from the queue by a consumer (another Worker or service). The consumer processes each message, performing tasks like data transformation, calling APIs, or updating…
Background Jobs
Cloudflare Queues are ideal for handling background jobs. Instead of performing time-consuming tasks directly within a request/response cycle, you can enqueue a message describing the task. A separate Worker, acting as a consumer, then processes these messages in the background. This improves the responsiveness of…
Rate Limiting
Cloudflare Queues can be used to implement rate limiting. Instead of directly processing every request, you can enqueue them. A consumer Worker then processes messages from the queue at a controlled rate. This prevents your backend systems from being overwhelmed by sudden spikes in traffic. You can adjust the…
Dead Letter Queues
Dead Letter Queues (DLQs) are an important part of a robust message queuing system. In Cloudflare Queues, a DLQ is a separate queue where messages that cannot be processed successfully after multiple retries are sent. This allows you to isolate problematic messages and prevent them from causing continuous failures.…
Stage 6: Workflows
Workflows
Cloudflare Workflow allows you to automate tasks and orchestrate different Cloudflare services through a visual, no-code/low-code interface. You can create workflows that trigger based on various events (e.g., HTTP requests, scheduled triggers) and perform actions such as modifying HTTP headers, routing traffic, or…
Stage 7: Workers AI
Workers AI
Cloudflare Workers AI allows you to run AI inference directly on Cloudflare's global network, close to your users. This eliminates the need to send data to centralized AI servers, reducing latency and improving performance for AI-powered applications. You can use Workers AI to perform tasks like image recognition,…
Text Generation
Workers AI allows you to perform text generation tasks directly on Cloudflare's edge network. You can use pre-trained models or fine-tune your own models to generate text for various purposes, such as content creation, chatbot responses, or language translation. Running text generation at the edge reduces latency…
Image Processing
Workers AI allows you to run AI models directly within Cloudflare Workers, enabling powerful image processing capabilities at the edge. You can use Workers AI to perform tasks such as:
Speech Rcognition
You can use Workers AI to run speech-to-text models directly on Cloudflare's edge network, enabling real-time transcription of audio data. This can be useful for applications like voice search, voice commands, and live captioning.
AI Model Integration
Workers AI provides the ability to run AI models directly on Cloudflare's edge network for recognition tasks. This includes image recognition (identifying objects or scenes in images) and natural language understanding (analyzing text for sentiment, intent, or entities). By performing AI model recognition at the…
Stage 8: Vectorize
Vectorize
Cloudflare Vectorize is a vector database that lets you store and query high-dimensional vectors, often used in machine learning for tasks like similarity search and recommendation engines. By using Vectorize with Workers AI, you can build applications that perform real-time AI-powered searches and recommendations…
Vector Embeddings
Cloudflare Vectorize allows you to store and query high-dimensional vectors, often used in machine learning for tasks like similarity search and recommendation engines. By using Vectorize with Workers AI, you can build applications that perform real-time AI-powered searches and recommendations directly on…
Similarity Search
Cloudflare offers Vectorize, a vector database, which enables similarity search. You can embed data (text, images, audio) as vectors and then use Vectorize to find the most similar vectors based on a query vector. This is used for recommendation systems, content discovery, and other applications where finding…
AI-powered Search
You can build AI-powered search using Cloudflare Workers, Workers AI, and Vectorize.
Stage 9: Stream
Stream
Cloudflare Stream is a video streaming platform that makes it easy to upload, encode, and deliver videos globally. It handles all the complexities of video streaming, including encoding for different devices and network conditions, providing a reliable and high-quality viewing experience. Stream integrates…
Video Delivery
Cloudflare Stream provides a comprehensive solution for video delivery:
Live streaming
Cloudflare Stream supports live streaming. You can use tools like OBS Studio or Wirecast to stream video to Cloudflare, and Stream will handle the encoding, distribution, and playback. This allows you to easily broadcast live events to a global audience.
Video Processing
Cloudflare offers video processing capabilities through Stream and Workers:
Stage 10: Images
Images
Cloudflare Images provides comprehensive image optimization and delivery services. It automatically resizes, converts, and optimizes images for different devices and browsers, improving website performance and reducing bandwidth usage. You can also use Cloudflare Images to store and serve images directly,…
Stage 11: Calls
Calls
Cloudflare Calls is a platform for building real-time audio and video applications directly on Cloudflare's edge network. It provides the infrastructure and APIs you need to create interactive experiences like video conferencing, live streaming, and voice chat, with low latency and global reach.
Stage 12: Tunnels
Tunnels
Cloudflare Tunnel creates a secure, outbound-only connection between your origin server and Cloudflare's network, without opening any inbound ports. This protects your origin from direct attacks and simplifies network configuration. You can use Cloudflare Tunnel to securely expose web applications, APIs, and other…
Stage 14: AI Gateway
AI Gateway
Cloudflare's AI Gateway acts as a central point for managing and optimizing your AI workloads. It provides features like caching, rate limiting, and observability for AI requests, helping you improve performance, reduce costs, and gain insights into how your AI models are being used.
Stage 15: Email Workers
Email Workers
Email Workers allow you to intercept and modify email traffic passing through Cloudflare's email routing service. You can use Email Workers to perform tasks like spam filtering, email authentication, and custom email processing logic, giving you greater control over your email flow.
Routing
In Cloudflare Email Workers, routing refers to directing incoming emails to the appropriate destination or processing logic. Email Workers intercept emails and use defined rules to determine their fate. You can route emails based on sender, recipient, subject, or other criteria. This allows you to forward emails,…
Processing
With Cloudflare Email Workers, processing involves manipulating or analyzing incoming email content. After an email is routed to your worker, you can access and modify various aspects of the email, such as headers, body, and attachments. Processing can include tasks like:
Filtering
In Cloudflare Email Workers, filtering is the process of selectively acting on emails based on specific criteria. It allows you to define rules that determine which emails your worker will process and how. Filtering can be based on various email attributes, including:
Stage 13: Browser Rendering
Browser Rendering
Cloudflare Browser Rendering allows you to render web pages in a headless browser environment on Cloudflare's edge network. This is useful for tasks like generating PDFs, taking screenshots, or pre-rendering content for SEO purposes. By performing browser rendering at the edge, you can offload processing from your…
Stage 16: Security & Performance
Security & Performance
Cloudflare significantly enhances both security and performance through its global network. It provides robust protection against DDoS attacks, bot traffic, and other web threats, while also accelerating website loading times via its CDN and caching mechanisms. By terminating SSL/TLS connections at the edge and…
Workers Security Model
Cloudflare Workers operate within a secure, isolated environment. The Workers runtime enforces strict security boundaries, preventing Workers from accessing sensitive data or interfering with other processes. Workers have limited access to the outside world and must explicitly request resources. Cloudflare's global…
Isolates Architecture
Cloudflare's isolated architecture for Workers relies on lightweight V8 isolates. Each Worker runs in its own isolate, providing strong isolation from other Workers and the underlying infrastructure. Isolates start quickly and consume minimal resources, enabling rapid scaling. This architecture prevents code from…
Web Security Headers
Web security headers are HTTP response headers that enhance website security. Cloudflare allows you to easily configure these headers to protect against common attacks. Key headers include:
Rate Limiting
Cloudflare Queues can be used to implement rate limiting. Instead of directly processing every request, you can enqueue them. A consumer Worker then processes messages from the queue at a controlled rate. This prevents your backend systems from being overwhelmed by sudden spikes in traffic. You can adjust the…
Cache API
Cloudflare's Cache API allows Workers to programmatically control caching behavior. You can store responses in Cloudflare's global cache and retrieve them later, reducing origin server load and improving performance. The Cache API offers fine-grained control over cache keys, expiration, and other parameters. This…
HTML Rewriting
HTML rewriting with Cloudflare Workers enables you to modify HTML content on the fly. You can use Workers to parse HTML, manipulate elements, and inject new content. Common use cases include:
Edge SSL/TLS
Cloudflare's Edge SSL/TLS terminates SSL/TLS connections at Cloudflare's edge network, close to the user. This reduces latency and improves performance compared to terminating connections at the origin server. Cloudflare offers various SSL/TLS options, including:
Bot Management
Cloudflare Bot Management identifies and mitigates malicious bot traffic. It uses machine learning and behavioral analysis to distinguish between human and bot activity. Cloudflare can block, challenge, or allow bot traffic based on its behavior and characteristics. This helps prevent - Credential stuffing, Content…
Stage 17: Integration & Workflows
Integration & Workflows
Workflows refers to the automated processes you can create to manage and respond to various events or conditions. This often involves chaining together different Cloudflare features and potentially integrating with external services. Workflows enable you to automate tasks such as:
Pages Functions
Pages Functions, (now part of Cloudflare Functions), allow you to run serverless code directly within your Cloudflare Pages projects. This lets you add dynamic functionality, like form handling or API endpoints, to your otherwise static sites. They're deployed alongside your static assets and execute on…
Service Bindings
Service Bindings allow Cloudflare Workers to seamlessly integrate with other Cloudflare services. They provide a secure and efficient way for a Worker to access resources like KV storage, Durable Objects, R2 storage, and other Workers. Instead of using API keys or direct network calls, Service Bindings create a…
Inter Worker Communication
Inter-Worker communication enables different Cloudflare Workers to interact and share data. This can be achieved through:
External API Integration
Cloudflare Workers can integrate with external APIs to enrich functionality. You can use fetch() within a Worker to make requests to third-party services. This enables you to:
Webhook Handling
Cloudflare can handle webhooks to trigger actions based on external events. You can configure Cloudflare Workers to receive webhook requests and process the data. This allows you to integrate Cloudflare with other services like GitHub, Slack, or monitoring tools. When an event occurs in the external service, it…
Event-driven Architectures
Cloudflare Workers are well-suited for event-driven architectures. You can trigger Workers based on various events, such as:
Stage 18: Development Tools
Development Tools
- Wrangler: The command-line interface (CLI) is your primary tool for interacting with Cloudflare Workers. It handles project creation, local testing, deployment, secret management, and more. Wrangler simplifies the entire development lifecycle. - Miniflare: This local simulator replicates the Cloudflare Workers…
Wrangler
Wrangler is the command-line interface (CLI) tool for building, deploying, and managing Cloudflare Workers. It simplifies the development workflow by providing commands for creating new projects, testing Workers locally, deploying code to Cloudflare's edge network, and managing secrets. Wrangler automates many…
Miniflare
Miniflare is a simulator for Cloudflare Workers that allows you to test your Workers locally. It mimics the Cloudflare Workers runtime environment, including features like KV storage, Durable Objects, and the Cache API. Miniflare enables rapid iteration and debugging without deploying to Cloudflare's edge network.…
DevTools
While you can't directly use traditional browser DevTools with Cloudflare Workers running on the edge, you can leverage similar debugging principles. Cloudflare offers tools like wrangler tail for real-time logging and the ability to inspect request/response headers. Using console.log strategically within your…
Testing Frameworks
Testing frameworks are crucial for ensuring Cloudflare Workers function correctly. Popular options include Jest, Mocha, and Chai. These frameworks allow you to write unit tests, integration tests, and end-to-end tests for your Workers. You can simulate Cloudflare's environment and test how your Worker responds to…
Monitoring Tools
Monitoring tools provide insights into the performance and health of your Cloudflare applications. Cloudflare offers built-in analytics, but you can also integrate with external monitoring services like Datadog, New Relic, or Prometheus. These tools allow you to track metrics such as:
Debugging Techniques
Debugging Cloudflare Workers involves several techniques:
Questions about the Cloudflare Roadmap
Is the Cloudflare Roadmap free?
Yes. All 97 lessons in this roadmap are free to read on Bibha AI Learning Labs, with no account and no payment. Signing in is optional: it lets you mark lessons as done and keep your progress, and it opens the AI tutor, which runs on your own API key.
How long does the Cloudflare Roadmap take?
There is no fixed duration. It has 97 lessons in 18 stages, and the time it takes depends on how many hours you give it each week. Nothing is locked, so you can skip what you already know, and your progress is saved once you sign in.
Where should I start the Cloudflare Roadmap?
Start with stage 1, Workers KV, and work down in order. The stages are numbered in the order the roadmap suggests, but every lesson is open, so if you already know Workers KV you can go straight to R2 Storage or anything after it. Each lesson links to free resources for going deeper.
Can I learn Cloudflare in Hindi?
The lessons are written in English. Once you sign in, you can ask the AI tutor on any lesson to explain it in Hindi or Hinglish. It answers from that lesson’s own text, so the explanation stays on the syllabus. The tutor runs on your own Google, OpenAI or Anthropic key.