How marslento/your-name-for-threads works
Your Name for Threads is a local-first browser extension for attaching private nicknames to Threads identities and keeping notes in an account-specific directory. Users onboard in the popup, add nicknames from Threads profile pages, and manage contacts, conflicts, and backups in a Dashboard opened from a confirmed Threads tab. The content integration covers profiles and feed/reply/quoted-post authors; the Dashboard also provides recovery and diagnostics. Edges reflect sampled imports/calls or README-described behavior; unsampled subsystem links are omitted where wiring is not evidenced.
Main entry points: dashboard/App.tsx Dashboard router · index.ts Content integration · BrowserStorageContactsRepository.ts Contacts repository · popup/App.tsx Popup and onboarding
Components 21
Extension entry points
- Popup and onboarding
src/popup/App.tsx - Background worker
src/background/serviceWorker.ts - Account context
src/account/AccountContextRegistry.ts
Threads integration
- Content integration
src/content/index.ts - Surface runtime
src/content/runtime/ThreadsRuntime.ts - Profile nickname UI
src/content/surfaces/profile/ProfileSurfaceAdapter.tsx - Post author labels
src/content/surfaces/post-author/PostAuthorSurfaceAdapter.ts - Identity observation
src/content/identity/IdentityCoordinator.ts
Directory and storage
- Contacts repository
src/storage/BrowserStorageContactsRepository.ts - Account directory access
src/storage/directoryAccess.ts - Storage migration
src/storage/migrations.ts - Browser local storage
Dashboard workflows
- Dashboard router
src/dashboard/App.tsx - Dashboard state
src/dashboard/store/DashboardStore.ts - Directory and conflicts
src/dashboard/routes/DirectoryPage.tsx - Backup review flow
src/dashboard/backup/ImportReviewDrawer.tsx
Portability and recovery
- Backup import/export
src/portability/importSession.ts - Recovery restore
src/recovery/recoveryRestore.ts - Diagnostics
src/diagnostics/collectDiagnosticSummary.ts
Other components
- Extension user
- Threads pages
Connections 22
- Extension user → Popup and onboarding: opens
README.md - Popup and onboarding → Account context: checks account
src/popup/App.tsx - Popup and onboarding → Background worker: requests Dashboard
src/popup/App.tsx - Background worker → Account context: handles context
src/background/serviceWorker.ts - Threads pages → Content integration: hosts integration
README.md - Content integration → Surface runtime: starts runtime
src/content/index.ts - Content integration → Profile nickname UI: registers surface
src/content/index.ts - Content integration → Post author labels: creates adapter
src/content/index.ts - Content integration → Identity observation: initializes coordinator
src/content/index.ts - Post author labels → Contacts repository: looks up contacts
src/content/surfaces/post-author/PostAuthorSurfaceAdapter.ts - Extension user → Dashboard router: opens directory
README.md - Dashboard router → Dashboard state: creates store
src/dashboard/App.tsx - Dashboard router → Contacts repository: creates repository
src/dashboard/App.tsx - Dashboard router → Directory and conflicts: routes pages
src/dashboard/App.tsx - Dashboard router → Backup review flow: routes import flow
src/dashboard/App.tsx - Dashboard state → Contacts repository: uses repository
src/dashboard/store/DashboardStore.ts - Contacts repository → Account directory access: reads and mutates
src/storage/BrowserStorageContactsRepository.ts - Account directory access → Storage migration: loads quarantined storage
src/storage/directoryAccess.ts - Storage migration → Browser local storage: migrates data
src/storage/migrations.ts - Backup review flow → Backup import/export: records decisions
src/dashboard/backup/ImportReviewDrawer.tsx - Dashboard router → Recovery restore: previews and commits
src/dashboard/App.tsx - Dashboard router → Diagnostics: reports issues
src/dashboard/App.tsx