How luciferakj/clipdrop works
ClipDrop is a temporary text-and-file sharing service with optional authenticated device management and polling-based clipboard sync. The main workflow is upload and configure content, create a share, then retrieve it through its code; authenticated users also manage shares/devices and sync clipboard text. Arrows cite shown calls or explicit README relationships. Several routes and sync helpers are represented from the README and source index rather than inspected excerpts, so uncertain implementation links are omitted.
Main entry points: prisma.ts Postgres metadata · route.ts Create share API · [code]/page.tsx Receive page · dashboard/page.tsx Uploads dashboard
Components 27
Share lifecycle
- Upload form
components/UploadZone.tsx - Upload transport
lib/uploadService.ts - Create share API
app/api/upload/route.ts - Share link result
components/ShareResult.tsx - Receive page
app/s/[code]/page.tsx - Retrieve share API
app/api/share/[code]/route.ts - Text preview
components/share/TextViewer.tsx - Home entry
app/page.tsx
User workspace
- Uploads dashboard
app/dashboard/page.tsx - Share management
components/dashboard/DashboardList.tsx - Share actions
components/dashboard/ShareCard.tsx - Delete share API
app/api/dashboard/delete/route.ts - Devices dashboard
app/dashboard/devices/page.tsx - Device management
components/devices/DeviceList.tsx - Device client
lib/deviceClient.ts - Device API
app/api/devices/route.ts - Device item API
app/api/devices/[id]/route.ts
Clipboard sync
- Sync engine
hooks/useClipboardSync.ts - Sync status provider
components/providers/ClipboardSyncStatusProvider.tsx - Sync API client
lib/clipboardSyncClient.ts - Clipboard API
app/api/clipboard/route.ts
Data and services
- Postgres metadata
lib/prisma.ts - Cloudinary files
lib/cloudinary.ts - Input validation
lib/validation.ts - Expiry cleanup
app/api/cron/cleanup/route.ts
Other components
- Visitor
- Clerk identity
Connections 31
- Visitor → Home entry: opens
app/page.tsx - Home entry → Upload form: renders
app/page.tsx - Upload form → Upload transport: starts upload
components/UploadZone.tsx - Upload transport → Create share API: POSTs payload
lib/uploadService.ts - Create share API → Input validation: validates content
app/api/upload/route.ts - Create share API → Cloudinary files: stores files
app/api/upload/route.ts - Create share API → Postgres metadata: creates share
app/api/upload/route.ts - Create share API → Share link result: returns code
- Visitor → Receive page: opens link
app/s/[code]/page.tsx - Receive page → Retrieve share API: requests content
- Retrieve share API → Postgres metadata: reads and updates
app/api/share/[code]/route.ts - Receive page → Text preview: renders preview
app/s/[code]/page.tsx - Clerk identity → Uploads dashboard: authenticates
app/dashboard/page.tsx - Uploads dashboard → Postgres metadata: loads shares
app/dashboard/page.tsx - Uploads dashboard → Share management: renders
app/dashboard/page.tsx - Share management → Share actions: renders cards
components/dashboard/DashboardList.tsx - Share actions → Delete share API: deletes share
- Delete share API → Postgres metadata: deletes record
app/api/dashboard/delete/route.ts - Devices dashboard → Postgres metadata: loads devices
app/dashboard/devices/page.tsx - Devices dashboard → Device management: renders
app/dashboard/devices/page.tsx - Device management → Device client: uses requests
components/devices/DeviceList.tsx - Device client → Device API: registers device
lib/deviceClient.ts - Device management → Device item API: manages device
- Device API → Postgres metadata: reads and writes
app/api/devices/route.ts - Device item API → Postgres metadata: updates device
app/api/devices/[id]/route.ts - Sync engine → Sync API client: pushes and pulls
hooks/useClipboardSync.ts - Sync engine → Sync status provider: sets status
hooks/useClipboardSync.ts - Sync API client → Clipboard API: calls endpoint
lib/clipboardSyncClient.ts - Clipboard API → Postgres metadata: reads and writes
app/api/clipboard/route.ts - Expiry cleanup → Postgres metadata: sweeps expired
app/api/cron/cleanup/route.ts - Expiry cleanup → Cloudinary files: removes files
app/api/cron/cleanup/route.ts