Dump — Serverless Online Clipboard

🔗 Live Project

Open Dump: https://dump.ashwithrai.me

✨ What is Dump?

DUMP (backronym: Distributed Utility for Message Passing) is a serverless online clipboard for sharing text through short links.

🚀 Core Features

• Custom clipboard URLs
• Public, reserved, and protected clipboard modes
• Password protection (view or edit mode)
• Owner token bypass for privileged actions
• Expiration controls (from 1 minute to 1 year)
• One-time view auto-delete support
• Global starred clipboard list (max 5)
• Raw text endpoint for scripts and automation

🧱 Architecture at a Glance

• Frontend: React + Vite + TypeScript (apps/dump-web) on Cloudflare Pages
• Backend: Hono + Cloudflare Workers (workers/dump-worker)
• Storage: Cloudflare KV (clip:<code>:meta, clip:<code>:content, app:starred)
• Domain: dump.ashwithrai.me
• API Base: https://dump.ashwithrai.me/api

📁 Repository Structure

dump/
├── apps/
│   └── dump-web/          # React + Vite frontend
├── workers/
│   └── dump-worker/       # Cloudflare Worker + Hono API
├── docs/
│   ├── ARCHITECTURE.md
│   ├── DECISIONS.md
│   ├── API.md
│   └── tasks/
└── README.md

🔐 Security & Product Decisions

Key decisions are documented in:

• docs/DECISIONS.md
• docs/ARCHITECTURE.md
• docs/API.md

Highlights:

• Passwords and owner tokens are stored as SHA-256 hashes
• Expired clipboards return 404 without revealing history
• Security headers and CORS are applied via middleware
• SEO indexing is intentionally blocked for privacy

🛠️ Local Development

Frontend

cd apps/dump-web
npm install
npm run dev

Worker

cd workers/dump-worker
npm install
npm run dev

✅ Validation Commands

# frontend
cd apps/dump-web
npm run lint
npm run build

# worker
cd ../../workers/dump-worker
npm run lint