donlon/cloudflare-error-page is a Developer Tools project on GitHub, written primarily in HTML. It has 5.8k stars. ✅Browser ❌Cloudflare ✅Host — Generator for customized Cloudflare error pages. (unofficial)
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This project creates customized error pages that mimic the well-known Cloudflare error page. You can also embed it into your own website.
Online Editor
Here's an online editor to create customized error pages and example server apps. Try it out here.
Quickstart for Programmers
JavaScript/NodeJS
Install the cloudflare-error-page package using npm:
npm install cloudflare-error-page
The following example demonstrates an Express application that automatically handles server errors.
import express from 'express';
import { render as render_cf_error_page } from 'cloudflare-error-page';
const app = express();
app.get('/', (req, res) => {
/* Some code that break prod. Pushed by a new employee recently. */
let [feature_values, _] = features
.append_with_names(self.config.feature_names)
.unwrap();
}
app.use((err, req, res) => {
/* Handle the error intelligently by using a custom handler */
res.status(500).send(render_cf_error_page({
"title": "Internal server error",
"error_code": "500",
"what_happened": err.toString(),
"what_can_i_do": "Please try again in a few minutes.",
}));
});
app.listen(3000);
(Thanks @junduck for creating the original NodeJS version.)
Python
Install cloudflare-error-page using pip.
pip install cloudflare-error-page
Then an error page can be generated using the render function provided by the package. (example.py)
import webbrowser
from cloudflare_error_page import render as render_cf_error_page
# This function renders an error page based on the input parameters
error_page = render_cf_error_page({
# Browser status is ok
'browser_status': {
"status": 'ok',
},
# Cloudflare status is error
'cloudflare_status': {
"status": 'error',
"status_text": 'Error',
},
# Host status is also ok
'host_status': {
"status": 'ok',
"location": 'example.com',
},
# Position of the error indicator, valid options are 'browser', 'cloudflare', and 'host'
'error_source': 'cloudflare',
# Texts shown in the bottom of the page
'what_happened': '<p>There is an internal server error on Cloudflare\'s network.</p>',
'what_can_i_do': '<p>Please try again in a few minutes.</p>',
})
# Write generated webpage to file
with open('error.html', 'w') as f:
f.write(error_page)
# Open the generated page in browser
webbrowser.open('error.html')
A demo server using Flask is available in flask_demo.py, and you can also see live demo here.
More Examples
Catastrophic infrastructure failure
params = {
"title": "Catastrophic infrastructure failure",
"more_information": {
"for": "no information",
},
"browser_status": {
"status": "error",
"status_text": "Out of Memory",
},
"cloudflare_status": {
"status": "error",
"location": "Everywhere",
"status_text": "Error",
},
"host_status": {
"status": "error",
"location": "example.com",
"status_text": "On Fire",
},
"error_source": "cloudflare",
"what_happened": "<p>There is a catastrophic failure.</p>",
"what_can_i_do": "<p>Please try again in a few years.</p>",
}
Demo
Web server is working
params = {
"title": "Web server is working",
"error_code": "200",
"more_information": {
"hidden": True,
},
"browser_status": {
"status": "ok",
"status_text": "Seems Working",
},
"cloudflare_status": {
"status": "ok",
"status_text": "Often Working",
},
"host_status": {
"status": "ok",
"location": "example.com",
"status_text": "Almost Working",
},
"error_source": "host",
"what_happened": "<p>This site is still working. And it looks great.</p>",
"what_can_i_do": "<p>Visit the site before it crashes someday.</p>",
}
Demo
FAQ
💡 How to show real user IP / Cloudflare Ray ID / data center location in the error page so that it looks more realistic?
Ray ID and user IP field in the error page can be set by ray_id and client_ip properties in the params argument passed to the render function. The real Cloudflare Ray ID and the data center location of current request can be extracted from the Cf-Ray request header (e.g. Cf-Ray: 230b030023ae2822-SJC). Detailed description of this header can be found at Cloudflare documentation.
To lookup the city name of the data center corresponding to the three letter code in the header, you can use a location list here
The demo server runs in our website did handle these. Take a look at this file for reference.
🤔 Is putting this on my website totally legal? As it contains trademarked logo/name and it's pretending to be an official one.
Use it at you own risk. There're still chances Cloudflare send you takedown request or take legal actions. But it depends on if you use it properly. It's better to change texts on the page so users know it's a joke.
If you do want to use an error page that pretends to be a Cloudflare one on your production environment, don't forget to fix your server quickly when it goes down so that they won't find that you are faking their error page. (See #4)
See also
cloudflare-error-page-3th.pages.dev
Error page of every HTTP status code (reload to show random pages).
oftx/cloudflare-error-page
React reimplementation of the original page, and can be deployed directly to Cloudflare Pages.
Full Parameter Reference
{
"html_title": "cloudflare.com | 500: Internal server error",
"title": "Internal server error",
"error_code": "500",
"time": "2025-11-18 12:34:56 UTC", // Current UTC time will be shown if empty
// Configuration of "Visit ... for more information"
"more_information": {
"hidden": false,
"text": "cloudflare.com",
"link": "https://www.cloudflare.com/",
"for": "more information",
},
// Configuration of the Browser/Cloudflare/Host status block
"browser_status": {
"status": "ok", // "ok" or "error"
"location": "You",
"name": "Browser",
"status_text": "Working",
"status_text_color": "#9bca3e",
},
"cloudflare_status": {
"status": "error",
"location": "Cloud",
"name": "Cloudflare",
"status_text": "Error",
"status_text_color": "#bd2426",
},
"host_status": {
"status": "ok",
"location": "Website",
"name": "Host",
"status_text": "Working",
"status_text_color": "#9bca3e",
},
// Position of the error indicator, valid options are 'browser', 'cloudflare', and 'host'
"error_source": "host",
"what_happened": "<p>There is an internal server error on Cloudflare's network.</p>",
"what_can_i_do": "<p>Please try again in a few minutes.</p>",
"ray_id": '0123456789abcdef', // Random hex string will be shown if empty
"client_ip": '1.1.1.1',
// Configuration of 'Performance & security by ...' in the footer
"perf_sec_by": {
"text": "Cloudflare",
"link": "https://www.cloudflare.com/",
},
}
How active is development on donlon/cloudflare-error-page?
The most recent commit recorded on donlon/cloudflare-error-page was 4 months ago, based on the GitHub push timestamp. The repository has 286 forks — one of the better signals of community interest.
How many stars does donlon/cloudflare-error-page have?
donlon/cloudflare-error-page has 5.8k GitHub stars — refresh the page for the live number, or check github.com/donlon/cloudflare-error-page. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is donlon/cloudflare-error-page open source?
Yes — donlon/cloudflare-error-page ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/donlon/cloudflare-error-page.
What else is in the Developer Tools space?
donlon/cloudflare-error-page is tracked by TopGit under the Developer Tools category. Trending and Topics pages list peer repositories of comparable stars and language.
What is donlon/cloudflare-error-page?
donlon/cloudflare-error-page (donlon/cloudflare-error-page) is a HTML project on GitHub. From the project's own README: ✅Browser ❌Cloudflare ✅Host — Generator for customized Cloudflare error pages. (unofficial)
What language is donlon/cloudflare-error-page written in?
donlon/cloudflare-error-page is written primarily in HTML. GitHub's language field is based on the largest share of bytes in the default branch.
What license does donlon/cloudflare-error-page use?
donlon/cloudflare-error-page is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about donlon/cloudflare-error-page?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/donlon/cloudflare-error-page is the definitive source.
Read full README in the tab above.
Still deciding about cloudflare-error-page?
One click hands the question to an AI along with this page — see what it says about cloudflare-error-page.