Swiftiepedia

The Taylor Swift Encyclopedia for Swifties. Every song, lyric, songwriter credit, easter egg, and cultural moment — mapped into an interactive experience.

Live at swiftiepedia.com

Features

Core Experience

• Interactive Galaxy — Force-directed graph of 283 songs across 16 studio albums
• Universe — 3D visualization of every connection across the catalog
• Discover — Sortable, filterable table covering streams, eras, moods, and chart performance
• AI Chat (SwiftAI) — Grok-powered analysis of every song, album, era, sample, and listening path

Daily Engagement

• Song Battles — Daily "This or That" matchup. Same battle for everyone. Streaks + shareable results
• Daily Trivia — One Taylor Swift trivia question per day plus a 10-question weekly quiz
• Daily Polls — Community polls answered by Swifties across the world
• Taste Profile Quiz — Find your Swiftie archetype, get a curated playlist, share with a dynamic OG card

Content

• 16 Album Pages — Deep analysis, tracklists, era context, Spotify embeds, streaming links
• 283 Song Pages — Meanings, lyrical highlights, cultural impact, production credits, Spotify embeds, ratings, community takes
• Songwriter & Producer Pages — Individual /songwriter/[slug] and /producer/[slug] pages with discographies
• Eras Tour Hub — Setlists, surprise songs, tour stats
• Featured Artists — Collaborators across the catalog
• Easter Eggs & Lore — Threaded long-form analysis of Taylor's references and storytelling
• Timeline — Career milestones from her debut through The Life of a Showgirl
• Blog — SEO-targeted long-form articles
• Listening Paths — Curated journeys through the catalog

Community

• Song Ratings — 1-5 stars on every song page (Supabase)
• Short Takes — 280-character community comments
• Favorites — Pick your top Taylor songs; powers AI personalization
• Setlist Builder — Build and share your dream Eras Tour setlist
• Album Ranker — Rank Taylor's albums and share your tier list
• Leaderboard — Top Swifties by trivia, battles, and engagement
• User Profiles — /profile with favorites and account settings
• Social Login — Google + X/Twitter OAuth via Supabase

SEO & Sharing

• Dynamic OG Images — Every page type has a custom social preview card
• JSON-LD Structured Data — On all major page types for AI search engines
• Sitemap & RSS — Every route + blog feed
• PWA Manifest — Installable on mobile home screens with offline fallback

Tech Stack

• Framework: Next.js 16 (App Router, TypeScript, Tailwind CSS 4)
• Visualization: react-force-graph-2d / 3d (canvas + WebGL)
• Animation: Framer Motion
• AI: xAI Grok API
• Auth & DB: Supabase (email/password + Google/Twitter OAuth, RLS-protected tables)
• Payments: Stripe (Swiftiepedia Pro: monthly / annual / lifetime)
• Music Embeds: Spotify iframe embeds
• Analytics: PostHog + Vercel Analytics + Speed Insights
• Deployment: Vercel
• Domain: swiftiepedia.com

Environment Variables

# Required
XAI_API_KEY=                        # xAI/Grok API key
STRIPE_SECRET_KEY=                  # Stripe secret key
NEXT_PUBLIC_SUPABASE_URL=           # Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY=      # Supabase anon/public key
SUPABASE_SERVICE_ROLE_KEY=          # Supabase service role key

# Optional
STRIPE_PRICE_MONTHLY=               # Stripe price ID for monthly plan
STRIPE_PRICE_ANNUAL=                # Stripe price ID for annual plan
STRIPE_PRICE_LIFETIME=              # Stripe price ID for lifetime plan
NEXT_PUBLIC_POSTHOG_KEY=            # PostHog analytics key
NEXT_PUBLIC_POSTHOG_HOST=           # PostHog host URL

Development

npm install
npm run dev

Open http://localhost:3000.

Branding

All brand strings and the canonical site URL live in src/lib/site-config.ts. To rename or move the site, update values there — load-bearing files (app/layout.tsx, app/sitemap.ts, app/robots.ts, app/manifest.ts, app/feed.xml/route.ts, lib/og-layout.tsx) all read from it.

License

Private project. All rights reserved. Not affiliated with Taylor Swift or Republic Records.