# LyricsLingua - AI Agent Navigation Map

LyricsLingua is a platform that empowers music fans to understand any song by providing high-quality, AI-powered lyric translations across 50+ languages. Browse the structured links below to explore our documentation and key features.

## Core Pages

### Home & Entry Points
- https://lyricslingua.com/ - Main homepage with song search, feature overview, and quick translation access
- https://lyricslingua.com/search - Search interface for discovering and translating songs
- https://lyricslingua.com/login - User authentication and sign-in portal

### User Features
- https://lyricslingua.com/me - Personal dashboard for viewing your translation history and token balance
- https://lyricslingua.com/discover/page-1 - Discover trending community translations sorted by recency
- https://lyricslingua.com/translation/languages - Browse all translations organized by language (50+ languages supported)
- https://lyricslingua.com/translation/releases - Explore translations grouped by music release year
- https://lyricslingua.com/artists - Curated artist library with discography and translated tracks

### Monetization
- https://lyricslingua.com/pricing - Token pricing and purchase options (GPT-3.5: 1 token, GPT-4: 3 tokens per translation)
- https://lyricslingua.com/me/email/subscription - Email subscription and notification preferences

### Information & Policies
- https://lyricslingua.com/about - Platform mission, how it works, and community-driven features
- https://lyricslingua.com/privacy - Privacy policy covering data collection, processing, and user rights
- https://lyricslingua.com/terms - Terms of Service including user conduct, payments, and content ownership
- https://lyricslingua.com/contact - Contact form for support inquiries

## Key Features

### Song Translation
- AI-powered translations using GPT-3.5 (1 token) or GPT-4 (3 tokens) models
- Support for 50+ languages with automatic language selection
- Real-time streaming translation interface
- Community-driven translation sharing

### Discovery & Browsing
- Trending translations feed updated in real-time
- Browse by language for focused exploration
- Browse by release year for era-specific discoveries
- Artist-centric navigation with discography highlights
- Like/favorite functionality for community engagement

### User Management
- OAuth authentication (GitHub, Google, Twitter/X, Discord, LinkedIn)
- Token-based digital currency system
- Translation history and library management
- Email notifications for account activity and promotional content


## Technical Integration Points

### Authentication
- Supports social sign-in: GitHub, Google, Twitter/X, Discord, LinkedIn
- Session management via @sidebase/nuxt-auth
- Token-based authorization for API endpoints

### Payments
- Stripe payment processing with embedded Buy Buttons
- Token package tiers: 20, 50, 100 tokens
- Automatic token balance updates via webhook

### Email & Marketing
- Welcome emails and coupon distribution via Resend
- Community engagement via Listmonk
- Cron-based reminder emails for token holders
- Newsletter subscription management

### AI & Content
- OpenAI GPT-3.5 and GPT-4 integration for translations
- Genius API for song search and metadata
- LRCLib integration for lyrics database
- Streaming translation responses

## Deployment & Architecture

- Built with Nuxt 3 (Vue 3, TypeScript)
- Serverless deployment on Vercel edge + functions
- MongoDB database for persistent storage
- Tailwind CSS for responsive UI styling
- Real-time streaming with Vercel AI SDK