How shauryakant/pulscheck works
PulseCheck lets users authenticate, register websites, and view live status and tick history. A periodic pusher reads monitored websites and enqueues checks; regional workers retry stale messages, probe targets, persist latency/status ticks, and acknowledge successful work. The README documents the queue and reliability model; worker, pusher, API, and dashboard excerpts show the main runtime calls. The worker-to-Redis and database relationships are supported by excerpts, while unsampled internals such as database schema and the history page’s API calls are represented only where documented.
Main entry points: src/index.ts Express API · worker/index.ts Regional worker · src/index.ts PostgreSQL · page.tsx Website dashboard
Components 15
Dashboard
- Landing page
apps/web/app/page.tsx - Auth modal
apps/web/components/auth-modal.tsx - Website dashboard
apps/web/app/websites/page.tsx - Add website modal
apps/web/components/add-website-modal.tsx - Tick history view
apps/web/app/websites/[websiteId]/page.tsx
API
- Express API
apps/api/src/index.ts - Authentication routes
apps/api/src/routes/v1/user.ts - JWT middleware
apps/api/src/middleware/userMiddleware.ts - Website and status routes
apps/api/src/routes/v1/website.ts
Check pipeline
- Scheduler pusher
apps/pusher/index.ts - Regional worker
apps/worker/index.ts - Monitored endpoint
Shared infrastructure
- PostgreSQL
packages/db/src/index.ts - Redis Streams helpers
packages/redis-streams/index.ts
Other components
- User
Connections 20
- User → Landing page: opens
README.md - Landing page → Auth modal: renders
apps/web/app/page.tsx - Auth modal → Express API: submits credentials
apps/web/components/auth-modal.tsx - User → Website dashboard: manages monitors
README.md - Website dashboard → Express API: polls websites
apps/web/app/websites/page.tsx - Website dashboard → Add website modal: opens
apps/web/app/websites/page.tsx - Add website modal → Express API: adds website
- User → Tick history view: views ticks
README.md - Tick history view → Express API: requests history
- Express API → Authentication routes: routes to
apps/api/src/index.ts - Express API → Website and status routes: routes to
apps/api/src/index.ts - Authentication routes → PostgreSQL: reads and writes users
apps/api/src/routes/v1/user.ts - Website and status routes → JWT middleware: uses
apps/api/src/routes/v1/website.ts - Website and status routes → PostgreSQL: reads and writes monitors
apps/api/src/routes/v1/website.ts - Scheduler pusher → PostgreSQL: reads websites
apps/pusher/index.ts - Scheduler pusher → Redis Streams helpers: enqueues checks
README.md - Regional worker → Redis Streams helpers: claims and reads
apps/worker/index.ts - Regional worker → Monitored endpoint: probes HTTP
apps/worker/index.ts - Regional worker → PostgreSQL: persists ticks
apps/worker/index.ts - Regional worker → Redis Streams helpers: acknowledges checks
apps/worker/index.ts