# Documenso Local Dev Loop

> Set up local development environment and testing workflow for Documenso. Use when configuring dev environment, setting up test workflows, or establishing rapid iteration patterns with Documenso. Trigger with phrases like "documenso local dev", "documenso development", "test documenso locally", "documenso dev environment".

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

---

# Documenso Local Dev Loop

## Overview
Configure a productive local development environment for Documenso integrations with fast iteration cycles.

## Prerequisites
- Completed `documenso-install-auth` setup
- Node.js 18+ or Python 3.10+
- Docker (optional, for self-hosted testing)
- Code editor with TypeScript support

## Instructions

### Step 1: Project Structure

### Step 2: Environment Configuration

**.env.development:**
**.env.test:**
### Step 3: Client Wrapper with Dev Helpers

### Step 4: Development Scripts

**package.json:**
### Step 5: Quick Verification Script

### Step 6: Test Cleanup Script

### Step 7: Integration Test Example

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

## Self-Hosted Local Development

For testing against a local Documenso instance:

**.env.local (for self-hosted):**
## Output
- Configured development environment
- Verification script passing
- Integration tests running against staging
- Cleanup script for test documents

## Error Handling
| Issue | Cause | Solution |
|-------|-------|----------|
| Connection refused | Wrong base URL | Check DOCUMENSO_BASE_URL |
| 401 on staging | Wrong API key | Get staging-specific key |
| Tests failing | Stale test data | Run cleanup script |
| Rate limited | Too many requests | Add delays between tests |

## Resources
- [Documenso Staging Environment](https://stg-app.documenso.com)
- [Self-Hosting Guide](https://docs.documenso.com/developers/self-hosting)
- [Developer Quickstart](https://docs.documenso.com/developers/local-development/quickstart)

## Next Steps
Apply patterns in `documenso-sdk-patterns` for production-ready code.

## Examples

**Basic usage**: Apply documenso local dev loop to a standard project setup with default configuration options.

**Advanced scenario**: Customize documenso local dev loop for production environments with multiple constraints and team-specific requirements.