How hypercerts-org/certified-app works
Certified is a passwordless AT Protocol identity platform: users authenticate, manage a portable identity and profile, and use that identity across partner apps. The repository also exposes social discovery, endorsements, activity/context records, group management, and an indexer proxy. The README documents the signup-to-PDS flow; sampled routes and source-index references support the specific authentication, resolution, and proxy relationships shown. Other feature branches are represented from the route and component tree, without inferring unsampled call chains.
Main entry points: oauth-client.ts OAuth client · session.ts Signed sessions · [...method]/route.ts XRPC proxy · login/route.ts OAuth routes
Components 26
Identity and auth
- Welcome and onboarding
src/app/welcome/page.tsx - OAuth routes
src/app/api/auth/login/route.ts - OAuth client
src/lib/auth/oauth-client.ts - Signed sessions
src/lib/auth/session.ts - Redis auth stores
src/lib/auth/stores.ts - Profile dashboard
src/app/profile/page.tsx - Account settings
src/app/settings/page.tsx
AT Protocol services
- XRPC proxy
src/app/api/xrpc/[...method]/route.ts - DID resolution
src/app/api/resolve-did/resolve-core.ts - Resolution routes
src/app/api/resolve-did/route.ts - AT identity utilities
src/lib/atproto/did.ts - Profile records
src/lib/atproto/profile.ts - Indexer API
src/app/api/indexer/route.ts - Indexer operations
src/app/api/indexer/operations.ts - Indexer variables
src/app/api/indexer/variables.ts - Context attachments
src/lib/atproto/context-attachment.ts - Activity references
src/lib/atproto/activity-uri.ts
Social features
- Global search
src/components/search/global-search.tsx - Explore
src/components/explore-page/explore.tsx - Endorsements
src/app/endorsements/page.tsx - Context updates
src/components/context/context-updates.tsx
Group management
- Group management
src/app/groups/page.tsx - Group account controls
src/components/groups/group-account-manager.tsx - Group API
src/lib/groups/account.ts
Other components
- User
- Partner apps
Connections 25
- User → Welcome and onboarding: starts signup
README.md - Welcome and onboarding → OAuth routes: begins sign-in
- OAuth routes → OAuth client: authorizes
src/app/api/auth/login/route.ts - OAuth routes → Signed sessions: checks session
src/app/api/auth/login/route.ts - OAuth client → Redis auth stores: stores OAuth state
src/lib/auth/oauth-client.ts - Signed sessions → Redis auth stores: stores sessions
src/lib/auth/session.ts - OAuth client → Partner apps: enables app identity
README.md - User → Profile dashboard: manages identity
README.md - Profile dashboard → Profile records: uses profile data
- User → Account settings: manages account
README.md - XRPC proxy → OAuth client: restores OAuth session
src/app/api/xrpc/[...method]/route.ts - XRPC proxy → Signed sessions: checks identity
src/app/api/xrpc/[...method]/route.ts - XRPC proxy → AT identity utilities: resolves PDS
src/app/api/xrpc/[...method]/route.ts - Resolution routes → DID resolution: resolves DID
src/app/api/resolve-did/route.ts - Resolution routes → Signed sessions: checks session
src/app/api/resolve-did/route.ts - DID resolution → AT identity utilities: uses DID utilities
src/app/api/resolve-did/resolve-core.ts - DID resolution → Profile records: loads profile
src/app/api/resolve-did/resolve-core.ts - Indexer API → Indexer operations: selects operations
src/app/api/indexer/route.ts - Indexer API → Indexer variables: builds variables
src/app/api/indexer/route.ts - Global search → Explore: discovers content
- User → Endorsements: views endorsements
- Context updates → Context attachments: uses attachments
src/components/context/context-updates.tsx - Context updates → Activity references: uses activity references
src/components/context/context-updates.tsx - Group management → Group account controls: manages group account
- Group account controls → Group API: updates account
src/components/groups/group-account-manager.tsx