ENV-SAFE-SYNC

Secure CLI tool to encrypt, share, and restore .env files across teams.

env-safe-sync helps developers safely share environment variables between projects or teammates without exposing sensitive secrets in plain text.

The package is accessible from

env-safe-sync

Features

• AES-256 ( Advanced Encryption Standard ) encryption for .env files
• Share encrypted environment files among teams
• Pull & restore original .env
• Validate missing environment variables
• Simple CLI usage for teams & projects

Installation

Install globally from npm

npm install -g env-safe-sync

Usage

Get all Commands

env-safe-sync

Encrypt and save .env

env-safe-sync push

Custom output filename:

env-safe-sync push my.env.enc

Note:

1. Now this encrypted files can be shared across teams or projects.

Decrypt and restore .env

env-safe-sync pull

From custom encrypted file:

env-safe-sync pull my.env.enc

Validate environment variables

env-safe-sync validate

Checks for missing or undefined variables in your project.

🛠️ How It Works

1. Reads .env file from your project
2. Encrypts content using AES-256-CBC
3. Saves encrypted output file
4. Allows secure sharing with teammates
5. Restores original .env when needed

Project Structure

env-safe-sync/
│
├── bin/              # CLI entry point
    ├── index.js 
├── src/              # Core logic 
    ├── decrypt.js    # For decrypting files sent by members
    ├── encrypt.js    # For encrypting env files
    ├── envParser.js  # For detecting all availbale env files in the directory
    ├── sync.js       # Pull and push logic is implemented here
    ├── validate.js   # To check for missing env values
├── package.json
└── README.md

🔐 Security Note

• Uses AES-256 encryption
• Do not commit decrypted .env to GitHub
• Share only encrypted files within trusted teams or members

Author

Pranava Pai N

• Engineering Student
• Full-Stack & ML Enthusiast
• Open-source learner

License

ISC License

Support

If you like this project:

• Star the GitHub repo
• Use it in your projects
• Share your honest feedback

Future Improvements

• Password-based encryption prompt
• Role Based Access or Time Based Permissions
• Cloud sync support
• Team key management
• GUI dashboard

Made with ❤️ by Pranava Pai N