Source Map
This page is a practical index of where behavior lives in the repository today.
App shell and routing
Section titled “App shell and routing”src/main.tsx: bootstrap, security initialization, root render.src/App.tsx: providers and router wiring.src/components/SelfHostedDashboard.tsx: main runtime shell and view switching.
Configuration and Supabase integration
Section titled “Configuration and Supabase integration”src/integrations/supabase/client.ts: local storage keys, credential persistence, client creation/refresh.src/components/Settings.tsx: Supabase URL/key form, validation, connection test UX.supabase-setup.sql: canonical schema, policies, triggers, helper functions.
Vault and cryptography
Section titled “Vault and cryptography”src/services/VaultManager.ts: high-level vault orchestration and format detection.src/services/SecureVault.ts: in-memory DEK management, encrypt/decrypt, auto-lock.src/services/VaultStorage.ts:vault_configCRUD and format guards.src/crypto/crypto.ts: Argon2/PBKDF2 helpers and generic AES-GCM string encryption primitives.src/crypto/bcrypt.ts: passphrase hash + verify utilities.src/crypto/types.ts:SecretBlobV1, crypto errors, vault status types.
Credential CRUD and UI flow
Section titled “Credential CRUD and UI flow”src/components/dashboard/AddCredentialModal.tsx: create form + encryption path.src/components/dashboard/EditCredentialModal.tsx: update form + decrypt/re-encrypt path.src/components/dashboard/CredentialDetailModal.tsx: detail view and delete action.src/components/dashboard/CredentialsGrid.tsx: list/grid rendering and item selection.src/components/PassphraseGate.tsx: first-time vault creation and unlock UX.src/hooks/useVault.ts: vault state hook and encryption helper methods.
Security and policy helpers
Section titled “Security and policy helpers”src/security/ContentSecurityPolicy.ts: CSP generation and runtime application hooks.src/security/SecurityAuditLogger.ts: security event logging APIs.src/security/PassphraseValidator.ts: passphrase strength and validation analysis._headers,_redirects,_routes.json: Cloudflare Pages security and routing headers.
Build, test, and deploy
Section titled “Build, test, and deploy”vite.config.ts: build configuration, PWA setup, argon2-related bundling workarounds.vitest.config.ts,src/test-setup.ts: test runner and test environment mocks.package.json: scripts and dependency inventory.deploy.sh,deploy.ps1: deployment helper scripts for Keyper app.wrangler.toml: app-level Cloudflare Pages configuration.
Docs site implementation
Section titled “Docs site implementation”website/astro.config.mjs: Starlight site config and sidebar.website/src/styles/keyper-theme.css: dark-theme variables and typography.website/src/content/docs/**: documentation content.website/wrangler.toml: docs-site Cloudflare Pages deployment config.