Skip to content
glastor-devPublic

About

Un solo botón en tu README que convierte automáticamente los flujos de GitHub Actions, releases e incidencias en una página de estado ultra rápida y en tiempo real. Sin registro. Sin infraestructura. Despliegue instantáneo en el Edge.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

StatusZero

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.

Status CI/CD License: AGPL-3.0 Cloudflare Workers Hono Repo


Highlights

  • Zero Configuration: No signup, database setup, or third-party paid accounts. Visit /:owner/:repo for 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, or degradation automatically 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/:repo heartbeats (with latency & HTTP status integrated into overall status) and HMAC-SHA256 verified POST /api/webhook/github.

Quick Start: Add to Your README

Paste this Markdown badge into your repository's README.md:

[![Status](https://statuszero.pii-veilglastores.workers.dev/badge/YOUR_OWNER/YOUR_REPO.svg)](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


Optional: Push Instant Heartbeats via GitHub Actions

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 }}"}'

Tech Stack

  • Runtime & Hosting: Cloudflare Workers + Workers Static Assets (./public)
  • Framework: Hono (hono/jsx Server-Side Rendering)
  • Storage & Cache: Cloudflare KV (STATUS_KV binding)
  • GitHub Integration: Native Web fetch + conditional If-None-Match ETag requests + Web Crypto API (crypto.subtle)
  • Testing: Vitest + TypeScript strict mode

Local Development

1. Install dependencies

npm install

2. Run the Worker locally

npm run dev

3. Type-check, test, and dry-run bundle

npm run check
npx wrangler deploy --dry-run

Deploy to Cloudflare Workers

  1. Authenticate with Cloudflare and create the KV namespace:
npx wrangler login
npx wrangler kv namespace create STATUS_KV
  1. Put the generated KV namespace id into wrangler.jsonc.
  2. 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
  1. Deploy to the global edge:
npm run deploy

Documentación y Recursos

  • 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).

Licencia

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.

About

Un solo botón en tu README que convierte automáticamente los flujos de GitHub Actions, releases e incidencias en una página de estado ultra rápida y en tiempo real. Sin registro. Sin infraestructura. Despliegue instantáneo en el Edge.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages