Switchyy — Real-Time App Mode Control
Instant Live and Maintenance mode control for web apps without redeployments or server restarts, backed by sub-100ms Edge SSE.
Project Overview
Switchyy is a high-availability real-time mode control and feature flagging platform designed for mission-critical web applications. It eliminates the need for emergency Git commits or cold rebuilds during deployments, maintenance windows, outages, or beta rollouts. By embedding a single lightweight script tag or consuming the sub-100ms decision API, teams can flip any app between 22 built-in operational modes—or trigger custom branded overlays—in under 100 milliseconds via Server-Sent Events (SSE) and Edge caching.
Edge Decision Engine, Server-Sent Events & Redis KV
Engineered with a low-latency 3-tier topology: a Next.js 15 control dashboard with instant project scopes, an Edge-optimized Decision API backed by in-memory Redis KV caching, and a persistent Server-Sent Events (SSE) push channel for zero-refresh client propagation.
- Sub-100ms Edge decision resolution cached via Redis KV to serve high-traffic inbound client requests with zero database degradation.
- Real-time Server-Sent Events (SSE) streaming channel pushing mode state changes to all active browser sessions instantaneously.
- Granular development suppression filters allowing developers to blanket-hide or whitelist maintenance overlays across localhost, preview environments, or specific subdomains.
- Fail-open architecture ensuring client applications continue normal execution even during extreme upstream network partitions.
Engineering Challenges & Solutions
Propagating mode switches instantly to thousands of open tabs without polling
Architected a persistent Server-Sent Events (SSE) event bus with lightweight heartbeat pings and automatic reconnect backoff, replacing expensive client polling with sub-100ms reactive push delivery.
Preventing client-side overlay flicker or Layout Shift (CLS = 0)
Designed the embeddable script (switchy.js) to evaluate state before paint using pre-warmed Edge headers, injecting the frosted-glass maintenance overlay smoothly with zero cumulative layout shift.
Granular multi-tenant project isolation with strict rate-limiting
Implemented public-key project hashing and sliding-window rate limiters (60 req/min/IP) in Edge middleware to prevent DDoS amplification while maintaining sub-millisecond decision throughput.
Core Capabilities
- Instant 1-click mode switching across 22 built-in operational states
- Dynamic Scheduled Maintenance, Incident, Offline, and Beta overlays
- Real-time Server-Sent Events (SSE) client updates with zero page refresh
- Granular development environment suppression (localhost & staging controls)
- Universal embeddable script supporting React, Next.js, Vue, Nuxt, Svelte, Astro, and plain HTML
- Sub-100ms decision API endpoint with Redis KV caching and fail-open resilience
- Custom preset templates storing tailored messages, button CTAs, and redirect destinations
Validated Outcomes
- Sub-100ms global Edge decision latency verified across multi-region benchmarks
- Zero redeployments required for live emergency maintenance and feature toggling
- Zero layout shift (CLS = 0) on client DOM injection with frosted glass aesthetics
- 60 req/min/IP rate-limited Edge API delivering 99.99% uptime availability
Licensing, IP & Contract Governance
Transparent disclosure on source code distribution, client contracts, and commercial terms
Software License Status
Proprietary Commercial SaaS (Public Code Showcase)
Contract & Engagement Model
Client Contract Signed & Production SaaS Terms
Operates under a formal Proprietary Commercial Software License (All rights reserved). The GitHub repository is maintained as an open architecture and code quality showcase for engineering teams and recruiters, backed by signed client service contracts and protected rate-limited API infrastructure.