How santiagoa58/blind-journal works
Blind Journal is a zero-knowledge encrypted journal: the browser derives keys, encrypts entry content, and displays plaintext only while unlocked; the server authenticates users and stores encrypted records. The principal flow is account creation or sign-in, followed by an unlocked journal session and encrypted entry CRUD. The graph also preserves the documented locale-aware and responsive experience. Relationships among sampled server modules are supported by the source index or excerpts; client-to-API and UI composition links rely on README statements where implementation excerpts were unavailable.
Main entry points: route.ts Auth API routes · journal-workspace.tsx Journal workspace · session.ts Opaque sessions · login-card.tsx Account and sign-in
Components 21
Identity and sessions
- Account and sign-in
components/auth/login-card.tsx - Create account
components/auth/create-account-card.tsx - Key derivation client
lib/api/auth/auth-worker-client.ts - Derivation worker
lib/api/auth/worker/auth-key-derivation.ts - Auth API routes
app/api/v1/auth/login/route.ts - Authentication service
server/auth/auth.ts - Opaque sessions
server/auth/session.ts - Browser session state
client-state/app-session.state.tsx
Encrypted journaling
- Journal workspace
components/journal/journal-workspace.tsx - Entry list and filter
components/journal/entry-list.tsx - Rich-text editor
components/journal/journal-editor.tsx - Entry encryption
lib/api/journal/journal.crypto.ts - Journal API client
lib/api/journal/journal.ts - Entry API routes
app/api/v1/entries/route.ts - Journal service
server/journal/journal.ts
Server and storage
- Account database
server/database/accounts.ts - Session database
server/database/sessions.ts - Encrypted entry database
server/database/journal-entries.ts
User experience
- Locale routing
i18n/routing.ts - PWA and themes
app/manifest.ts
Other components
- Journal user
Connections 25
- Journal user → Create account: creates account
- Journal user → Account and sign-in: signs in
- Create account → Key derivation client: derives keys
- Account and sign-in → Key derivation client: derives keys
- Key derivation client → Derivation worker: dispatches derivation
lib/api/auth/auth-worker-client.ts - Create account → Auth API routes: submits account
- Account and sign-in → Auth API routes: submits credentials
- Auth API routes → Authentication service: calls service
app/api/v1/auth/login/route.ts - Authentication service → Account database: reads and creates
server/auth/auth.ts - Authentication service → Opaque sessions: creates session
server/auth/auth.ts - Opaque sessions → Session database: reads and writes
server/auth/session.ts - Auth API routes → Opaque sessions: starts session
app/api/v1/auth/login/route.ts - Browser session state → Journal workspace: unlocks workspace
- Journal user → Journal workspace: journals
- Journal workspace → Rich-text editor: edits entries
- Journal workspace → Entry list and filter: browses entries
- Rich-text editor → Entry encryption: encrypts content
- Entry list and filter → Entry encryption: decrypts content
- Entry encryption → Journal API client: protects payload
- Journal API client → Entry API routes: sends requests
- Entry API routes → Opaque sessions: authenticates user
app/api/v1/entries/route.ts - Entry API routes → Journal service: dispatches CRUD
app/api/v1/entries/route.ts - Journal service → Encrypted entry database: reads and writes
server/journal/journal.ts - Journal user → Locale routing: chooses locale
- Journal user → PWA and themes: uses app