Upstat Monorepo
Upstat is a comprehensive web application designed to monitor the health and performance of your websites, servers, and APIs. Equipped with real-time charts, status indicators, and incident reporting, Upstat provides a centralized dashboard that allows you to keep tabs on your digital assets. With its intuitive interface and robust analytics, you can quickly identify issues, analyze trends, and take proactive measures to ensure optimal uptime and user experience. Whether you're a small business or a large enterprise, Upstat offers a scalable solution to meet your monitoring needs.
- Real-time charts — live performance and response time graphs
- Status indicators — instant up/down/degraded signals per monitor
- Incident reporting — automated incident creation, updates, and resolution
- Alerting — notifications via email, Slack, webhooks, and more
- Multi-region checks — monitor from multiple geographic locations
- Public status pages — shareable uptime pages for your users
- Team access control — role-based access for organisations
upstat/
├── api/
│ ├── nodejs/ # Node.js REST API (core monitoring engine)
│ └── go/ # Go service (high-frequency ping workers)
├── app/
│ ├── web/ # Next.js web dashboard
│ └── mobile/ # React Native mobile app
├── packages/
│ ├── ui/ # Shared React component library
│ ├── types/ # Shared TypeScript types & interfaces
│ └── utils/ # Shared utility functions
├── deploy/
│ ├── docker/ # Docker Compose configs
│ ├── helm/ # Kubernetes Helm charts
│ └── terraform/ # Infrastructure as Code
├── docs/ # Architecture, API refs, guides
├── scripts/ # Dev, CI, and release scripts
└── .github/
├── ISSUE_TEMPLATE/ # Bug report & feature request templates
└── workflows/ # GitHub Actions CI/CD pipelines
| Layer | Technology |
|---|---|
| Web Dashboard | Next.js, React, Tailwind CSS |
| Mobile | React Native |
| API (core) | Node.js, Express/ Fastify |
| API (workers) | Go |
| Database | PostgreSQL (via Supabase) |
| Real-time | WebSockets / Server-Sent Events |
| Infrastructure | Docker, Helm, Terraform |
| CI/CD | Github Actions |
# 1. Clone the repo
git clone https://github.com/cuesoftinc/upstat.git
cd upstat
# 2. Install all dependencies
make setup
# 3. Copy environment variables
cp .env.example .env
# Fill in your values in .env
# 4. Start all services locally
make devOpen http://localhost:3000 to view the dashboard.
See the Self-Hosting Guide for instructions on deploying Upstat with Docker, Kubernetes (Helm), or Terraform.
We welcome contributions of all kinds- bug fixes, new features, documentation, translations, and more. Please read our Contributing Guide before opening a PR.
For first-time contributors, look for issues labelled good first issue.
Full Documentation is in the ./docs/ folder:
Upstat is open-source software licensed under the MIT License.
- GitHub Discussions
- Report a Bug
- Request a Feature
- Security issues: security@cuesoftinc.com