How m-3-blue/phonkhub works
PhonkHub is a community site for browsing music tracks and participating in discussions, with accounts, profiles, follows, reactions, and uploads. Its principal user flow is browsing a track and interacting through comments or votes; the repository also exposes forum, notification, and moderation capabilities. The sampled API handlers directly access Turso, and uploads also use Vercel Blob. The HTML files and several API handlers were not excerpted, so frontend-to-endpoint wiring and some subsystem relationships remain unverified.
Main entry points: track.html Track page · profile.html Profile page · upload.js Image upload · index.html Site pages
Components 24
Web experience
- Site pages
index.html - Track page
track.html - Profile page
profile.html - Forum pages
forums.html - Login and signup
login.html
Accounts and profiles
- Authentication
api/auth.js - Profile management
api/profile.js - User activity
api/users.js - Follow users
api/follow.js - Image upload
api/upload.js
Music community
- Home feed
api/home.js - Track catalog
api/tracks.js - Track details
api/track-page.js - Track comments
api/comments.js - Track votes
api/votes.js
Forums and engagement
- Forum browsing
api/forums.js - Forum posts
api/forum-post.js - Forum votes
api/forum-vote.js - Emoji reactions
api/react.js - Notifications
api/notifications.js - Lockdown status
api/lockdown-status.js
Other components
- Visitor
- Turso database
- Vercel Blob
Connections 25
- Visitor → Site pages: browses
- Visitor → Track page: opens
- Visitor → Profile page: views
- Visitor → Forum pages: visits
- Visitor → Login and signup: signs in
- Track page → Track details: requests details
- Track page → Track comments: requests comments
- Track page → Track votes: requests votes
- Profile page → Profile management: requests profile
- Profile page → User activity: requests activity
- Login and signup → Authentication: submits credentials
- Forum pages → Forum browsing: requests threads
- Site pages → Home feed: requests feed
- Authentication → Turso database: reads and writes
api/auth.js - Track comments → Turso database: reads and writes
api/comments.js - Forum posts → Turso database: reads and writes
api/forum-post.js - Forum browsing → Turso database: reads
api/forums.js - Profile management → Turso database: reads and writes
api/profile.js - User activity → Turso database: reads
api/users.js - Follow users → Turso database: reads and writes
api/follow.js - Image upload → Turso database: reads and writes
api/upload.js - Image upload → Vercel Blob: uploads image
api/upload.js - Emoji reactions → Turso database: reads and writes
api/react.js - Track votes → Turso database: reads and writes
api/votes.js - Forum votes → Turso database: reads and writes
api/forum-vote.js