README

The Open Source DocuSign Alternative.
  
    Learn more »
    
    
    Discord
    ·
    Website
    ·
    Documentation
    ·
    Issues
    ·
    Upcoming Releases
    ·
    Roadmap
  



   
   
   
   
   
   
   
   



  


 About Documenso

Signing documents digitally should be fast and easy and should be the best practice for every document signed worldwide. This is technically quite easy today, but it also introduces a new party to every signature: The signing tool providers. While this is not a problem in itself, it should make us think about how we want these providers of trust to work. Documenso aims to be the world's most trusted document-signing tool. This trust is built by empowering you to self-host Documenso and review how it works under the hood.

Join us in creating the next generation of open trust infrastructure.

 Recognition


  
  


 Community and Next Steps 🎯

- Try Documenso by self-hosting it or signing up at documenso.com.
- Tell us what you think in the Discussions.
- Join the Discord server for any questions and getting to know other community members.
- ⭐ the repository to help us raise awareness.
- Open detailed issues to report bugs or propose features.

 Contributing

 Note: We no longer accept external pull requests, aside from a small group of trusted contributors we reach out to directly. The best way to contribute is through detailed issues. Read Why We're Pausing External Pull Requests for the reasoning.

- Documenso stays open source. You can read, audit, run, and fork the code.
- To report issues or propose changes, see our contribution guide.

 Contact us

Contact us if you are interested in our Enterprise plan for large organizations that need extra flexibility and control.



 Tech Stack


  
  
  
  
  
  
  
  


- TypeScript - Language
- React Router v7 - Framework
- Hono - Server
- Prisma - ORM
- Tailwind CSS - CSS
- shadcn/ui + Radix UI - Component Library
- react-email - Email Templates
- Lingui - Internationalization
- tRPC - API
- @libpdf/core - PDF Signatures
- pdf.js - Viewing PDFs
- @cantoo/pdf-lib - PDF manipulation
- Stripe - Payments
- Biome - Linting & Formatting
- Playwright - E2E Testing



 Local Development

 Requirements

To run Documenso locally, you will need

- Node.js (v24 or above)
- Postgres SQL Database
- Docker (optional)

 Developer Quickstart

 Note: This is a quickstart for developers. It assumes that you have both docker and docker-compose installed on your machine.

Want to get up and running quickly? Follow these steps:

1. Fork this repository to your GitHub account.

After forking the repository, clone it to your local device by using the following command:

sh
git clone https://github.com//documenso


2. Set up your .env file using the recommendations in the .env.example file. Alternatively, just run cp .env.example .env to get started with our handpicked defaults.

3. Run npm run dx in the root directory

   - This will spin up a postgres database and inbucket mai