# tiron-ms/wedding_invitation architecture

> Architecture diagram of the GitHub repository tiron-ms/wedding_invitation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tiron-ms/wedding_invitation
- Repository: https://github.com/tiron-ms/wedding_invitation

## Overview

This repository’s visible product is a wedding invitation web app, centered on presenting event details and an interactive countdown/calendar-style invitation. Its supporting runtime includes authentication, gated app-data access, multiplayer code, and an embedded-preview bridge. The README is only a title, so these capabilities are identified from the source tree and excerpts; unsampled implementation details and links are omitted where their wiring is not evidenced.

Main entry points: [`src/components/invitation`](https://github.com/tiron-ms/wedding_invitation/tree/main/src/components/invitation) (Invitation views), [`src/lib/wedding.ts`](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/wedding.ts) (Wedding details), [`src/lib/auth/server.ts`](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/server.ts) (Auth server), [`src/routes/__root.tsx`](https://github.com/tiron-ms/wedding_invitation/blob/main/src/routes/__root.tsx) (Root route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_invitation["Invitation experience"]
  node_invitation_app["Invitation app<br/>[InvitationApp.tsx]"]
  node_invitation_components["Invitation views"]
  node_wedding_data["Wedding details<br/>[wedding.ts]"]
end

subgraph group_runtime["App runtime"]
  node_router["Router<br/>[router.tsx]"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_root_route["Root route<br/>[__root.tsx]"]
  node_home_route["Home route<br/>[index.tsx]"]
end

subgraph group_identity["Authentication"]
  node_auth_provider["Auth provider<br/>[provider.tsx]"]
  node_auth_client["Auth client<br/>[client.ts]"]
  node_auth_server["Auth server<br/>[server.ts]"]
  node_auth_db[("Auth database<br/>[db.ts]")]
  node_gate_sessions["Gate sessions"]
  node_gate_identity["Gate identity"]
  node_auth_providers["OAuth providers<br/>[providers.ts]"]
  node_preview_auth["Preview OAuth<br/>[preview.ts]"]
end

subgraph group_platform["Supporting services"]
  node_app_data["Gated app data<br/>[client.server.ts]"]
  node_request_isolation["Request isolation"]
  node_app_data_guard["Server-only guard<br/>[server-only.ts]"]
  node_multiplayer["Peer multiplayer<br/>[p2p.ts]"]
  node_preview_bridge_ui["Preview bridge mount"]
  node_preview_bridge["Preview bridge"]
  node_embedder_origin["Embedder validation"]
end

node_guest(("Guest"))

node_guest -->|"opens invitation"| node_home_route
node_router -->|"uses routes"| node_route_tree
node_root_route -->|"defines root"| node_route_tree
node_home_route -->|"renders"| node_invitation_app
node_invitation_components -->|"reads event details"| node_wedding_data
node_invitation_components -->|"reads countdown data"| node_wedding_data
node_invitation_components -->|"reads couple data"| node_wedding_data
node_invitation_components -->|"reads scene data"| node_wedding_data
node_invitation_components -->|"uses invitation data"| node_wedding_data
node_root_route -->|"wraps routes"| node_auth_provider
node_root_route -->|"mounts"| node_preview_bridge_ui
node_preview_bridge_ui -->|"installs bridge"| node_preview_bridge
node_preview_bridge -->|"validates parent"| node_embedder_origin
node_auth_client -->|"uses provider list"| node_auth_providers
node_auth_server -->|"initializes persistence"| node_auth_db
node_auth_server -->|"registers sessions"| node_gate_sessions
node_gate_sessions -->|"uses identity sessions"| node_gate_identity
node_auth_server -->|"configures providers"| node_auth_providers
node_auth_server -->|"uses preview credentials"| node_preview_auth
node_app_data -->|"checks same-site"| node_request_isolation
node_app_data -->|"checks server-only"| node_app_data_guard

click node_router "https://github.com/tiron-ms/wedding_invitation/blob/main/src/router.tsx"
click node_route_tree "https://github.com/tiron-ms/wedding_invitation/blob/main/src/routeTree.gen.ts"
click node_root_route "https://github.com/tiron-ms/wedding_invitation/blob/main/src/routes/__root.tsx"
click node_home_route "https://github.com/tiron-ms/wedding_invitation/blob/main/src/routes/index.tsx"
click node_invitation_app "https://github.com/tiron-ms/wedding_invitation/blob/main/src/components/invitation/InvitationApp.tsx"
click node_invitation_components "https://github.com/tiron-ms/wedding_invitation/tree/main/src/components/invitation"
click node_wedding_data "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/wedding.ts"
click node_auth_provider "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/provider.tsx"
click node_auth_client "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/client.ts"
click node_auth_server "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/server.ts"
click node_auth_db "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/db.ts"
click node_gate_sessions "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/gate-session.server.ts"
click node_gate_identity "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/gate-identity.server.ts"
click node_auth_providers "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/providers.ts"
click node_preview_auth "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/preview.ts"
click node_app_data "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/app-data/client.server.ts"
click node_request_isolation "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/isolation.server.ts"
click node_app_data_guard "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/app-data/server-only.ts"
click node_multiplayer "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/multiplayer/p2p.ts"
click node_preview_bridge_ui "https://github.com/tiron-ms/wedding_invitation/blob/main/src/components/preview-host-bridge.tsx"
click node_preview_bridge "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/preview-host-bridge.ts"
click node_embedder_origin "https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/preview-embedder-origin.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_invitation_app,node_invitation_components,node_wedding_data toneBlue
class node_router,node_route_tree,node_root_route,node_home_route toneAmber
class node_auth_provider,node_auth_client,node_auth_server,node_auth_db,node_gate_sessions,node_gate_identity,node_auth_providers,node_preview_auth toneMint
class node_app_data,node_request_isolation,node_app_data_guard,node_multiplayer,node_preview_bridge_ui,node_preview_bridge,node_embedder_origin toneRose
class node_guest toneIndigo
```

## Components

### Invitation experience

- [Invitation app](https://github.com/tiron-ms/wedding_invitation/blob/main/src/components/invitation/InvitationApp.tsx): `src/components/invitation/InvitationApp.tsx`
- [Invitation views](https://github.com/tiron-ms/wedding_invitation/tree/main/src/components/invitation): `src/components/invitation`
- [Wedding details](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/wedding.ts): `src/lib/wedding.ts`

### App runtime

- [Router](https://github.com/tiron-ms/wedding_invitation/blob/main/src/router.tsx): `src/router.tsx`
- [Route tree](https://github.com/tiron-ms/wedding_invitation/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Root route](https://github.com/tiron-ms/wedding_invitation/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [Home route](https://github.com/tiron-ms/wedding_invitation/blob/main/src/routes/index.tsx): `src/routes/index.tsx`

### Authentication

- [Auth provider](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/provider.tsx): `src/lib/auth/provider.tsx`
- [Auth client](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/client.ts): `src/lib/auth/client.ts`
- [Auth server](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/server.ts): `src/lib/auth/server.ts`
- [Auth database](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Gate sessions](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/gate-session.server.ts): `src/lib/auth/gate-session.server.ts`
- [Gate identity](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/gate-identity.server.ts): `src/lib/auth/gate-identity.server.ts`
- [OAuth providers](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/providers.ts): `src/lib/auth/providers.ts`
- [Preview OAuth](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/preview.ts): `src/lib/auth/preview.ts`

### Supporting services

- [Gated app data](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/app-data/client.server.ts): `src/lib/app-data/client.server.ts`
- [Request isolation](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/auth/isolation.server.ts): `src/lib/auth/isolation.server.ts`
- [Server-only guard](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/app-data/server-only.ts): `src/lib/app-data/server-only.ts`
- [Peer multiplayer](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/multiplayer/p2p.ts): `src/lib/multiplayer/p2p.ts`
- [Preview bridge mount](https://github.com/tiron-ms/wedding_invitation/blob/main/src/components/preview-host-bridge.tsx): `src/components/preview-host-bridge.tsx`
- [Preview bridge](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/preview-host-bridge.ts): `src/lib/preview-host-bridge.ts`
- [Embedder validation](https://github.com/tiron-ms/wedding_invitation/blob/main/src/lib/preview-embedder-origin.ts): `src/lib/preview-embedder-origin.ts`

### Other components

- **Guest**

## Connections

- Guest → Home route: opens invitation (evidence: `src/routes/index.tsx`)
- Router → Route tree: uses routes (evidence: `src/router.tsx`)
- Root route → Route tree: defines root (evidence: `src/routeTree.gen.ts`)
- Home route → Invitation app: renders
- Invitation views → Wedding details: reads event details (evidence: `src/components/invitation/Calendar.tsx`)
- Invitation views → Wedding details: reads countdown data (evidence: `src/components/invitation/Countdown.tsx`)
- Invitation views → Wedding details: reads couple data (evidence: `src/components/invitation/CoupleNames.tsx`)
- Invitation views → Wedding details: reads scene data (evidence: `src/components/invitation/FloralScene.tsx`)
- Invitation views → Wedding details: uses invitation data (evidence: `src/components/invitation/Splash.tsx`)
- Root route → Auth provider: wraps routes (evidence: `src/routes/__root.tsx`)
- Root route → Preview bridge mount: mounts (evidence: `src/routes/__root.tsx`)
- Preview bridge mount → Preview bridge: installs bridge (evidence: `src/components/preview-host-bridge.tsx`)
- Preview bridge → Embedder validation: validates parent (evidence: `src/lib/preview-host-bridge.ts`)
- Auth client → OAuth providers: uses provider list (evidence: `src/lib/auth/client.ts`)
- Auth server → Auth database: initializes persistence (evidence: `src/lib/auth/server.ts`)
- Auth server → Gate sessions: registers sessions (evidence: `src/lib/auth/server.ts`)
- Gate sessions → Gate identity: uses identity sessions (evidence: `src/lib/auth/gate-session.server.ts`)
- Auth server → OAuth providers: configures providers (evidence: `src/lib/auth/server.ts`)
- Auth server → Preview OAuth: uses preview credentials (evidence: `src/lib/auth/server.ts`)
- Gated app data → Request isolation: checks same-site (evidence: `src/lib/app-data/client.server.ts`)
- Gated app data → Server-only guard: checks server-only (evidence: `src/lib/app-data/client.server.ts`)
