App Pages

Projects Page

The detailed workspace for project files, runtime profiles, sync state, connector config, recovery, and history.

App route: projects

Purpose

The Projects page is the main operational page for a selected project. It brings together env-file management, safe output, runtime profiles, connector config, sync diffs, profile/file sync, deleted-file recovery, and snapshot history.

Header actions

Action	Behavior
Import Env Variables	Imports supported dotenv files from the project folder.
Re-import Changes	Re-reads dotenv files from disk while preserving metadata such as notes, overrides, required flags, and expected types.
Open Folder	Opens the project folder through the native open command.
Remove Project	Confirms removal, purges local Keychain secrets for the project, and removes local metadata. Project files on disk are not deleted.

Panels

EnvFileList shows detected env files and supports selecting or removing a file from EnvVault.
Safe Output generates .env.example output, requests dotenv export, and validates dotenv syntax through export preview.
Runtime Profiles summarizes profile import state and links to profile management.
Connector Config creates, repairs, or refreshes safe .envvault.json metadata for CLI defaults.
Profile Editor manages profile variables and workflow metadata.
Last Sync Diff explains changes after import or re-import.
Profile File Sync compares linked runtime profiles and dotenv files.
Deleted File Recovery restores or forgets env-file metadata snapshots.
Snapshot History compares and restores previous metadata states.

Safe file removal

Removing an env file removes it from EnvVault metadata, deletes local Keychain-backed values for that file, keeps the physical file on disk, and adds its path to the project's excluded env file list so future imports ignore it.