# SpecWeave - Environment Variables Template # Copy this file to .env and fill in your actual values # NEVER commit .env to git! # =================================== # Infrastructure & Cloud Platforms # =================================== # Hetzner Cloud (https://console.hetzner.cloud/) # Navigate to: Security → API Tokens → Generate API Token # Permissions: Read & Write HETZNER_API_TOKEN=your-hetzner-token-here-64-chars-alphanumeric # AWS (https://console.aws.amazon.com/iam/) # Navigate to: IAM → Users → Security Credentials AWS_ACCESS_KEY_ID=your-aws-access-key-20-chars AWS_SECRET_ACCESS_KEY=your-aws-secret-key-40-chars AWS_REGION=us-east-1 # Azure (https://portal.azure.com/) # Navigate to: App Registrations → New Registration AZURE_CLIENT_ID=your-azure-client-id-uuid AZURE_CLIENT_SECRET=your-azure-client-secret AZURE_TENANT_ID=your-azure-tenant-id-uuid AZURE_SUBSCRIPTION_ID=your-azure-subscription-id-uuid # Google Cloud Platform (https://console.cloud.google.com/) # Navigate to: IAM → Service Accounts → Create Service Account # Download JSON key file and set path here GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json GCP_PROJECT_ID=your-gcp-project-id # DigitalOcean (https://cloud.digitalocean.com/account/api/tokens) DIGITALOCEAN_TOKEN=your-digitalocean-token-64-chars # Railway (https://railway.app/account/tokens) RAILWAY_TOKEN=your-railway-token-32-plus-chars # Vercel (https://vercel.com/account/tokens) VERCEL_TOKEN=your-vercel-token-here # =================================== # Integration Services # =================================== # ============================================================================ # ISSUE TRACKER INTEGRATIONS (with Strategy-Based Team Mapping) # ============================================================================ # # IMPORTANT: External tool sync permissions are configured in .specweave/config.json # under sync.settings (canUpsertInternalItems, canUpdateExternalItems, canUpdateStatus) # NOT in this .env file. See config.json for permission configuration. # ============================================================================ # ---------------------------------------------------------------------------- # GitHub # ---------------------------------------------------------------------------- # RECOMMENDED: Use gh CLI instead of tokens # gh auth login # # Only use GITHUB_TOKEN if gh CLI is not available (e.g., CI/CD) # Guide: https://github.com/settings/tokens # Scopes: repo, read:org GITHUB_TOKEN=ghp_your-github-token-40-chars # All other GitHub configuration is in .specweave/config.json # ---------------------------------------------------------------------------- # Jira - 3 Strategies for Team Organization # ---------------------------------------------------------------------------- # Guide: https://id.atlassian.com/manage-profile/security/api-tokens # Required for all strategies: JIRA_API_TOKEN=your-jira-api-token JIRA_EMAIL=your-email@example.com JIRA_DOMAIN=your-domain.atlassian.net # Strategy 1: Project-per-team (SEPARATE PROJECTS) # Use when: Each team has its own Jira project # Example: FRONTEND project, BACKEND project, MOBILE project JIRA_STRATEGY=project-per-team JIRA_PROJECTS=FRONTEND,BACKEND,MOBILE,QA # Strategy 2: Component-based (ONE PROJECT, MULTIPLE COMPONENTS) # Use when: Single project with components representing teams # Example: MAIN project with Frontend, Backend, Mobile components # JIRA_STRATEGY=component-based # JIRA_PROJECT=MAIN # JIRA_COMPONENTS=Frontend,Backend,Mobile,QA # Strategy 3: Board-based (ONE PROJECT, FILTERED BOARDS) # Use when: Single project with board filters for teams # Example: MAIN project with Frontend Board (123), Backend Board (456) # JIRA_STRATEGY=board-based # JIRA_PROJECT=MAIN # JIRA_BOARDS=123,456,789,101 # ---------------------------------------------------------------------------- # Azure DevOps - Team-Based Structure (ONE PROJECT, MULTIPLE TEAMS) # ---------------------------------------------------------------------------- # Guide: https://dev.azure.com/ → User Settings → Personal Access Tokens # Scopes: Work Items (Read, Write), Code (Read) # Azure DevOps structure: Organization → Project (ONE) → Teams (multiple) AZURE_DEVOPS_PAT=your-ado-personal-access-token-52-chars-base64 AZURE_DEVOPS_ORG=your-organization-name AZURE_DEVOPS_PROJECT=your-project-name # Multiple teams within the project (comma-separated): AZURE_DEVOPS_TEAMS=Frontend,Backend,Mobile,QA # Single team (legacy, backward compatible): # AZURE_DEVOPS_TEAM=Frontend # Figma (https://www.figma.com/developers/api#authentication) # Navigate to: Settings → Account → Personal Access Tokens FIGMA_ACCESS_TOKEN=figd_your-figma-token # =================================== # Database Connections # =================================== # PostgreSQL DATABASE_URL=postgresql://user:password@localhost:5432/dbname # MySQL MYSQL_HOST=localhost MYSQL_PORT=3306 MYSQL_USER=your-mysql-user MYSQL_PASSWORD=your-mysql-password MYSQL_DATABASE=your-database-name # MongoDB MONGODB_URI=mongodb://localhost:27017/your-db-name # Redis REDIS_URL=redis://localhost:6379 # =================================== # API Keys & Services # =================================== # Stripe (https://dashboard.stripe.com/apikeys) STRIPE_SECRET_KEY=sk_test_your-stripe-secret-key STRIPE_PUBLISHABLE_KEY=pk_test_your-stripe-publishable-key STRIPE_WEBHOOK_SECRET=whsec_your-webhook-secret # SendGrid (https://app.sendgrid.com/settings/api_keys) SENDGRID_API_KEY=SG.your-sendgrid-api-key # Twilio (https://www.twilio.com/console) TWILIO_ACCOUNT_SID=your-twilio-account-sid TWILIO_AUTH_TOKEN=your-twilio-auth-token TWILIO_PHONE_NUMBER=+1234567890 # OpenAI (https://platform.openai.com/api-keys) OPENAI_API_KEY=sk-your-openai-api-key # Anthropic Claude (https://console.anthropic.com/) ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key # =================================== # Application Configuration # =================================== # Environment NODE_ENV=development # Application URL APP_URL=http://localhost:3000 # JWT Secret (generate with: openssl rand -hex 32) JWT_SECRET=your-jwt-secret-at-least-32-chars-long # Session Secret SESSION_SECRET=your-session-secret-at-least-32-chars-long # =================================== # Production Secrets Manager # =================================== # For production, consider using: # - Doppler: https://doppler.com # - AWS Secrets Manager: https://aws.amazon.com/secrets-manager/ # - 1Password: https://1password.com/ # - HashiCorp Vault: https://www.vaultproject.io/ # # DO NOT use .env files in production! # =================================== # Security Notes # =================================== # ✅ This file (.env.example) is committed to git # ❌ Your actual .env file is NEVER committed (in .gitignore) # 🔄 Rotate secrets every 90 days # 🔒 Use production secrets managers for deployment # 📝 Document where each secret comes from # 👥 Share .env.example with team, NOT .env