# Introduction (/docs)



A curated collection of experiments demonstrating what developers can build using the **Cloudflare platform**.

The goal of this repository is to showcase **real-world developer tools and utilities** that run entirely on the **Cloudflare edge**, often without requiring any backend servers or persistent storage.

## What You'll Find Here [#what-youll-find-here]

Each experiment is:

* **Small and focused** - Single responsibility, demonstrating one Cloudflare capability
* **Independently deployable** - Every experiment has its own deploy button
* **Easy to understand** - Clear code structure with TypeScript
* **Fast to run** - Designed to execute in under 60 seconds
* **Click-to-deploy** - One-click deployment to Cloudflare Workers

<Cards>
  <Card title="Quick Start" href="/docs/quickstart">
    Deploy your first experiment in minutes
  </Card>

  <Card title="Philosophy" href="/docs/philosophy">
    Learn why this project exists
  </Card>

  <Card title="Browse Experiments" href="/docs/experiments/ai-website-summary">
    Explore 60+ edge computing experiments
  </Card>

  <Card title="Contributing" href="/docs/contributing">
    Add your own experiments
  </Card>
</Cards>

## Platform Capabilities [#platform-capabilities]

Every experiment demonstrates **practical capabilities of the Cloudflare platform**:

<Cards>
  <Card title="Workers AI">
    Summarization, translation, sentiment, embeddings, image generation, and AI Gateway
  </Card>

  <Card title="Browser Rendering">
    Screenshots, PDF export, readability extraction, and browser automation
  </Card>

  <Card title="Edge Networking">
    DNS lookup, propagation checks, uptime monitoring, CORS testing, and geolocation
  </Card>

  <Card title="HTMLRewriter">
    Web scraping, social preview inspection, parsing, and HTML transformation
  </Card>

  <Card title="D1, KV & Vectorize">
    Edge databases, mock APIs, key-value storage, and semantic search
  </Card>

  <Card title="R2 & Stateful Workers">
    Object storage, change tracking, Durable Objects, Queues, and Cron Triggers
  </Card>
</Cards>

## Experiment Categories [#experiment-categories]

