How sultvnnnn/lyrarium works
Lyrarium is a lyrics archive and discovery site. Visitors search songs and artists, browse catalog and artist pages, then open lyric entries with credits and related media. The home search supports fuzzy suggestions and voice transcription; Lyra provides song insights. Artist and song add/edit routes indicate editorial maintenance, while changelog pages expose archive updates. The sampled sources establish home and lyric-page database reads, search behavior, transcription forwarding, and Lyra caching/streaming; other route wiring is left unspecified where source excerpts were unavailable.
Main entry points: index.ts Database Client · app/page.tsx Home · hero-search.tsx Search Interface · [id]/page.tsx Lyrics Entry
Components 25
Discovery & Catalog
- Home
src/app/page.tsx - Search Interface
src/components/hero-search.tsx - Song Catalog
src/app/songs/page.tsx - Artist Catalog
src/app/artists/page.tsx - Artist Profile
src/app/artist/[slug]/page.tsx
Lyrics & Editorial
- Lyrics Entry
src/app/lyrics/[id]/page.tsx - Song Editing
src/components/edit-song-form.tsx - Artist Editing
src/components/edit-artist-form.tsx - Song Actions
src/app/actions/songs.tsx - Artist Actions
src/app/actions/artists.ts - Changelog
src/app/changelog/page.tsx - Video Link Parser
src/lib/youtube.ts
Search & Insights
- Fuzzy Search
src/lib/search-engine.ts - Trigram Matching
src/lib/fuzzy.ts - Voice Transcription
src/app/api/transcribe/route.ts - Lyra Interface
src/components/ask-lyra.tsx - Lyra Endpoint
src/app/api/lyra/route.ts - Lyra Provider
src/lib/lyra.ts
Data & Media
- Database Client
src/db/index.ts - Archive Database
src/db/schema.ts - Image Storage
src/lib/supabase-storage.ts
Other components
- Visitor
- Groq Whisper
- AI Provider
- Supabase Storage
Connections 20
- Visitor → Home: opens
- Visitor → Song Catalog: browses
- Visitor → Artist Catalog: browses
- Visitor → Artist Profile: opens
- Visitor → Lyrics Entry: opens
- Visitor → Search Interface: queries
- Home → Database Client: reads archive
- Home → Fuzzy Search: searches results
- Search Interface → Fuzzy Search: matches query
- Fuzzy Search → Trigram Matching: builds suggestions
- Search Interface → Voice Transcription: posts audio
- Voice Transcription → Groq Whisper: forwards audio
- Lyrics Entry → Database Client: reads entry
- Lyrics Entry → Video Link Parser: parses video links
- Lyra Interface → Lyra Endpoint: requests insight
- Lyra Endpoint → Database Client: reads and caches
- Lyra Endpoint → Lyra Provider: streams response
- Lyra Provider → AI Provider: requests generation
- Database Client → Archive Database: queries
- Image Storage → Supabase Storage: uploads images