How bluesky-social/social-app works
Bluesky is a React Native social-network client for web, iOS, and Android, built on AT Protocol. The principal workflow is app launch, account/session setup, social discovery through feed and preference queries, then navigation to social content and notifications. The repository also includes a Go service that serves the web app and separate embed, link, and OG-card products. The graph emphasizes these product stages and a shared analytics layer. Some runtime wiring is unsampled, so uncertain links are omitted or dashed.
Main entry points: useOnboardingSuggestedStarterPacksQuery.ts Feed discovery · App.tsx App startup · useNotificationHandler.ts Notification handling · Navigation.tsx Navigation
Components 19
Social app
- App startup
src/App.tsx - Navigation
src/Navigation.tsx
Identity and data
- Session management
src/state/session/index.tsx - Preferences
src/state/queries/preferences/index.ts - Language settings
src/state/preferences/languages.tsx - Feed discovery
src/state/queries/useOnboardingSuggestedStarterPacksQuery.ts - Feed request context
src/lib/api/feed/utils.ts - Query persistence
src/lib/persisted-query-storage.ts
Social interactions
- Notification handling
src/lib/hooks/useNotificationHandler.ts - Age assurance
src/ageAssurance/data.tsx - Post composer
src/components/Composer/index.tsx
Web services
- Web app server
bskyweb/cmd/bskyweb/server.go - Post embeds
bskyembed/src/screens/post.tsx - Link service
bskylink/src/index.ts - OG cards
bskyogcard/src/index.ts
Other components
- User
- AT Protocol services
Connections 18
- User → App startup: opens
- App startup → Navigation: starts navigation
- Navigation → Session management: uses session
- Session management → AT Protocol services: creates or resumes sessions
src/state/session/index.tsx - Feed discovery → Preferences: reads preferences
src/state/queries/useOnboardingSuggestedStarterPacksQuery.ts - Feed discovery → Language settings: reads content languages
src/state/queries/useOnboardingSuggestedStarterPacksQuery.ts - Feed discovery → Feed request context: builds request headers
src/state/queries/useOnboardingSuggestedStarterPacksQuery.ts - Feed discovery → AT Protocol services: requests starter packs
src/state/queries/useOnboardingSuggestedStarterPacksQuery.ts - Query persistence → AT Protocol services: persists query cache
- Notification handling → Navigation: routes notifications
src/lib/hooks/useNotificationHandler.ts - Notification handling → Session management: reads session
src/lib/hooks/useNotificationHandler.ts - Notification handling → Analytics: uses analytics
src/lib/hooks/useNotificationHandler.ts - App startup → Analytics: initializes analytics
- Analytics → Logging: creates loggers
src/analytics/index.tsx - Web app server → App startup: serves web app
README.md - User → Post embeds: views shared posts
- User → Link service: follows shared links
- User → OG cards: previews shared content