<Accordions>
  <Accordion title="AI & Machine Learning">
    * **AI Website Summary** - Summarize any webpage using Workers AI
    * **AI Website Tag Generator** - Generate topic tags for any website
    * **GitHub Repo Explainer** - AI explanation of GitHub repositories
    * **AI Bot Visibility** - Check if URLs are configured for AI crawlers
    * **Cloud AI Proxy** - Call Workers AI with any model and prompt from one endpoint
    * **Text Translator** - Translate text with Workers AI at the edge
    * **Sentiment Analyzer** - Analyze text sentiment with Workers AI
    * **Text Similarity** - Compare text similarity with Workers AI embeddings
    * **AI Image Generator** - Generate images from text prompts with Workers AI
    * **Speech to Text Transcriber** - Transcribe uploaded audio with Workers AI Whisper
    * **RAG Mini Search** - Grounded Q\&A with Vectorize retrieval and Workers AI
    * **AI Gateway Dashboard** - Workers AI through AI Gateway with cache and latency metadata
  </Accordion>

  <Accordion title="Web Scraping & Parsing">
    * **Website Metadata Extractor** - Extract title, description, Open Graph data, and canonical URL
    * **Website to API** - Turn webpages into structured JSON - **Website to llms.txt** - Convert
      pages for LLM consumption - **DevTools Inspector** - DevTools-style inspection of websites -
      **Dependency Analyzer** - Analyze external resources loaded by a page - **HTML Rewriter** -
      Extract HTML stats and transform pages with HTMLRewriter - **Social Preview Inspector** - Preview
      Twitter/X, Open Graph, and Google snippets side by side - **Readability Extractor** - Extract
      clean article content with readability-style heuristics
  </Accordion>

  <Accordion title="Browser Rendering">
    * **Screenshot API** - Capture screenshots from the edge - **PDF API** - Generate PDF documents
      from any webpage - **Page Metrics** - Collect Puppeteer page load metrics - **Rendered Text** -
      Extract JavaScript-rendered visible text - **Browser Links** - Extract links from
      JavaScript-rendered pages
  </Accordion>

  <Accordion title="Network & Monitoring">
    * **Is It Down** - Check if websites are reachable from the edge - **URL DNS Lookup** - Get DNS
      records for any hostname - **DNS Propagation Checker** - Compare answers from Cloudflare, Google,
      and Quad9 resolvers - **Edge Redirect Simulator** - Trace redirect chains and status codes -
      **Where Am I** - Request metadata and geolocation from the edge - **Response Headers** - Inspect
      HTTP response headers for any URL - **SSL Certificate Inspector** - Inspect TLS certificate
      metadata for a domain - **Multi-PoP Latency Map** - Fetch latency plus serving colo per request -
      **Website Change Tracker** - Scheduled snapshots with R2 storage and D1 diff history - **Uptime
      Monitor Alerts** - Persistent URL monitors with D1 history and email alerts - **CORS Preflight
      Tester** - Simulate browser CORS preflight and analyze response headers
  </Accordion>

  <Accordion title="Edge Platform">
    * **Edge Cache** - Fetch URLs with the Workers Cache API - **Crypto Hash** - Compute SHA digests
      with the Web Crypto API - **WebSocket Echo** - WebSocket echo server on Workers - **Image
      Resizer** - Resize remote images with Cloudflare Image Resizing - **Turnstile Verify** - Verify
      Cloudflare Turnstile tokens via siteverify - **JWT Inspector** - Decode, verify, and issue JWTs
      for experimentation - **Rate Limiter Demo** - Native Workers Rate Limiting binding with 429
      responses - **Webhook Signature Verifier** - Verify HMAC-SHA256 webhook signatures with
      timing-safe compare
  </Accordion>

  <Accordion title="Storage & Data">
    * **R2 Storage** - R2 object storage with list/get/put/delete - **Link Shortener** - URL shortener
      using D1 and KV - **D1 SQL Playground** - Read-only SQL playground over a seeded D1 database -
      **KV Notes** - Simple note storage with Workers KV - **Vectorize Search** - Semantic search with
      Workers AI embeddings and Vectorize - **Presigned R2 Upload** - Presigned PUT URLs for direct
      browser-to-R2 uploads - **API Mock Server** - Define mock HTTP endpoints in KV and serve them on
      demand
  </Accordion>

  <Accordion title="Stateful & Async">
    * **Durable Counter** - Globally consistent counter with Durable Objects
    * **Cron Heartbeat** - Scheduled tasks with Cron Triggers and KV metadata
    * **Task Queue** - Enqueue tasks over HTTP and process them asynchronously
    * **Analytics Engine** - Write custom events to Workers Analytics Engine
    * **Workflows Pipeline Demo** - Durable fetch → AI summarize → R2 pipeline with Workflows
    * **Live Cursor Tracker** - Real-time shared cursors over WebSocket via Durable Objects
    * **Queue Job Visualizer** - Queues producer/consumer with KV job status and simulated retries
    * **DO Alarm Scheduler** - One-off reminders with the Durable Object Alarm API
    * **Webhook Relay Inspector** - Capture inbound webhooks in a Durable Object session for debugging
  </Accordion>
</Accordions>

## Why This Project Exists [#why-this-project-exists]

Most Cloudflare tutorials show very simple examples (Hello World, basic KV counters, simple fetch). This repository focuses instead on **real tools developers would actually want to use**.

Each experiment is production-ready and demonstrates a complete use case that you can deploy, customize, and learn from.

<Card title="Read more about the philosophy" href="/docs/philosophy">
  Learn about the design principles and goals behind this project
</Card>

## Key Features [#key-features]

<Cards>
  <Card title="Independent Deployments">
    Every experiment includes a Cloudflare Deploy Button - deploy a single experiment without
    touching the others
  </Card>

  <Card title="Stateless First">
    Many experiments use edge compute, fetch, and HTML parsing - no persistent storage required
  </Card>

  <Card title="Single Responsibility">
    Each experiment demonstrates one specific Cloudflare capability
  </Card>

  <Card title="Edge-First Architecture">
    Run at Cloudflare's edge in 300+ cities worldwide
  </Card>
</Cards>

## Getting Started [#getting-started]

Ready to explore? Start with the [Quick Start guide](/quickstart) to deploy your first experiment, or browse the experiments by category using the sidebar.

<Callout type="idea">
  Use search with tags like `ai`, `browser`, `network`, or binding names like `d1` and `r2` to filter experiments quickly.
</Callout>

<Callout>
  All experiments are open source and licensed under MIT. Fork, customize, and deploy them for your own use cases.
</Callout>