🎙️ YO Voice

---

🌌 About

YO Voice is a modern cross-platform voice communication platform built with cutting-edge web technologies.

The official website serves as the public face of the project, allowing users to:

• Learn about YO Voice
• Explore features
• Download desktop and mobile applications
• Create an account
• Access their downloads
• Stay updated with product news and roadmap

---

🚀 Tech Stack

• Next.js 16.3.4
• React 19
• TypeScript
• Tailwind CSS
• Firebase
• Framer Motion
• OGL (the homepage's 3D phone, loaded lazily)
• Vercel

---

📁 Project Structure

src/
├── app/
├── components/
├── config/
├── content/
├── hooks/
├── lib/
├── providers/
├── services/
├── store/
├── styles/
└── types/

---

✨ Features

Marketing

• Modern Landing Page
• Feature Showcase
• Interactive Animations
• FAQ
• Roadmap page
• Blog

Authentication

• Sign In
• Register
• Continue with Google / Continue with Apple on both (popup; Apple is "Coming soon" when the provider is not configured)
• Password Recovery
• Email Verification (sent on register, resend from /verify-email; Google and Apple accounts arrive verified and skip it)

All backed by Firebase Authentication (email/password, Google, Apple) on the Flutter app's project (yovoice-ec54a) — one account works everywhere. Google and Apple popups finish on Firebase's own handler, https://yovoice-ec54a.firebaseapp.com/__/auth/handler (the SDK authDomain is derived from the project id; auth.yovoice.app is not a registered Google redirect URI). Provider set-up and the owner's console steps: docs/security/security-notes.md, "Sign-in providers".

User Portal (/account/*)

• Profile (display name)
• Security (change password, change email — both require re-authentication; a Google- or Apple-only account, which has no password, is told so and given the support route for an email change)
• Devices & Sessions (current-session info only; a full multi-device registry needs backend work — see Known Limitations)
• Notifications (placeholder — needs a Firestore preferences schema)
• Downloads

Download Center (/download, post-login)

• Web (works today — links straight to the Flutter web app)
• Windows / macOS — honest "not published yet" state linking to GitHub Releases, not a fabricated installer link
• Mobile — "coming soon", links to the GitHub repo

---

🚀 Getting Started

npm install
cp .env.example .env.local   # fill in Firebase config, see below
npm run dev

Requires Node 20.9 or newer. Uses Turbopack (next dev/next build).

npm run lint     # ESLint
npm run build    # production build (also runs the TypeScript check)

---

🔑 Environment Variables

All Firebase config is NEXT_PUBLIC_* (safe to expose — this is the standard Firebase Web SDK client config, not a secret) and comes from the same Firebase project as the Flutter app (yovoice-ec54a, "yo_voice (web)" app), so the same account works across the marketing site, the account pages, and the actual app.

Variable	Purpose
NEXT_PUBLIC_FIREBASE_API_KEY	Firebase Web SDK config
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN	No longer read (since 2026-09-24). The SDK's authDomain is always <PROJECT_ID>.firebaseapp.com (src/lib/firebase/auth-domain.ts): Google rejects auth.yovoice.app/__/auth/handler with redirect_uri_mismatch. A value left in Vercel is ignored and can be deleted.
NEXT_PUBLIC_FIREBASE_PROJECT_ID	yovoice-ec54a
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET	Firebase Web SDK config
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID	Firebase Web SDK config
NEXT_PUBLIC_FIREBASE_APP_ID	Firebase Web SDK config
NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID	Firebase Analytics
NEXT_PUBLIC_APP_URL	Where "Launch Web App" / post-login redirects send signed-in users. Canonical production URL: https://app.yovoice.app

Set these locally in .env.local (gitignored) and in Vercel via vercel env add <NAME> <environment> for production, preview, and development — all three, since Next reads different files depending on the run context.

---

☁️ Deployment

• Hosting: Vercel, project yo-voice/yovoice-website, auto-deploys on push to main.
• Local ↔ Vercel link: vercel link (already linked to yo-voice/yovoice-website); vercel env pull .env.local to sync env vars locally.
• DNS: yovoice.app is on Cloudflare. app.yovoice.app is the live, canonical Flutter web application domain and points to Firebase Hosting.

---

⚠️ Known Limitations

• Devices & Sessions only shows the current browser session. Firebase Auth's client SDK has no API for listing/revoking sessions on other devices — that needs a backend session registry, not implemented.
• Notifications page is a placeholder — no Firestore preferences schema exists yet for it to read/write.
• Desktop/mobile installers aren't published — the download center is honest about this rather than linking to store pages that don't exist.

---

🎨 Design Philosophy

YO Voice combines

• modern UI
• premium animations
• immersive interactions
• clean typography
• responsive layouts

to create a memorable first impression.

---

🔐 Authentication Flow

Desktop:

Landing Page
      ↓
Download
      ↓
Login
      ↓
Dashboard
      ↓
Download Installer

Mobile:

Landing Page
      ↓
Download
      ↓
Google Play / App Store

App launch hand-off:

• /app redirects immediately to the configured Flutter app origin with location.replace().
• The marketing site intentionally owns no loading animation or minimum timeline. Direct entry and landing-page entry use the app's single real startup surface while the Flutter engine initializes.

---

📅 Roadmap

• Landing Page
• Hero Animation
• Community Showcase
• Download Center
• User Dashboard
• Blog
• SEO
• Analytics
• Production Release

---

🛡 License

Private repository.

All rights reserved.

---