/supercheck

AI-Powered Automation & Monitoring Platform for Modern Applications

Primary LanguageTypeScriptMIT LicenseMIT

Supercheck Logo

Supercheck

Enterprise-grade automation and monitoring platform for modern applications.

Supercheck delivers comprehensive test automation, real-time monitoring, intelligent job orchestration, and parallel execution capabilities for development and SRE teams.

Deploy License Website Platform Monitoring Testing

Features

Testing & Automation

  • Browser (Playwright), API, Database, and custom script execution
  • Interactive code playground with built-in editor
  • Cron-based scheduled jobs with parallel execution
  • AI-powered failure analysis and fix suggestions

Monitoring

  • Synthetic tests, HTTP/HTTPS, Website, Ping, and Port monitoring
  • Multi-location execution across 3 geographic regions
  • SSL certificate tracking and validation
  • Historical performance metrics

Status Pages

  • Public status pages with custom branding
  • Incident management and tracking
  • Email and webhook notifications
  • Scheduled maintenance announcements

Alerting

  • Multi-channel: Email, Slack, Webhooks, Telegram, Discord
  • Configurable failure/recovery thresholds
  • Monitor failures, SSL expiration, job alerts

Access Control

  • Multi-tenant organizations and projects
  • RBAC with 6 permission levels
  • API keys and audit logging

Architecture

┌─────────────────────────┐
│   Next.js App Service   │
│  Frontend + API Routes  │
└───────────┬─────────────┘
            │
    ┌───────┼────────┬──────────┐
    ↓       ↓        ↓          ↓
┌────────┐ ┌─────┐ ┌──────┐ ┌────────────┐
│Postgres│ │Redis│ │MinIO │ │NestJS Workers│
└────────┘ └─────┘ └──────┘ └────────────┘

Stack: Next.js 16 · React 19 · NestJS · PostgreSQL 18 · Redis · MinIO · Playwright

Quick Start

# Clone and setup
git clone https://github.com/supercheck-io/supercheck.git
cd supercheck
cp .env.example .env

# Start with Docker
docker-compose up -d
docker-compose exec app npm run setup:admin admin@example.com

Access at http://localhost:3000

Development

Prerequisites: Node.js 20+ · Docker · PostgreSQL 18+ · Redis · Go 1.23+ (for k6)

k6 Setup (required for performance testing features):

# Install xk6 (k6 extension builder)
go install go.k6.io/xk6/cmd/xk6@latest

# Build k6 with web-dashboard extension
xk6 build --with github.com/grafana/xk6-dashboard@latest

# Install to system path
sudo mv k6 /usr/local/bin/k6

Local Development:

# App service
cd app && npm install && npm run db:migrate && npm run dev

# Worker service (requires k6 with web-dashboard extension)
cd worker && npm install && npm run dev

Project Structure:

supercheck/
├── app/          # Next.js frontend & API
├── worker/       # NestJS worker service
└── docker-compose.yml

Documentation

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Community

License

MIT License - see LICENSE for details.