404 error pages for teams that
break production with confidence.
Point your broken routes and unhandled exceptions at witty-404. Turn routing catastrophes into developer comic relief with zero setup and edge performance.
curl -s https://witty-404.zimkk.workers.dev/json
Four Ways to Consume the Engine
Whether you need a full standalone web page, structured JSON for custom UI, or raw text logs for the terminal, witty-404 provides dedicated endpoints.
Full-Bleed Web Page
Complete error page featuring animated diagnostics, synchronized flight trajectory crash, and action toolbar.
Structured REST Payload
Raw JSON response with disaster headline, subtitle, diagnostic logs array, footnote, and category tags.
CLI & Terminal Logs
Returns step-by-step diagnostic log strings for terminal output, build scripts, and CLI tools.
Path-Aware Roaster
Injects the exact missing client route into the disaster scene with strict HTML sanitization.
Zero-Configuration Framework Recipes
Drop witty-404 into your existing stack in under 30 seconds with zero build dependencies.
export default function NotFound() {
return (
<iframe
src="https://witty-404.zimkk.workers.dev/html?theme=dark"
style={{ width: "100vw", height: "100vh", border: "none", display: "block" }}
title="404 Error Page"
/>
);
}
app.use((req, res) => {
fetch('https://witty-404.zimkk.workers.dev/html')
.then(r => r.text())
.then(html => res.status(404).type('html').send(html));
});
{
"routes": [
{ "handle": "filesystem" },
{ "src": "/(.*)", "dest": "https://witty-404.zimkk.workers.dev/roast?path=/$1&format=html", "status": 404 }
]
}
<iframe
src="https://witty-404.zimkk.workers.dev/html?theme=dark"
style="width: 100vw; height: 100vh; border: none; display: block;"
title="404 Error Page"
></iframe>
Endpoint Capability Matrix
All endpoints return Access-Control-Allow-Origin: * and respond in sub-5ms latency from Cloudflare edge nodes.
| ENDPOINT & METHOD | RETURN FORMAT | SUPPORTED PARAMETERS |
|---|---|---|
| GET/ or /json | JSON | ?id=, ?tag=, ?seed= |
| GET/html | HTML | ?theme=dark|light|matrix|glitch, ?id=, ?tag= |
| GET/roast | JSON / HTML | ?path=..., &format=html |
| GET/terminal | JSON Array | ?id=, ?tag= |
| GET/svg | SVG | ?theme=dark|light|matrix|glitch, ?id= |
| GET/text | Plain Text | ?id=, ?tag= |
| GET/all | JSON Array | None (returns entire joke catalog) |
| GET/stats | JSON | None (returns impression leaderboard) |
Built by a developer who once spent four consecutive hours debugging a missing semicolon in production and concluded that 404 error pages deserved significantly better comedic timing. Zero tracking cookies, zero bloated frameworks, 100% open-source chaos.