Skip to content

Repository files navigation

Health Monitoring System (HMP v1.0)

React Tailwind CSS Vite Theme Support

A professional, enterprise-grade network health monitoring dashboard built with React and Tailwind CSS. Designed with a premium Linear/Vercel-inspired aesthetic, this application allows operations teams to monitor websites, APIs, servers, and databases in real-time.

It features a comprehensive semantic design token system, offering a flawless experience across both Light and Dark modes, with interactive visualizations and live service polling.


✨ Features

  • Enterprise-Grade UI: Polished, modern interface with glassmorphism effects, subtle micro-animations, and high-fidelity contrast.
  • Seamless Theme Switching: Fully tokenized CSS variable architecture supporting instantaneous toggling between precise Light and Dark modes.
  • Real-Time Dashboard: Comprehensive overview with live statistics cards, a sparkline-based services table, and recent incident alerts.
  • Live Service Polling: Automatic simulated fetch() requests checking service health every 30s with dynamic UI updates.
  • Service Management: View, filter, and manage all monitored services in a responsive card-based grid layout.
  • Incident Tracking: Detailed tracking of service incidents including severity badges, timelines, and resolution status.
  • Performance Analytics: View uptime statistics and response time charts in the dedicated Reports section.
  • Secure Configuration: Settings panel for API key management, alert preferences, and notification routing.

🚀 Tech Stack

  • Frontend Framework: React 18+ (Hooks, Context API)
  • Styling: Tailwind CSS combined with Vanilla CSS variables for semantic design tokens
  • Icons: Lucide React
  • Build Tooling: Vite for lightning-fast HMR and optimized production builds
  • Responsive Design: Mobile, tablet, and desktop ready

🛠️ Getting Started

Prerequisites

  • Node.js 16+ and npm (or yarn/pnpm)

Installation

  1. Install dependencies:

    npm install
  2. Start the development server:

    npm run dev
  3. View the application: Open your browser and navigate to http://localhost:5173

Build for Production

npm run build

The optimized production build will be generated in the dist directory, ready for deployment.

📁 Project Structure

src/
├── components/          # Reusable UI components (Modals, Dropdowns, Sparklines)
├── contexts/            # React Context providers (ThemeContext)
├── hooks/               # Custom React hooks (useMonitor)
├── views/               # Main application pages (Dashboard, Services, Reports, etc.)
├── App.jsx              # Main application router and layout
├── main.jsx             # Application entry point
└── index.css            # Global CSS variables, design tokens, and Tailwind directives

🎨 Theming & Design System

The application utilizes a custom semantic CSS variable system mapped to Tailwind utility classes. This prevents "design drift" and ensures that any newly added component automatically supports both Light and Dark modes.

To modify the theme, edit the tokens in src/index.css:

  • --bg-surface: Main application background
  • --bg-raised: Card and elevated element backgrounds
  • --text-1, --text-2, --text-3: Typography hierarchy
  • --accent, --success, --danger, --warning: Status colors

📄 License

This project was originally created for educational purposes as part of the Computer Networks (Comp-352) course (HMP v1.0).

About

Monitor websites, APIs, and servers in real-time. A professional, responsive dashboard built with React, featuring live statistics, dynamic visualizations, and seamless theme switching.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages