Scratch Status Monitor (SSM)

Scratch Status Monitor (SSM) is a status page system designed to monitor the operational state of various Scratch features and present that information to users in a clear, understandable way.

Purpose

People who use Scratch regularly often run into issues like:

• Cloud variables are unavailable
• Trends are not updating
• Projects are not loading
• Comments cannot be posted

When these issues occur, the biggest challenge is not knowing where the cause is:

• Is there a problem with my local environment?
• Is there a problem with Scratch's servers?
• Is this a temporary outage or a longer-term issue?

To address these inconveniences, SSM visualizes Scratch service status in real time.

Key Features

Real-time Monitoring

• Periodic checks of Scratch API endpoints
• Automatic refresh every 5 minutes
• Response time and error rate tracking

Uptime History Recording

• Stores past service status as time-series data
• Enables impact analysis during incidents
• Long-term trend visibility via graphs

Clear Status Indicators

• Operational: Everything is working normally
• Degraded: Minor issues detected in some areas
• Outage: Major service issues are occurring

Tech Stack

Frontend

• TanStack Router - File-based routing
• React - UI components
• TanStack Query - Server-state management
• shadcn/ui - UI component library
• Tailwind CSS - Styling

Backend

• Hono - Lightweight web framework
• oRPC - Type-safe RPC communication
• Cloudflare Workers - Edge computing
• Supabase - Database

Infrastructure

• Cloudflare CDN - Global content delivery
• Cloudflare Cron Triggers - Scheduled monitoring tasks
• GitHub Actions - CI/CD

Monitored Services

Currently, the following Scratch services are monitored:

• Project API
• Cloud Variables Server
• Trends API
• User Profile API
• Comment system
• Other critical endpoints

Roadmap

• More detailed error categorization
• Expanded multilingual support
• Alert notifications (Discord, email, etc.)
• Additional performance metrics
• Custom monitoring settings

Contributing

This project is open source. Bug reports, feature suggestions, and pull requests are welcome.