How opeoluwa-muritala/vent works
Vent is a multiplatform conference companion: attendees sign in, browse sessions, reserve seats, check in, and use quests and passes; organizers configure events, manage attendees, plan seating, and control sessions. The shared Compose app routes users into feature screens and uses view-model, API, and local-store layers; the Ktor service exposes authenticated event and schedule operations backed by PostgreSQL. The README documents offline Android use and server-backed web/iOS sign-in. Some feature-to-service details are unsampled, so those links are omitted rather than inferred.
Main entry points: VentApp.kt App navigation · Main.kt HTTP application · VentViewModel.kt App state · AuthFlow.kt Sign-in flow
Components 23
Multiplatform client
- App navigation
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - Sign-in flow
frontend/composeApp/src/commonMain/kotlin/app/vent/AuthFlow.kt - App state
frontend/composeApp/src/commonMain/kotlin/app/vent/VentViewModel.kt - API client
frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentApiClient.kt - Local state
frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentLocalStore.kt - Preference sync
frontend/composeApp/src/commonMain/kotlin/app/vent/data/SyncingVentLocalStore.kt
Event experiences
- Session agenda
frontend/composeApp/src/commonMain/kotlin/app/vent/SessionsHome.kt - Seat selection
frontend/composeApp/src/commonMain/kotlin/app/vent/SeatSelectionScreen.kt - Organizer tools
frontend/composeApp/src/commonMain/kotlin/app/vent/OrganizerOperations.kt - Summit pass
frontend/composeApp/src/commonMain/kotlin/app/vent/SummitSession.kt - Check-in scanner
frontend/composeApp/src/commonMain/kotlin/app/vent/scanner/ScannerViewModel.kt - Attendee import
frontend/composeApp/src/commonMain/kotlin/app/vent/imports/AttendeeImportViewModel.kt
Shared domain
- API contracts
shared-api/src/commonMain/kotlin/app/vent/api/Contracts.kt - Domain rules
shared-domain/src/commonMain/kotlin/app/vent/domain/Rules.kt - Event palette
shared-domain/src/commonMain/kotlin/app/vent/domain/EventPalette.kt
Ktor service
- HTTP application
server/src/main/kotlin/app/vent/server/Main.kt - Event routes
server/src/main/kotlin/app/vent/server/VentRoutes.kt - Authentication
server/src/main/kotlin/app/vent/server/AuthService.kt
Persistence
- Schedule repository
server/src/main/kotlin/app/vent/server/ScheduleRepository.kt - Auth repository
server/src/main/kotlin/app/vent/server/AuthRepository.kt - PostgreSQL
server/src/main/kotlin/app/vent/server/DatabaseFactory.kt
Other components
- Attendee
- Organizer
Connections 25
- Attendee → Sign-in flow: signs in
README.md - Organizer → Sign-in flow: signs in
README.md - Sign-in flow → App navigation: enters app
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - App navigation → App state: creates state
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - App navigation → Session agenda: routes to
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - App navigation → Seat selection: routes to
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - App navigation → Organizer tools: routes to
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - App navigation → Summit pass: routes to
frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt - App state → Local state: uses state
- App state → API client: requests data
- Preference sync → Local state: syncs state
- API client → HTTP application: calls API
README.md - HTTP application → PostgreSQL: connects
server/src/main/kotlin/app/vent/server/Main.kt - HTTP application → Authentication: handles auth
server/src/main/kotlin/app/vent/server/Main.kt - HTTP application → Event routes: registers routes
server/src/main/kotlin/app/vent/server/Main.kt - HTTP application → Schedule repository: constructs
server/src/main/kotlin/app/vent/server/Main.kt - Authentication → Auth repository: stores OTPs
server/src/main/kotlin/app/vent/server/AuthService.kt - Event routes → Schedule repository: reads events
server/src/main/kotlin/app/vent/server/VentRoutes.kt - HTTP application → API contracts: uses DTOs
server/src/main/kotlin/app/vent/server/Main.kt - Attendee → Session agenda: browses agenda
README.md - Attendee → Seat selection: reserves seats
README.md - Attendee → Check-in scanner: checks in
README.md - Organizer → Organizer tools: manages event
README.md - Organizer → Attendee import: manages attendees
README.md - Session agenda → Summit pass: opens session
frontend/composeApp/src/commonMain/kotlin/app/vent/SessionsHome.kt