How 9090856788/vaultguard-password-manager works
ShieldVault is a password-vault application: users register or unlock a vault, manage and organize credentials, review security and activity, and configure account settings. The visible React app delegates session and vault state to a context and communicates with an Express API; API controllers handle authentication, categories, audit, activity, and vault import/export, with shared state accessed through a store. The README describes only running the AI Studio app, so product capabilities are inferred from sampled source and the tree; several UI and API implementations were not sampled, and their internal wiring is omitted.
Main entry points: App.tsx App shell · index.ts API routes · store.ts Data store · app.ts API app
Components 21
Vault interface
- App shell
src/App.tsx - Vault context
src/context/VaultContext.tsx - Authentication UI
src/components/auth/AuthModal.tsx - Dashboard
src/components/dashboard/DashboardOverview.tsx - Activity timeline
src/components/activity/ActivityTimelineView.tsx - Settings UI
src/components/settings/SettingsView.tsx - Vault import UI
src/components/common/ImportModal.tsx - Search UI
src/components/common/SearchModal.tsx - API client
src/services/api.ts
API runtime
- HTTP server
server.ts - API app
src/api/app.ts - API routes
src/api/routes/index.ts - Token middleware
src/api/middlewares/authMiddleware.ts
Vault domains
- Account access
src/api/controllers/authController.ts - Credential vault
src/api/controllers/vaultController.ts - Categories
src/api/controllers/categoryController.ts - Security audit
src/api/controllers/auditController.ts - Activity records
src/api/controllers/activityController.ts
State and security
- Data store
src/api/config/store.ts - Client cryptography
src/utils/crypto.ts
Other components
- Vault user
Connections 23
- Vault user → App shell: uses
- App shell → Vault context: provides state
- App shell → Dashboard: renders
- App shell → Activity timeline: renders
- App shell → Settings UI: renders
- App shell → Authentication UI: renders
- App shell → Vault import UI: renders
- App shell → Search UI: renders
- HTTP server → API app: mounts
- API app → API routes: dispatches
- API routes → Account access: dispatches
- API routes → Credential vault: dispatches
- API routes → Categories: dispatches
- API routes → Security audit: dispatches
- API routes → Activity records: dispatches
- API routes → Token middleware: guards routes
- Account access → Data store: reads and writes
- Credential vault → Data store: reads and writes
- Categories → Data store: reads and writes
- Security audit → Data store: reads
- Activity records → Data store: reads and writes
- Vault context → API client: uses API
- API client → API app: sends requests