gitwtfhub

wtf is pulse-uptime?

0xsmw/pulse-uptime — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · ops devopsComplexity · 3/5Setup · hard

TL;DR

A self hosted, Vercel based uptime monitor for HTTP and HTTPS endpoints with a dashboard, status page, CLI, and REST API.

Mindmap

mindmap
  root((repo))
    What it does
      Uptime monitoring
      Status page publishing
    Tech stack
      TypeScript
      Vercel
      Neon Postgres
    Features
      Deduplicated email alerts
      pulsectl CLI
      Scoped API tokens
    Setup
      Vercel Pro project
      Neon and Edge Config
    Audience
      Small teams
      Developers and ops

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Self host uptime monitoring for up to 100 endpoints instead of paying for a commercial service.

REASON 2

Publish a branded public status page and manually author incident reports for outages.

REASON 3

Automate monitor management from scripts or CI using the pulsectl CLI or scoped API tokens.

What's in the stack?

TypeScriptVercelNeon PostgresResend

How it stacks up

0xsmw/pulse-uptime0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardeasy
Complexity3/54/52/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a paid Vercel Pro project plus connected Neon Postgres, Edge Config, and Resend accounts.

Wtf does this do

Pulse Uptime is a website and service monitoring tool that checks whether your web pages and APIs are online, similar to commercial uptime services but self hosted on your own Vercel account. It watches up to 100 public web addresses at intervals as short as one minute, and confirms an outage or recovery only after a configurable number of consecutive failed or passed checks, which avoids false alarms from a single slow response. The dashboard shows response times, check history, and incident timelines, and can also track the public status of external services you depend on, such as OpenAI, Stripe, or Vercel itself, alongside your own checks. When something goes down, Pulse sends deduplicated email alerts through Resend rather than repeating the same alert over and over. You can also publish a public status page with your own branding, and write incident reports by hand or promote a detected outage straight into one. Beyond the web dashboard, there is a command line tool called pulsectl for managing monitors from a terminal, built to be scriptable so automated systems and AI agents can use it too, with every command able to output JSON. A companion REST API covers the same functionality for custom integrations, and scoped access tokens let you grant limited permissions to scripts or continuous integration systems instead of full administrator access. Running your own copy requires a paid Vercel project, a Neon Postgres database, a Vercel Edge Config store, and a Resend account for email, all connected together during setup. The author built the project largely with the help of AI coding assistants over a weekend and two additional days of security hardening. The project currently supports a single team, with plans to add multiple user accounts and additional check types such as certificate and port monitoring.

Yoink these prompts

Prompt 1
Help me deploy Pulse Uptime to Vercel and connect a Neon Postgres database and Edge Config store.
Prompt 2
Explain how to install and authenticate the pulsectl CLI against my deployed Pulse instance.
Prompt 3
Walk me through creating a scoped API token so a CI script can list monitors safely.
Prompt 4
Summarize how Pulse Uptime decides an endpoint is really down versus a single failed check.

Frequently asked questions

wtf is pulse-uptime?

A self hosted, Vercel based uptime monitor for HTTP and HTTPS endpoints with a dashboard, status page, CLI, and REST API.

What language is pulse-uptime written in?

Mainly TypeScript. The stack also includes TypeScript, Vercel, Neon Postgres.

How hard is pulse-uptime to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is pulse-uptime for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.