# Documenso Multi Env Setup

> Configure Documenso across multiple environments (dev, staging, production). Use when setting up environment-specific configurations, managing API keys, or implementing environment promotion workflows. Trigger with phrases like "documenso environments", "documenso staging", "documenso dev setup", "multi-environment documenso".

- Skill: `micsapp/documenso-multi-env-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add micsapp/documenso-multi-env-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/micsapp/documenso-multi-env-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: micsapp (https://skillmd.com/u/micsapp)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/micsapp/documenso-multi-env-setup

---

# Documenso Multi-Environment Setup

## Overview
Configure and manage Documenso integrations across development, staging, and production environments with proper isolation and promotion workflows.

## Prerequisites
- Documenso accounts for each environment (or self-hosted instances)
- Environment management infrastructure
- Secret management solution (Vault, AWS Secrets Manager, etc.)

## Instructions

### Step 1: Environment Architecture
┌─────────────────────────────────────────────────────────┐
### Step 2: Configuration Files
// config/documenso.development.json
### Step 3: Environment Variables
NODE_ENV=development
### Step 4: Client Factory
// src/documenso/factory.ts
### Step 5: Mock Client for Development
// src/documenso/mock.ts
### Step 6: Environment Promotion
// scripts/promote-templates.ts
### Step 7: Webhook Configuration Per Environment
// src/webhooks/config.ts
### Step 8: Testing Across Environments
// tests/integration/environment.test.ts

For detailed implementation code and configurations, load the reference guide:
`Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)`

## Output
- Environment Architecture
- Configuration Files
- Environment Variables
- Client Factory
- Mock Client for Development
- Environment Promotion

## Error Handling
| Issue | Cause | Solution |
|-------|-------|----------|
| Wrong environment | Missing NODE_ENV | Set explicitly |
| Key mismatch | Using wrong key | Check env var names |
| Config not loading | File path wrong | Verify config files |
| Mock not working | mockEnabled: false | Enable in dev config |

## Resources
- [12-Factor App Config](https://12factor.net/config)
- [Environment Management](https://docs.documenso.com/developers)
- [Secret Management Best Practices](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)

## Next Steps
For monitoring setup, see `documenso-observability`.

## Examples

**Basic usage**: Apply documenso multi env setup to a standard project setup with default configuration options.

**Advanced scenario**: Customize documenso multi env setup for production environments with multiple constraints and team-specific requirements.