Agent skill · software engineering · jeremylongshore
documenso-local-dev-loop
Set up local development environment and testing workflow for Documenso.
Why this skill is useful
Adds specific Docker commands and configuration patterns for setting up a local development environment with Documenso that the AI wouldn't reliably generate on its own.
What it needs
Requires docker, node installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Documenso Local Dev Loop Output A small test-backed local change using synthetic documents/signers and a normal source-control rollback path. A redacted development verification receipt without document content, signing links, credentials, or signer PII. Examples Use a development workspace with a synthetic template and signer, make one integration/config change, run its focused tests and a bounded lifecycle check, then inspect redacted status. Commit only reviewed changes; never use production documents, signing URLs, or credentials in local development. Overview Configure a fast local development environment for Documenso integrations. Covers project structure, environment configs, self-hosted Documenso via Docker, test utilities, and cleanup scripts. Prerequisites Completed documenso-install-auth setup Node.js 18+ with TypeScript Docker (for self-hosted local Documenso) Instructions Step 1: Project Structure Step 2: Environment Configuration .env.development: .env.test: Step 3: Client Wrapper with Dev Helpers Step 4: Self-Hosted Local Documenso (Docker) .env.local (for self-hosted dev): Step 5: Quick Verification Script Step 6: Test Cleanup Script Step 7: Development Scripts (package.json) Error Handling Issue Cause Solution ------- ------- ---------- ECONNREFUSED localhost:3000 Docker not running Run docker compose up -d 401 on staging Wrong API key for env Check .env.development key matches staging Stale test data Tests didn't clean up Run npm run dev:cleanup Rate limited in tests Too many requests Add await delay(500) between API calls Emails not arriving SMTP misconfigured Check MailHog at localhost:8025 Resources Documenso Self-Hosting Developer Quickstart Environment Variables Reference MailHog Next Steps Apply patterns in documenso-sdk-patterns for production-ready code structure.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/documenso-local-dev-loop--33bb08