envcf

🌥️ EnvCF

Beautiful CLI tool to push environment variables to Cloudflare Pages/Workers

EnvCF is a modern, user-friendly CLI tool that makes it super easy to sync your environment variables from .env files to Cloudflare Pages or Workers. No more manual copying and pasting!

✨ Features

• 🔍 Auto-discovery - Automatically finds your wrangler.toml or wrangler.jsonc configuration
• 📁 Multiple file support - Handle .env, .env.local, .env.production, etc.
• 🎯 Environment targeting - Deploy to production or preview environments
• 🎨 Beautiful interface - Interactive prompts with colors and emojis
• 🔒 Type-safe - Built with TypeScript for reliability
• 🏃‍♂️ Dry run mode - Preview changes before applying them
• ⚡ Fast & lightweight - Minimal dependencies, maximum performance
• 🌩️ Multi-account support - Seamlessly integrates with cfman for managing multiple Cloudflare accounts

🚀 Installation

Global Installation (Recommended)

npm install -g envcf
# or
pnpm add -g envcf
# or
yarn global add envcf

Use without installing

npx envcf

📖 Usage

Basic Usage

Navigate to your project directory and run:

envcf

The CLI will guide you through:

• 🔍 Finding your wrangler config - Automatically detects wrangler.toml or wrangler.jsonc
• 🎯 Choosing environment - Select between production and preview
• 📁 Selecting env files - Pick which .env files to use
• ✅ Confirmation - Review variables before pushing
• 🚀 Deployment - Push variables to Cloudflare

Advanced Options

# Dry run - see what would happen without making changes
envcf --dry-run

# Use custom env file
envcf --file .env.custom

# Use custom wrangler config
envcf --config wrangler.custom.toml

# Show help
envcf --help

Multi-Account Management

EnvCF integrates seamlessly with cfman for managing multiple Cloudflare accounts:

# First, set up your accounts with cfman
npx cfman token add --name production --token cf_your_production_token
npx cfman token add --name staging --token cf_your_staging_token

# Then use envcf with specific accounts
envcf --account production     # Deploy to production account
envcf --account staging        # Deploy to staging account

# You can combine with other options
envcf --account production --dry-run --file .env.prod

Benefits of cfman integration:

• 🔐 Secure token management - Store multiple API tokens safely
• 🚀 One-command deployment - No manual token switching
• 🛡️ Isolated accounts - Each account's tokens are kept separate
• 🎯 Environment specific - Perfect for agencies or multi-client setups

🏗️ Prerequisites

• Wrangler CLI installed and authenticated:

  npm install -g wrangler
  wrangler login
  

• Optional: cfman for multi-account management:

  npm install -g cfman
  cfman token add --name production --token your_token
  

• Project structure with either:

  • wrangler.toml file
  • wrangler.jsonc file

• Environment files like:

  • .env
  • .env.local
  • .env.production
  • .env.preview

📝 Example Workflow

$ envcf

🌥️  EnvCF - Environment Variables to Cloudflare

🔍 Looking for wrangler configuration...
✅ Found config: wrangler.toml
📦 Project: my-awesome-app

? Which environment do you want to deploy to? 
❯ 🚀 Production
  🧪 Preview

🔍 Looking for environment files...
? Which environment files do you want to use? 
❯ ☑ 📄 .env
  ☑ 📄 .env.local
  ☐ 📁 All files

📝 Parsing environment variables...
✅ Found 12 environment variables

📋 Environment variables to be pushed:
  • DATABASE_URL (from .env)
  • API_KEY (from .env)
  • SECRET_TOKEN (from .env.local)
  ...

? Push these 12 variables to production? Yes

🚀 Pushing to Cloudflare...
🔑 Authenticated with Cloudflare
  ✅ DATABASE_URL
  ✅ API_KEY
  ✅ SECRET_TOKEN
  ...

📊 Results:
  ✅ Success: 12

✨ All environment variables pushed successfully!

🔧 Configuration

Wrangler Configuration

EnvCF works with standard Wrangler configuration files:

wrangler.toml:

name = "my-app"
compatibility_date = "2023-12-01"

[env.preview]
# Preview environment config

[env.production]
# Production environment config

wrangler.jsonc:

{
  "name": "my-app",
  "compatibility_date": "2023-12-01",
  "env": {
    "preview": {},
    "production": {}
  }
}

Environment Files

Standard .env file format:

# Database
DATABASE_URL=postgresql://localhost:5432/mydb
DATABASE_POOL_SIZE=10

# API Keys
STRIPE_SECRET_KEY=sk_test_...
SENDGRID_API_KEY=SG....

# Feature Flags
ENABLE_ANALYTICS=true
DEBUG_MODE=false

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT © Shayan Moradi

🙏 Acknowledgments

• Built with ❤️ using TypeScript
• Powered by Wrangler
• Made beautiful with Chalk and Inquirer

Happy deploying! 🚀