Kernel Pulse Documentation

What is Kernel Pulse?

Kernel Pulse is a lightweight status page + connectivity monitor. It allows you to check whether your websites, APIs, and services are reachable in real time.

The UI runs entirely in the browser, while actual network checks are performed by a secure serverless function deployed on Vercel.

There is no database, no background jobs, and no vendor lock-in.

How Kernel Pulse Works

• The dashboard loads services from config.json
• When a scan is triggered, the browser calls a serverless API
• The serverless API checks if the target responds
• Status and response time are returned and displayed

This architecture avoids browser security limitations and provides accurate results.

Dashboard Features

Scan Network

Manually checks all services defined in config.json once. This updates individual service cards and the global system status.

Auto-Refresh (30s)

Automatically runs a network scan every 30 seconds while the page remains open.

This is useful for live monitoring screens but does not run in the background after the tab is closed.

Quick Probe

Allows you to instantly test any URL without adding it to the configuration file.

Probe History

Recently checked URLs are stored locally in your browser using localStorage.

• History is private per browser
• No data is sent to the server
• History persists after refresh

Configuration (config.json)

Kernel Pulse is fully configured using a single file: config.json.

Example configuration:

{
  "brand": {
    "name": "Jaiho Pulse",
    "parent": "Jaiho Kernel",
    "url": "https://jaiho-digital.onrender.com",
    "logo_icon": "fas fa-heart-pulse"
  },
  "categories": [
    {
      "name": "Utilities & Privacy",
      "services": [
        {
          "id": "j-ip",
          "name": "Jaiho IP",
          "url": "https://jaiho-ip.vercel.app",
          "desc": "IP Detection API"
        }
      ]
    }
  ]
}

• id must be unique
• url must be publicly reachable
• No rebuild required — just refresh

Using Kernel Pulse as an API

Kernel Pulse can also be used as a simple public JSON API for developers.

Endpoint:

GET https://kernel-pulse.vercel.app/api/json

Example Response:

{
            "status": "online",
            "responseTime": 213,
            "timestamp": "2025-01-20T12:30:00Z"
            }

JavaScript Example

fetch('https://kernel-pulse.vercel.app/api/json')
            .then(response => response.json())
            .then(data => {
                console.log('status:', data.status);
                console.log('ms:', data.responseTime);
                console.log('time:', data.timestamp);
            })
            .catch(error => console.error('Error:', error));

Python Example

import requests

response = requests.get('https://kernel-pulse.vercel.app/api/json')
data = response.json()

print("status:", data["status"])
print("ms:", data["responseTime"])
print("time:", data["timestamp"])

This API is read-only and intended for lightweight integrations, dashboards, and monitoring scripts.

API Rate Limits

The Kernel Pulse API is rate-limited to ensure fair usage and platform stability.

• Maximum 60 requests per minute per IP
• Applies to all /api/json requests
• Exceeding the limit returns HTTP 429

This API is intended for lightweight monitoring, dashboards, and scripts. Please avoid high-frequency polling.

Limitations

• No background monitoring when the page is closed
• No alerts or notifications
• No historical uptime storage
• No shared history between users

These limitations are intentional to keep Kernel Pulse simple, transparent, and free.