How yumankh/cipher works
Cipher is a zero-knowledge password manager: users authenticate and unlock a browser-held key, then manage encrypted passwords and notes. The client encrypts before sending ciphertext to the REST API; the API stores ciphertext and authentication material without receiving plaintext or the master password. Additional branches cover account/session management, vault organization, and informational/security pages. Edges are limited to relationships supported by excerpts, the source index, or the README; unsampled subsystem links are omitted.
Main entry points: api.ts API client · VaultPage.tsx Vault interface · AuthPage.tsx Auth page · main.tsx Application routes
Components 27
Web client
- Auth page
frontend/src/pages/AuthPage.tsx - Client cryptography
frontend/src/lib/crypto.ts - Session state
frontend/src/stores/authStore.ts - API client
frontend/src/lib/api.ts - Session gate
frontend/src/components/SessionGate.tsx - Vault interface
frontend/src/pages/VaultPage.tsx - Vault item query
frontend/src/hooks/useVaultItems.ts - Item mutations
frontend/src/hooks - Account settings
frontend/src/pages/SettingsPage.tsx - Vault export
frontend/src/lib/exportVault.ts - Public information
frontend/src/pages - Application routes
frontend/src/main.tsx
REST API
- Auth routes
backend/src/api/routes/auth.routes.ts - Auth controller
backend/src/api/controllers/auth.controller.ts - Auth service
backend/src/api/services/auth.service.ts - Auth repository
backend/src/api/repositories/auth.repository.ts - Notes controller
backend/src/api/controllers/notes.controller.ts - Notes service
backend/src/api/services/notes.service.ts - Notes repository
backend/src/api/repositories/notes.repository.ts - Users controller
backend/src/api/controllers/users.controller.ts - Users service
backend/src/api/services/users.service.ts - Users repository
backend/src/api/repositories/users.repository.ts - Auth middleware
backend/src/api/middlewares/requireAuth.ts - Password API
backend/src
Persistence
- PostgreSQL data
backend/src/lib/prisma.ts
Other components
- Vault user
- REST API
Connections 34
- Vault user → Auth page: signs in
- Auth page → Client cryptography: derives and wraps
frontend/src/pages/AuthPage.tsx - Auth page → API client: submits auth
frontend/src/pages/AuthPage.tsx - Auth page → Session state: sets session
frontend/src/pages/AuthPage.tsx - Application routes → Auth page: routes to
frontend/src/main.tsx - Application routes → Vault interface: routes to
frontend/src/main.tsx - Application routes → Account settings: routes to
frontend/src/main.tsx - Application routes → Public information: routes to
frontend/src/main.tsx - Session gate → API client: restores via
frontend/src/components/SessionGate.tsx - Session gate → Session state: updates state
frontend/src/components/SessionGate.tsx - Vault interface → Vault item query: loads items
frontend/src/pages/VaultPage.tsx - Vault interface → Client cryptography: decrypts items
frontend/src/pages/VaultPage.tsx - Vault interface → Item mutations: uses mutations
frontend/src/pages/VaultPage.tsx - Vault item query → API client: fetches items
frontend/src/hooks/useVaultItems.ts - Item mutations → API client: sends changes
frontend/src/hooks/useCreateItem.ts - Item mutations → Client cryptography: encrypts content
frontend/src/hooks/useCreateItem.ts - API client → REST API: HTTP requests
frontend/src/lib/api.ts - REST API → Auth routes: auth endpoints
- Auth routes → Auth controller: dispatches
backend/src/api/routes/auth.routes.ts - Auth controller → Auth service: invokes
backend/src/api/controllers/auth.controller.ts - Auth service → Auth repository: persists and reads
backend/src/api/services/auth.service.ts - Auth repository → PostgreSQL data: queries
backend/src/api/repositories/auth.repository.ts - REST API → Notes controller: note requests
- Notes controller → Notes service: invokes
backend/src/api/controllers/notes.controller.ts - Notes service → Notes repository: delegates
backend/src/api/services/notes.service.ts - Notes repository → PostgreSQL data: queries
backend/src/api/repositories/notes.repository.ts - REST API → Users controller: account requests
- Users controller → Users service: invokes
backend/src/api/controllers/users.controller.ts - Users service → Users repository: delegates
backend/src/api/services/users.service.ts - Users repository → PostgreSQL data: queries
backend/src/api/repositories/users.repository.ts - Auth middleware → REST API: guards requests
- REST API → Password API: password operations
- Vault interface → Vault export: exports vault
- Account settings → API client: manages account