How harry-jees/teddy-bud works
Teddy Bud is a local-first AI companion app for conversation and personal reflection, with Android and desktop distribution. The user enters through the app shell, signs in or completes onboarding as needed, then chats or uses Discover’s reflection and wellbeing features; local personal data is stored on-device, while authenticated AI and account requests go through the gateway. The graph preserves documented capabilities even where implementation details were not sampled; links without direct source evidence are omitted.
Main entry points: App.tsx App shell · localData.ts Local personal data · WellbeingScreens.tsx Reflection and wellbeing · index.mjs Gateway service
Components 18
App experience
- App shell
client/App.tsx - Conversation
client/App.tsx - Onboarding and consent
client/src/components/OnboardingConsent.tsx - Reflection and wellbeing
client/src/screens/WellbeingScreens.tsx - Guided exercises
client/src/components/WellbeingStudio.tsx - Assistant characters
client/src/characters.ts
Personal data
- Local personal data
client/src/services/localData.ts - Platform storage
client/src/services/localStore.ts - Encrypted backup
client/src/services/backup.ts - Backup file handling
client/src/services/backupFiles.ts
Account and AI services
- Account screen
client/src/components/BrowserLoginScreen.tsx - Account authentication
client/src/services/browserAuth.ts - AI gateway client
client/src/services/gateway.ts - Gateway service
gateway-worker/src/index.mjs
Shared interface
- Chat presentation
client/src/components/ChatPresentation.tsx - Shared styles
client/src/theme/appStyles.ts
Other components
- User
- Account and AI providers
Connections 20
- User → App shell: uses
README.md - App shell → Onboarding and consent: presents
client/App.tsx - App shell → Conversation: hosts
README.md - App shell → Reflection and wellbeing: hosts
README.md - App shell → Guided exercises: offers
README.md - App shell → Local personal data: reads and writes
client/App.tsx - App shell → AI gateway client: requests replies
client/App.tsx - App shell → Account screen: presents
client/App.tsx - Account screen → Account authentication: uses
client/src/components/BrowserLoginScreen.tsx - Account authentication → Gateway service: sends account requests
client/src/services/browserAuth.ts - AI gateway client → Gateway service: sends AI requests
README.md - Gateway service → Account and AI providers: forwards requests
README.md - Local personal data → Platform storage: persists data
client/src/services/localData.ts - Local personal data → Assistant characters: uses character definitions
client/src/services/localData.ts - Encrypted backup → Local personal data: exports and imports
client/src/services/backup.ts - App shell → Encrypted backup: handles backup import
client/App.tsx - Reflection and wellbeing → Local personal data: reads and writes entries
client/src/screens/WellbeingScreens.tsx - Reflection and wellbeing → Backup file handling: exports journal text
client/src/screens/WellbeingScreens.tsx - App shell → Chat presentation: renders
client/App.tsx - Chat presentation → Shared styles: uses
client/src/components/ChatPresentation.tsx