Cloudflare Smart Tools

Modular suite for advanced Cloudflare cache management, edge caching, and flexible CDN routing for modern web applications.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Cloudflare Smart Tools is a comprehensive collection of modules designed to supercharge your Cloudflare setup with advanced caching strategies, edge optimization, and intelligent CDN routing. Whether you're running a WordPress site, building a modern web application, or managing complex CDN requirements, these tools provide the flexibility and power you need.

Modules

• CF Bypass Cache: Ready-to-use Cloudflare cache bypass rules for WordPress, Laravel, ASP.NET, and generic web apps.
  Documentation | View Rules
• CF Smart Cache: WordPress plugin for intelligent edge HTML caching, automatic purging, and advanced admin controls.
  Documentation | Download Plugin
• CF Smart CDN Workers: KV-based Cloudflare Worker for dynamic CDN proxying and routing (deprecated).
  Documentation

(back to top)

Built With

• Cloudflare Rules Language
• PHP (WordPress plugin)
• JavaScript (Cloudflare Workers)
• Markdown Documentation

(back to top)

Getting Started

Prerequisites

• Cloudflare account (free or paid)
• For WordPress plugin: PHP 7.4+, WordPress 5.0+
• For Workers: Cloudflare Workers subscription (optional KV storage)
• Cloudflare API token or Global API key

Installation

For Cache Bypass Rules

1. Browse the cache bypass rules
2. Copy the appropriate .rules file content from cf-bypass-cache/
3. Paste into your Cloudflare dashboard under Rules → Cache Rules

For WordPress Sites

1. Download the Smart Cache plugin
2. Copy the cf-smart-cache folder to your WordPress wp-content/plugins/ directory
3. Activate the plugin in WordPress Admin
4. Configure with your Cloudflare API credentials

For Advanced CDN Routing

1. Deploy the CDN Worker
2. Configure KV namespace and routing rules as needed

(back to top)

Usage

• Use cache bypass rules to ensure dynamic content is always fresh
• Install the Smart Cache plugin for edge HTML caching and automatic purging on WordPress
• Refer to the documentation site for detailed guides, examples, and advanced configuration

See website/README.md for more usage examples and architecture diagrams.

(back to top)

Roadmap

• Modular cache bypass rules
• WordPress edge HTML caching plugin
• KV-based CDN proxy worker
• Comprehensive documentation
• REST API for cache management
• Advanced analytics dashboard
• Visual rule management UI
• Multi-language support

See the open issues for a full list of proposed features and known issues.

(back to top)

Contributing

Contributions are welcome! Please fork the repo and submit a pull request, or open an issue for suggestions and improvements.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See website/modules/cf-bypass-cache.md for rule contribution guidelines.

(back to top)

Top contributors:

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

LoveDoLove - @LoveDoLove

Project Link: https://github.com/LoveDoLove/cloudflare-smart-tools

(back to top)

Acknowledgments

• Cloudflare for their platform
• WordPress Community
• Open Source Contributors
• Best-README-Template

(back to top)