pump-website

---
name: pump-website
description: "PumpOS — static HTML/CSS/JS web desktop for the Pump SDK with 169 Pump-Store apps, live token dashboards, interactive DeFi tools, PWA support, and Vercel deployment."
metadata:
  solanaos:
    homepage: https://github.com/nirholas/pump-fun-sdk
---

# 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