Skip to content

bradmca/uptime-pulse

⚡ Uptime-Pulse ⚡

CI / Continuous Integration Uptime Check License: MIT

"As a dev-ops engineer, I want a simple way to monitor my microservices without paying for Pingdom."


📺 Preview

Uptime-Pulse is a lightweight, premium, and open-source uptime monitoring solution. Built for speed, aesthetic excellence, and simplicity. Monitor your microservices, track latency, and receive downtime alerts without the enterprise price tag.


✨ Features

  • 💎 Premium Dashboard: Stunning dark theme with glassmorphism, pulse animations, and interactive elements.
  • 🕒 24h Visual History: Segmented status bars providing a 24-hour lookback at a glance.
  • 📈 Latency Tracking: Real-time measurement of response times with historical averages.
  • 🔔 Proactive Alerts: Integrated notification system for downtime and recovery.
  • 🤖 Automation First: GitHub Actions workflow included for hands-free 24/7 monitoring.
  • 📦 Zero Heavy Dependencies: Simple JSON file-based storage. No complex database migrations.

🚀 Quick Start

1. Clone & Install

git clone https://github.com/bradmca/uptime-pulse.git
cd uptime-pulse
npm install

2. Configure (Optional)

Copy .env.example to .env and set your deployment domain and secrets.

cp .env.example .env

3. Run Locally

npm run dev

Navigate to http://localhost:3000.


🛠️ Tech Stack


🤖 Automate Your Monitoring

To run checks every 5 minutes automatically:

  1. Deploy to Vercel or Netlify.
  2. Go to your GitHub Repository Settings > Secrets and variables > Actions.
  3. Add APP_DOMAIN (e.g., uptime-pulse-demo.vercel.app).
  4. Add API_SECRET (optional).
  5. The Uptime Check action will now run every 5 minutes and keep your dashboard alive!

📁 Project Structure

├── .github/workflows/   # CI/CD and Automation
├── src/
│   ├── app/             # Next.js Routes & Dashboard
│   ├── components/      # Glassmorphic UI Components
│   ├── lib/             # Health Checker, Storage, Notifications
│   └── types/           # Type Definitions
├── data/                # Persistent JSON Storage
└── public/              # Static Assets

🤝 Contributing

We love contributions! Please read our CONTRIBUTING.md to get started.

🛡️ Security

Found a bug? See our SECURITY.md.

📄 License

Distributed under the MIT License. See LICENSE for more information.


⭐ If this project helps you, please give it a star!

About

A lightweight, premium API monitoring dashboard with visual 24h status bars, latency tracking, and automated downtime alerts. Built with Next.js 15, TypeScript, and GitHub Actions.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors