PumpOS Website — Static Web Desktop

PumpOS is a fully static HTML/CSS/JS web desktop environment — a browser-based OS simulation themed around Solana DeFi. No framework, no build step. Deployed on Vercel at pumpos.app.

Key Files

File	Purpose
website/index.html	Desktop shell — taskbar, windows, start menu, wallpaper
website/script.js	App management, window lifecycle, taskbar, default apps
website/system32.js	OS kernel — event bus, IPC routing, user system
website/pump.css	Design system tokens — colors, spacing, radii, easing
website/style.css	Full component styles — windows, taskbar, menus
website/sw.js	Service worker — cache-first PWA
website/live.html	Real-time token launch dashboard (WebSocket relay)
website/vercel.json	Static deployment config with SPA rewrite

Architecture

• Single HTML page (index.html) as the desktop shell
• Apps loaded as HTML fragments in iframes
• system32.js provides event bus + IPC between apps via postMessage
• script.js manages window lifecycle, taskbar, and 30 built-in apps
• 24 JS modules in website/scripts/ (kernel, window manager, wallet-connect, etc.)

Pump-Store Apps (143)

All in website/Pump-Store/apps/ as individual .html files. Database at Pump-Store/db/v2.json. Categories:

• DeFi tools — bonding curve calculator, DEX aggregator, fee manager, fee tier explorer
• Trading — trading signals, token sniper, multichart, orderbook, watchlist
• Analytics — on-chain analytics, whale flow, smart money, correlation matrix
• Monitoring — liquidation heatmap, gas predictor, MEV detector, whale alerts
• Portfolio — portfolio tracker, PnL leaderboard, position calculator
• SDK-specific — pump-sdk-reference, token-launcher, token-launch-sim, creator-fee-sharing, migration-tracker

Design System

CSS custom properties in pump.css:

• Primary accent: #00e87b (Pump green)
• Background: #0a0a0a → #111111 → #1a1a1a (dark theme)
• Border radius: 3-tier system (0.7em / 0.35em / 0.233em)
• Responsive breakpoint at 768px
• Custom cubic-bezier easing curves

PWA Support

• Service worker with cache-first strategy
• Web app manifest with standalone display mode
• web+pump:// protocol handler
• Installable with proper icons (512×512)

Deployment

• Vercel (static, no framework, no build command)
• SPA routing: all non-asset paths rewrite to /index.html
• /libs/ and /assets/ get immutable caching (1 year)
• API proxy function at api/proxy.js

Patterns to Follow

• No frameworks — vanilla HTML/CSS/JS only
• Apps are self-contained HTML files loaded in iframes
• Use system32.js event bus for inter-app communication
• All crypto operations run client-side
• Use CSS custom properties from pump.css for theming

Common Pitfalls

• Service worker caching may serve stale content — version your cache
• system32.js IPC requires apps to listen for postMessage events
• Pump-Store app HTML must be self-contained (no external dependencies beyond libs/)
• The script.js default app list controls first-launch pins — update it when adding built-in apps