.env.example•3.73 kB
# SmartSuite API Shim - Environment Configuration
# Copy this file to .env and fill in your actual values
# ==============================================================================
# REQUIRED: SmartSuite API Configuration
# ==============================================================================
# SmartSuite API Token - Get this from SmartSuite Settings > API
# Format: 40-character hexadecimal string
SMARTSUITE_API_TOKEN=your-smartsuite-api-token-here
# SmartSuite Workspace ID - Found in your SmartSuite URL or API responses
# Example: s3qnmox1 (EAV production workspace)
SMARTSUITE_WORKSPACE_ID=your-workspace-id-here
# ==============================================================================
# OPTIONAL: SmartSuite Configuration
# ==============================================================================
# Override default API base URL (usually not needed)
# Default: https://app.smartsuite.com/api/v1
# SMARTSUITE_BASE_URL=https://app.smartsuite.com/api/v1
# Rate limiting configuration (seconds between requests)
# Default: 0.2 (5 requests per second)
# SMARTSUITE_RATE_LIMIT_DELAY=0.2
# Retry configuration for failed requests
# Default: 3
# SMARTSUITE_MAX_RETRIES=3
# ==============================================================================
# OPTIONAL: Test Environment Configuration
# ==============================================================================
# Test workspace for development/testing (if different from production)
# TEST_WORKSPACE_ID=your-test-workspace-id
# Test environment solution IDs (SmartSuite test environments)
# Example test environments from EAV:
# - TEST EAV PROD: 68ab34b30b1e05e11a8ba87e (3 applications, 4 records)
# - Test-Environment: 68abe5f1572f2eb9d97c0c71 (1 application, 11 records)
# TEST_SOLUTION_ID=your-test-solution-id
# ==============================================================================
# OPTIONAL: Specific Table/Application IDs (for quick access)
# ==============================================================================
# Common table IDs for your workspace (customize based on your SmartSuite setup)
# Example from EAV Operations:
# PROJECTS_TABLE_ID=68a8ff5237fde0bf797c05b3
# TASKS_TABLE_ID=68a8ffac490e5496953e5b1c
# VIDEOS_TABLE_ID=68b2437a8f1755b055e0a124
# ==============================================================================
# OPTIONAL: Supabase Configuration (for shared field mappings)
# ==============================================================================
# Supabase Project URL
# SUPABASE_URL=https://your-project.supabase.co
# Supabase Anonymous/Public Key (safe for client-side)
# SUPABASE_ANON_KEY=your-anon-key-here
# ==============================================================================
# OPTIONAL: Debug and Logging
# ==============================================================================
# Enable debug mode for detailed logging
# DEBUG=true
# Log level: error, warn, info, debug
# Default: info
# LOG_LEVEL=info
# Enable dry-run mode by default (safety first)
# Forces all mutations to preview mode unless explicitly overridden
# SMARTSUITE_DRY_RUN=true
# ==============================================================================
# NOTES
# ==============================================================================
#
# 1. NEVER commit .env file to version control
# 2. API tokens are sensitive - keep them secure
# 3. Use test environments for development
# 4. Always test with DRY_RUN=true first
# 5. Rate limits prevent API quota exhaustion
#
# For more information, see:
# - README.md for setup instructions
# - docs/guides/smartsuite-setup.md for API token generation
# - docs/architecture/D3-BLUEPRINT.md for system architecture