How tiron-ms/wedding_invitation works
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: invitation Invitation views · wedding.ts Wedding details · server.ts Auth server · __root.tsx Root route
Components 23
Invitation experience
- Invitation app
src/components/invitation/InvitationApp.tsx - Invitation views
src/components/invitation - Wedding details
src/lib/wedding.ts
App runtime
- Router
src/router.tsx - Route tree
src/routeTree.gen.ts - Root route
src/routes/__root.tsx - Home route
src/routes/index.tsx
Authentication
- Auth provider
src/lib/auth/provider.tsx - Auth client
src/lib/auth/client.ts - Auth server
src/lib/auth/server.ts - Auth database
src/lib/db.ts - Gate sessions
src/lib/auth/gate-session.server.ts - Gate identity
src/lib/auth/gate-identity.server.ts - OAuth providers
src/lib/auth/providers.ts - Preview OAuth
src/lib/auth/preview.ts
Supporting services
- Gated app data
src/lib/app-data/client.server.ts - Request isolation
src/lib/auth/isolation.server.ts - Server-only guard
src/lib/app-data/server-only.ts - Peer multiplayer
src/lib/multiplayer/p2p.ts - Preview bridge mount
src/components/preview-host-bridge.tsx - Preview bridge
src/lib/preview-host-bridge.ts - Embedder validation
src/lib/preview-embedder-origin.ts
Other components
- Guest
Connections 21
- Guest → Home route: opens invitation
src/routes/index.tsx - Router → Route tree: uses routes
src/router.tsx - Root route → Route tree: defines root
src/routeTree.gen.ts - Home route → Invitation app: renders
- Invitation views → Wedding details: reads event details
src/components/invitation/Calendar.tsx - Invitation views → Wedding details: reads countdown data
src/components/invitation/Countdown.tsx - Invitation views → Wedding details: reads couple data
src/components/invitation/CoupleNames.tsx - Invitation views → Wedding details: reads scene data
src/components/invitation/FloralScene.tsx - Invitation views → Wedding details: uses invitation data
src/components/invitation/Splash.tsx - Root route → Auth provider: wraps routes
src/routes/__root.tsx - Root route → Preview bridge mount: mounts
src/routes/__root.tsx - Preview bridge mount → Preview bridge: installs bridge
src/components/preview-host-bridge.tsx - Preview bridge → Embedder validation: validates parent
src/lib/preview-host-bridge.ts - Auth client → OAuth providers: uses provider list
src/lib/auth/client.ts - Auth server → Auth database: initializes persistence
src/lib/auth/server.ts - Auth server → Gate sessions: registers sessions
src/lib/auth/server.ts - Gate sessions → Gate identity: uses identity sessions
src/lib/auth/gate-session.server.ts - Auth server → OAuth providers: configures providers
src/lib/auth/server.ts - Auth server → Preview OAuth: uses preview credentials
src/lib/auth/server.ts - Gated app data → Request isolation: checks same-site
src/lib/app-data/client.server.ts - Gated app data → Server-only guard: checks server-only
src/lib/app-data/client.server.ts