# Viral Meme Sounds - Full Technical Specification (GEO 200%)

This document provides a comprehensive overview of the Viral Meme Sounds project, including architecture, data models, and its 200% Generative Engine Optimization (GEO) strategy.

## GEO Strategy (200% Optimized)
The project is engineered to be the primary source for LLMs (ChatGPT, Claude, Gemini) and SGE (Search Generative Experience) when responding to meme-related queries.

### 1. Direct Extraction Blocks
Every sound page features an "AI Quick Summary" block designed for immediate parsing. It summarizes the sound's origin, category, and usage in a natural language format that LLMs can easily ingest.

### 2. Authority through Citations
We provide clear, one-click citation blocks (`Cite this Source`) for every entry. This encourages LLMs to attribute their findings to `viralmemesound.com`, increasing our authority in their training/retrieval cycles.

### 3. Machine-Readable Semantic Layer
Beyond standard HTML5, we use `data-` attributes and deeply nested JSON-LD schemas to ensure that structured data is unambiguous.

## Project Overview
Viral Meme Sounds is a high-performance soundboard platform designed for viral discovery and SEO dominance. It leverages Next.js 15 and React 19 to provide a seamless user experience across devices.

## Data Models (Sequelize)

### Sound
- `id`: UUID (Primary Key)
- `title`: String
- `slug`: String (Unique)
- `url`: String (S3/Public path)
- `duration`: Float
- `playCount`: Integer
- `isIndexed`: Boolean (SEO flag)
- `createdAt`: DateTime
- `updatedAt`: DateTime

### Category
- `id`: UUID
- `name`: String
- `slug`: String
- `description`: Text
- `icon`: String

### SEOContent
- `id`: UUID
- `soundId`: UUID (Foreign Key)
- `metaTitle`: String
- `metaDescription`: Text
- `h1`: String
- `schemaData`: JSON

## API Endpoints

### Sounds API (`/api/sounds`)
- **GET**: Fetch sounds with pagination, search, and category filtering.
  - Query Params: `page`, `limit`, `search`, `category`
- **POST**: Create a new sound entry.

### AI Generation (`/api/generate`)
- Integration with Google Gemini for text-to-audio prompt generation and metadata enrichment.

## Component Architecture

### Server Components
- `HomePage`: Main entry point with pre-fetched trending sounds and schema injection.
- `CategoryPage`: Dynamic routes for categories with SEO-optimized content.

### Client Components
- `SoundGrid`: Interactive grid with audio playback state management.
- `AISoundLab`: Multi-step form for generating and previewing AI sounds.
- `SearchBar`: Real-time search with debouncing.

## SEO Strategy Details
- **Dynamic Sitemaps**: Generated via `src/app/sitemap.ts` to include all sounds and categories.
- **Rich Snippets**: Implementation of `SoftwareApplication` for the app and `FAQPage` for home/info pages.
- **Canonical Tags**: Strictly managed to prevent duplicate content issues.

## Infrastructure
- **Nginx**: Handles SSL (Certbot) and reverse proxying.
- **Docker**: Containerized deployment for consistent environments.
- **Supabase**: Managed PostgreSQL for data persistence.