EnvVault
Local-first dotenv inspection, comparison, secure metadata management, and runtime profile workflows for macOS developers.
API Server
~/Projects/api-server
| Key | Value | Source | Status |
|---|---|---|---|
| DATABASE_URL | postgres://user:****@db.internal:5432/app | .env.local | Sensitive |
| API_KEY | sk_live_************************ | .env.local | Sensitive |
| NEXT_PUBLIC_APP_URL | https://app.example.test | .env | OK |
| FEATURE_BILLING | true | .env | OK |
| STRIPE_WEBHOOK_SECRET | whsec_************************ | .env.production | Sensitive |
| LOG_LEVEL | info | .env | OK |
App Pages
Every route in the EnvVault desktop app has a dedicated documentation page.
Live project table, selected file preview, comparison summary, and security score.
View docs ProjectsProject detail, env files, runtime profiles, connector config, sync, recovery, and history.
View docs VariablesSwitch between env-file variables and runtime profile variables for search, filtering, reveal, copy, edit, and validation workflows.
View docs CompareSide-by-side matrix for missing, empty, duplicate, matching, and secret variables.
View docs SecuritySecurity score and warnings for dotenv files, profiles, imports, and connector config.
View docs SettingsTheme, confirmations, App Lock, backups, audit activity, demo reset, and runtime CLI installer.
View docs AboutVersion, author, local security boundary, and app identity details.
View docsFeature Coverage
Where each EnvVault capability appears across the app and CLI documentation.
| Capability | Dashboard | Projects | Variables | Compare | Security | Settings | CLI |
|---|---|---|---|---|---|---|---|
| Add local project folders | - | - | - | - | - | ||
| Import supported dotenv filenames | - | - | |||||
| Parse keys, values, comments, duplicates, invalid lines, and line numbers | - | - | - | ||||
| Mask, reveal, copy, edit, delete, and reclassify variables | - | - | - | - | |||
| Store raw secret values in macOS Keychain | - | - | - | ||||
| Protect the running app with optional App Lock | - | - | - | - | - | ||
| Switch Variables page between env files and runtime profiles | - | - | - | ||||
| Persist metadata, previews, hashes, notes, and Keychain refs in SQLite | |||||||
| Compare env files and environments | - | - | - | - | - | ||
| Generate blank .env.example output | - | - | - | - | - | - | |
| Export dotenv files with confirmation | - | - | - | - | - | ||
| Mirror dotenv files into runtime profiles | - | - | - | - | |||
| Create, edit, rename, delete, and restore runtime profile variables | - | - | - | - | |||
| Track approval, reviewer, rotation, and external provider references | - | - | - | - | - | ||
| Create and refresh safe .envvault.json connector config | - | - | - | - | |||
| Ignore, review, and restore security warnings | - | - | - | - | |||
| Install, repair, uninstall, inspect, and run doctor for envvault CLI | - | - | - | - | - | ||
| Record audit activity without raw secret values | - | - | - | - | |||
| Export metadata-only and explicit full encrypted backups | - | - | - | - | - |
Security Model
EnvVault is intentionally local-first. The desktop app keeps raw secrets out of SQLite and uses Keychain-backed references for sensitive values.
- Raw secret values should live in macOS Keychain, not SQLite.
- Optional App Lock can hide project metadata until local unlock succeeds.
- Audit logs store action names, timestamps, project IDs, and file/key targets without raw secret values.
- Secret clipboard copies are scheduled to clear after 60 seconds.
- External provider metadata stores provider names and references, not third-party credentials.
Local Data Flow
Secrets stay local; metadata remains inspectable and auditable.
Runtime Connector CLI
The app-managed envvault command can print, validate, and inject EnvVault profile variables into local commands after resolving secret values from macOS Keychain.
envvault doctor
envvault profiles
envvault validate --project <project> --profile <profile>
envvault run --profile development -- npm run devRelease Status
Current version: 0.22.0
- EnvVault is provided as a free macOS app.
- Source code is not included with the free app distribution.
- Version 0.22.0 adds ignored security warning review and restore workflow.
- Original MVP phases are complete.
- Runtime connector phases 1 through 13 are complete.