The Zero-Config Status Page for Any GitHub Repository — An open-source, edge-native alternative to Vercel Status and Instatus. Powered by Cloudflare Workers, Hono SSR, Cloudflare KV, and GitHub Actions.
- Zero Configuration: No signup, database setup, or third-party paid
accounts. Visit
/:owner/:repofor any public GitHub repository and get a live status page instantly. - Dynamic Real-Time SVG Badges: Crisp vector status badges
(
/badge/:owner/:repo.svg?lang=en|es&label=...) with XML escaping and edge HTTP caching. - Cloudflare Edge & KV Caching: Runs across 300+ global edge locations (~35
KiB gzipped bundle, ~5 ms startup) with dynamic KV TTL, conditional GitHub
ETag (
304 Not Modified) requests, and consolidated 90-day daily history snapshots. - Deep GitHub Actions CI/CD Telemetry: Tracks recent workflow runs, durations, commit SHAs, authors, branches, and failure rates in parallel.
- Issue-Driven Incident Management: Opening an issue labeled
incident,outage,downtime, ordegradationautomatically updates system status and the RSS 2.0 feed (/rss/:owner/:repo.xml). - Headless JSON REST API: Query
/api/status/:owner/:repo(with cooldown protection on?refresh=true) to power bots, widgets, or dashboards. - Fail-Closed Push Telemetry & Webhooks: Authenticated
POST /api/ping/:owner/:repoheartbeats (with latency & HTTP status integrated into overall status) and HMAC-SHA256 verifiedPOST /api/webhook/github.
Paste this Markdown badge into your repository's README.md:
[](https://statuszero.pii-veilglastores.workers.dev/YOUR_OWNER/YOUR_REPO)Clicking the badge opens your dedicated status page:
https://statuszero.pii-veilglastores.workers.dev/YOUR_OWNER/YOUR_REPO
To record immediate status pings whenever your CI/CD pipeline finishes, add this
step to .github/workflows/ci.yml (configure STATUSZERO_PING_SECRET in your
repository secrets to match PING_SECRET in Cloudflare Workers):
- name: Report Telemetry to StatusZero
if: always()
env:
STATUSZERO_PING_SECRET: ${{ secrets.STATUSZERO_PING_SECRET }}
run: |
curl -fsS -X POST "https://statuszero.pii-veilglastores.workers.dev/api/ping/${{ github.repository }}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${STATUSZERO_PING_SECRET}" \
-d '{"workflow":"${{ github.workflow }}","status":"${{ job.status }}","branch":"${{ github.ref_name }}","commit":"${{ github.sha }}"}'- Runtime & Hosting: Cloudflare Workers +
Workers Static Assets (
./public) - Framework: Hono (
hono/jsxServer-Side Rendering) - Storage & Cache: Cloudflare KV
(
STATUS_KVbinding) - GitHub Integration: Native Web
fetch+ conditionalIf-None-MatchETag requests + Web Crypto API (crypto.subtle) - Testing: Vitest + TypeScript strict mode
npm installnpm run devnpm run check
npx wrangler deploy --dry-run- Authenticate with Cloudflare and create the KV namespace:
npx wrangler login
npx wrangler kv namespace create STATUS_KV- Put the generated KV namespace
idintowrangler.jsonc. - Configure production secrets (fail-closed by default):
npx wrangler secret put GITHUB_WEBHOOK_SECRET
npx wrangler secret put PING_SECRET
# Optional (recommended): fine-grained read-only token for 5,000 req/h
npx wrangler secret put GITHUB_TOKEN- Deploy to the global edge:
npm run deploy- CONTRIBUTORS.md — Gobernanza, equipo y guía de patrocinio.
- CHANGELOG.md — Historial de versiones y notas de lanzamiento.
- CITATION.cff — Metadatos de citación académica y de software.
- SECURITY.md — Políticas de seguridad y reporte de vulnerabilidades.
- LICENSE — Licencia de código abierto GNU Affero General Public License v3.0 (AGPL-3.0).
Este proyecto está licenciado bajo los términos de la GNU Affero General Public License v3.0 (AGPL-3.0). Consulta el archivo LICENSE para más detalles.
AGPL-3.0 © 2010-2026 Andrés Antonio Cardoso — GLASTOR®. Todos los derechos reservados.