How hmddevs/hmd-bio works
HMD.bio is a URL-shortening and link-analytics platform. Visitors submit destinations for short links, then follow a short URL through the edge proxy to resolution and click recording. Registered users manage links, review analytics, and attach verified custom domains; the REST API and admin dashboard expose additional management capabilities. The graph includes the documented dashboard, bookmarklet, previews, QR codes, bulk/export, and admin capabilities. Some UI-to-handler wiring is not shown in the sampled source, so those links are omitted.
Main entry points: domains Domain Management API · route.ts Link Resolver · Link.ts Link Records · Click.ts Click Records
Components 25
User Experience
- Public Pages
src/app/page.tsx - User Dashboard
src/app/dashboard - Preview and Stats
src/app/preview/[keyword]/page.tsx - Bookmarklet
src/app/bookmarklet/page.tsx
Link Lifecycle
- Shorten Endpoint
src/app/api/v1/shorten/route.ts - Link Management API
src/app/api/v1/links - Edge Redirect
src/proxy.ts - Link Resolver
src/app/api/internal/resolve/route.ts - Link Records
src/models/Link.ts - Redirect Cache
src/lib/link-cache.ts
Identity and API
- Signup and Login
src/app/api/v1/auth - Authentication Services
src/lib/auth.ts
Custom Domains
- Domain Management API
src/app/api/v1/domains - Domain Services
src/lib/domains.ts - Domain Config Route
src/app/api/internal/domain-config/route.ts - Vercel Domains
Analytics and Admin
- Click Records
src/models/Click.ts - Analytics API
src/app/api/v1/stats - Admin Dashboard
src/app/admin/(dashboard) - Admin API
src/app/api/v1/admin
Other components
- Visitor
- Account User
- API Caller
- MongoDB
- DNS
Connections 30
- Visitor → Public Pages: opens pages
- Visitor → Edge Redirect: follows short URL
- Account User → User Dashboard: manages links
- Account User → Signup and Login: registers or signs in
- API Caller → Shorten Endpoint: submits URL
- API Caller → Link Management API: manages links
- Shorten Endpoint → Link Records: creates link
- Shorten Endpoint → Redirect Cache: invalidates entry
- Link Management API → Link Records: reads and updates
- Link Management API → Redirect Cache: invalidates entries
- Edge Redirect → Link Resolver: requests resolution
- Edge Redirect → Domain Config Route: requests domain config
- Link Resolver → Link Records: looks up link
- Link Resolver → Click Records: records click
- Link Resolver → Redirect Cache: refreshes entry
- Signup and Login → Authentication Services: authenticates
- Domain Management API → Domain Services: uses domain logic
- Domain Management API → MongoDB: reads and writes domains
- Domain Management API → Vercel Domains: attaches or removes
- Domain Management API → DNS: provides verification records
- Domain Config Route → Domain Services: loads config
- Domain Config Route → MongoDB: reads domain config
- Preview and Stats → Analytics API: displays analytics
- Analytics API → Click Records: reads click data
- User Dashboard → Admin Dashboard
- Admin Dashboard → Admin API: manages users and domains
- Admin API → Click Records: reads click records
- Admin API → MongoDB: queries records
- Link Records → MongoDB: persists links
- Click Records → MongoDB: persists clicks