# Pod-Master site map (for humans and AI assistants)

Live origin: `https://www.pod-master.online`  
Machine index: `https://www.pod-master.online/llms.txt`  
XML sitemap: `https://www.pod-master.online/sitemap.xml`  
In-app how-to: `https://www.pod-master.online/help`  
This file (same content): `/site-map.md` on the live site, `SITE_MAP.md` in the repo.

Use this document to learn **what exists**, **who can see it**, **what the page is for**, and **how chrome is laid out**. Do not invent routes. If a path is not listed, it is not a product surface (or it is an API).

---

## Product in one line

Pod-Master is a two-sided podcast relationship app: Guest identity → Discover → apply → accept → schedule → record → credibility scores → Relationships history. Hosts publish opportunities (Host Pro).

## Global chrome (every page)

| Element | Where | Notes |
|---------|--------|--------|
| **Claudia** | Fixed **bottom-right** round avatar, `z-index` above app chrome | Opens greeting + task buttons. Tasks: Ask a question (3/day, signed-in, User Guide only); Fill from LinkedIn (page-aware Guest vs Host); Create an opportunity (**registered Hosts only**). Back returns to buttons. |
| Theme | `html` + ThemeProvider | Light/dark; boot script before paint. |
| Fonts | Display Newsreader, UI Source Sans 3 | Warm studio, not generic SaaS purple. |
| Role colors | `data-role="guest"` or `data-role="host"` on signed-in shell | Guest slate-teal, Host ochre; shared warm wall/ink. |

Do not treat Claudia as a general chatbot. Scope and guardrails: User Guide `/help` section “Using Claudia”.

---

## Layout families

### 1) Marketing / public shell
**Nav:** top bar (`PublicNav`) — logo → `/`, Discover, Android, Contact, Sign in.  
**Footer:** logo, Discover, Android, Guide, Contact, Terms, Privacy, **X** + **LinkedIn** icons, ©.  
**Pages:** `/`, `/browse`, `/browse/[id]`, `/download`, `/help`, `/login`, `/register`, `/contact`, `/terms`, `/privacy`, `/cookies`, `/host-upgrade`.

### 2) Compliance / legal shell
Same public nav; centered article `max-w-3xl`; compliance footer (Terms, Privacy, Contact, Cookies).

### 3) Signed-in app shell (`DashboardLayout`)
Full-height: **left sidebar** (desktop `w-64`, collapsible to icon rail; mobile drawer) + **main workspace** (scrolls independently).  
Sidebar brand → app home (`/dashboard` Guest, `/podcasts` Host).  
**Navigate** (role-specific) then **Account** (Settings, User Guide, notifications, community counts, Sign out).  
Claudia FAB still bottom-right over the workspace.

---

## Informational / public areas

| Path | Purpose | Layout |
|------|---------|--------|
| `/` | Marketing landing: hero, how it works, Host Pro, CTAs | Public nav over hero; footer |
| `/browse` | Discover listings (public) | Public nav; search + category chips; cards |
| `/browse/[id]` | One opportunity detail + apply (auth to apply) | Public or app depending on session |
| `/help` | **User Guide** (Guest / Host tabs) | Public nav; sticky Guest/Host tabs; long-form steps |
| `/download` | Android APK | Public nav + footer |
| `/contact` | Support form + email + social | Compliance shell |
| `/terms` `/privacy` `/cookies` | Legal | Compliance shell |
| `/host-upgrade` | Host Pro plans / Become a Host | Public/marketing |
| `/login` `/register` | Auth (email, Google) | Centered form; link to User Guide |
| `/reset-password` | Password reset | Auth form |
| `/invite/[token]` | Claim a guest invite | Token landing |

Canonical help URL: `https://www.pod-master.online/help`.

---

## Guest app (signed in)

Home after sign-in: **`/dashboard`** (Workspace).

