How dilht/sacco-voice-frontend works
This is a Next.js starter for real-time voice and text interaction with LiveKit Agents. A visitor starts from the welcome view; the app creates a LiveKit session from a token source, provides session state and audio playback, then switches to a session view with chat, media tiles, and controls. The token route is an optional development credential path. Camera and screen sharing, five visualizer styles, virtual avatars, and theme customization are documented capabilities. Some capability modules were not sampled, so only documented or indexed relationships are shown.
Main entry points: app.tsx Session setup · audio-visualizer.tsx Visualizer styles · view-controller.tsx View controller · agent-session-block.tsx Session block
Components 25
Application flow
- App entry
app/page.tsx - Session setup
components/app/app.tsx - Session provider
components/agents-ui/agent-session-provider.tsx - View controller
components/app/view-controller.tsx - Welcome view
components/app/welcome-view.tsx - Agent errors
hooks/useAgentErrors.tsx - Theme controls
components/app/theme-provider.tsx
Session experience
- Session block
components/agents-ui/blocks/agent-session-view-01/components/agent-session-block.tsx - Media tiles
components/agents-ui/blocks/agent-session-view-01/components/tile-view.tsx - Visualizer styles
components/agents-ui/blocks/agent-session-view-01/components/audio-visualizer.tsx - Aura visualizer
components/agents-ui/agent-audio-visualizer-aura.tsx - Bar visualizer
components/agents-ui/agent-audio-visualizer-bar.tsx - Grid visualizer
components/agents-ui/agent-audio-visualizer-grid.tsx - Radial visualizer
components/agents-ui/agent-audio-visualizer-radial.tsx - Wave visualizer
components/agents-ui/agent-audio-visualizer-wave.tsx - Chat transcript
components/agents-ui/agent-chat-transcript.tsx - Virtual avatars
components/agents-ui/blocks/agent-session-view-01/components/tile-view.tsx
Media and controls
- Control bar
components/agents-ui/agent-control-bar.tsx - Track controls
components/agents-ui/agent-track-control.tsx - Track toggles
components/agents-ui/agent-track-toggle.tsx - Camera and sharing
components/agents-ui/agent-control-bar.tsx
Access and tokens
- Token endpoint
app/api/token/route.ts - Access check
lib/access.ts
Other components
- Visitor
- LiveKit service
Connections 25
- Visitor → App entry: opens app
- App entry → Session setup: renders
app/page.tsx - Session setup → Session provider: provides session
components/app/app.tsx - Session setup → View controller: renders
components/app/app.tsx - View controller → Welcome view: shows disconnected
components/app/view-controller.tsx - View controller → Session block: shows connected
components/app/view-controller.tsx - Session block → Chat transcript: renders
components/agents-ui/blocks/agent-session-view-01/components/agent-session-block.tsx - Session block → Control bar: renders
components/agents-ui/blocks/agent-session-view-01/components/agent-session-block.tsx - Session block → Media tiles: renders
components/agents-ui/blocks/agent-session-view-01/components/agent-session-block.tsx - Media tiles → Visualizer styles: renders
components/agents-ui/blocks/agent-session-view-01/components/tile-view.tsx - Visualizer styles → Aura visualizer: selects style
components/agents-ui/blocks/agent-session-view-01/components/audio-visualizer.tsx - Visualizer styles → Bar visualizer: selects style
components/agents-ui/blocks/agent-session-view-01/components/audio-visualizer.tsx - Visualizer styles → Grid visualizer: selects style
components/agents-ui/blocks/agent-session-view-01/components/audio-visualizer.tsx - Visualizer styles → Radial visualizer: selects style
components/agents-ui/blocks/agent-session-view-01/components/audio-visualizer.tsx - Visualizer styles → Wave visualizer: selects style
components/agents-ui/blocks/agent-session-view-01/components/audio-visualizer.tsx - Control bar → Track controls: renders
components/agents-ui/agent-control-bar.tsx - Control bar → Track toggles: renders
components/agents-ui/agent-control-bar.tsx - Session setup → Agent errors: monitors session
components/app/app.tsx - Welcome view → Token endpoint: requests token
README.md - Token endpoint → Access check: checks access
app/api/token/route.ts - Token endpoint → LiveKit service: signs participant token
app/api/token/route.ts - Session setup → LiveKit service: connects session
README.md - View controller → Camera and sharing: enables inputs
components/app/view-controller.tsx - Media tiles → Virtual avatars: supports avatars
README.md - Session setup → Theme controls: uses theme