| Path | Sidebar label | Purpose |
|------|---------------|---------|
| `/dashboard` | Workspace | Suggested next steps |
| `/guest-profile` | Podcast Identity | Guest media kit (required before apply). Claudia LinkedIn fill targets **Guest** fields here. |
| `/browse` | Discover | Find shows, apply |
| `/applications` | Applications | Live pipeline (My Applications) |
| `/bookings` | (legacy/alias of applications tabs) | Prefer `/applications` |
| `/relationships` | Relationships | History only (declined / scored / cancelled) |
| `/messages` | Messages | List of booking threads |
| `/messages/[bookingId]` | — | One thread |
| `/reviews` | Credibility | Scoring desk |
| `/reviews/[bookingId]` | — | Score Host or Guest for a session |
| `/notifications` | Bell | In-app notifications |
| `/settings` | Settings | Account, roles, calendar, delete |
| `/help` | User Guide | Same public guide |
| `/onboarding` | — | Redirects to `/guest-profile` |
| `/profile` | — | Redirects toward identity/settings |

**Guest sidebar order:** Workspace → Podcast Identity → Discover → Applications → Relationships → Messages → Credibility.

---

## Host app (pending host or Host Pro)

Home after Host Pro: **`/podcasts`** (Host Workspace). Guests who complete the host wizard but not checkout are **pending host** (listings paywalled).

| Path | Sidebar label | Purpose |
|------|---------------|---------|
| `/podcasts` | Host Workspace | Listings home |
| `/podcasts/new` | — | Create opportunity. Claudia **Create an opportunity** applies here. |
| `/podcasts/[id]/edit` | — | Edit listing |
| `/guests` | Guest Directory | Host-only guest search / shortlist |
| `/host-profile` | Host Profile | Show/host bio. Claudia LinkedIn fill targets **Host** fields here. |
| `/host-profile/create` | — | Host Profile wizard (nav may lock until complete) |
| `/host-upgrade/checkout` | — | PayPal Host Pro checkout |
| `/upgrade/host` | — | Alias toward host upgrade |

Host sidebar **also includes** Guest destinations (Workspace, Podcast Identity, Discover, Applications inbound+outbound, Relationships, Messages, Credibility).

**Host-only Claudia button:** Create an opportunity — hidden from Guests.

---

## Claudia page binding

| User is on | Fill from LinkedIn | Create an opportunity |
|------------|--------------------|------------------------|
| `/guest-profile` | Guest Podcast Identity fields | Hidden unless registered Host |
| `/host-profile` | Host name, bio, region | Hidden unless registered Host |
| `/podcasts/new` | Asks to open Guest/Host profile | Brief → Q&A → draft name/description/category/website → review → submit |
| Anywhere else | Prompts to open Guest Identity or Host Profile | Hosts: prompts to open Create opportunity |

LinkedIn: paste `linkedin.com/in/…`. If auto-read is blocked, paste About + Experience. User must **Apply all** / save the real form. Claudia does not fill date of birth, availability bands, or appearance links.

---

## Auth & membership

- Everyone starts as **Guest**.
- **pending_host**: wizard complete, Host Pro not active — can see host nav; creating listings requires Host Pro.
- **host_pro**: paid (PayPal) or staff grant — full host features.
- Signed-in users hitting `/` are redirected to Guest or Host home.
- APIs under `/api/*` are not informational pages (auth, webhooks, cron, Claudia chat). Do not scrape them for content.

---

## Visual system (layout, not copy)

- Shared room: warm wall `#E8E2D9`, wood, ink `#1C1916`.
- Host accent: burnt ochre. Guest accent: slate-teal.
- Claudia / help / settings stay role-neutral wood-ink unless the page is clearly Guest or Host work.
- Prefer existing daisyUI + product tokens; do not introduce a second design system.

---

## Social (footer)

- X: `https://x.com/Pod_Master_OG`
- LinkedIn (founder): `https://www.linkedin.com/in/clinton-fourie-75883b431/`

---

## What not to do (AI)

- Do not add navigation items that are not in this map.
- Do not expose Host Directory or Create opportunity to Guests.
- Do not send Claudia off-topic questions; 3 User Guide questions/day.
- Do not treat `/legal/*` as the primary legal URLs — use `/terms`, `/privacy`, `/cookies`, `/contact`.
- Prefer live code over `docs/ARCHITECTURE.md` (stale). Engineering index: `docs/README.md`.