# Technical Documentation: OpenSignLabs/OpenSign > ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/OpenSignLabs/OpenSign) ### Overview (`README.md`)

[The free and open source alternative to DocuSign](https://www.opensignlabs.com) [](http://isitmaintained.com/project/opensignlabs/opensign "Average time to resolve an issue") [](#contributors) Website • Help Docs • API Docs • Blog • Discord • Twitter • LinkedIn ## The premier open source document signing solution(DocuSign alternative) ---

### Table of Contents 1. [Introduction](#introduction) 2. [Features](#features) 3. [Installation](#installation) 4. [Usage](#usage) 5. [Contribution Guidelines](#contribution-guidelines) 6. [License](#license) 7. [Acknowledgments](#acknowledgments) --- Please star ⭐ the repo to support us! 😀 ### Introduction Welcome to OpenSign, the premier open source docusign alternative - document e-signing solution designed to provide a secure, reliable and free alternative to commercial esign platforms like DocuSign, PandaDoc, SignNow, Adobe Sign, Smartwaiver, SignRequest, HelloSign & Zoho sign. Our mission is to democratize the document signing process, making it accessible and straightforward for everyone. --- ### Features - **Secure PDF E-Signing:** With the help of robust encryption algorithms, OpenSign™ ensures maximum security, privacy & compatibility. Now sign unlimited documents even on the [cloud hosted free version of OpenSign](https://www.opensignlabs.com/). - **Annotate Documents:** OpenSign™ allows you to annotate PDF documents with an advanced signing pad that allows hand drawn signatures, uploaded images, typed signatures & saved signatures for the simplest open source document signing experience ever. - **User-Friendly Interface:** OpenSign™ was built while keeping Intuitive design in mind for ease of use. Features like "Sign yourself", "Templates", "One click signatures" and "OpenSign™ Drive" makes it stand out of the crowd and even makes it better than a lot of so-called industry leaders. OpenSign intends to provide the best document signing experience in the open source ecosystem. - **Multi-signer Support:** OpenSign's ability to invite multiple signers for signing along with the ability to invite by sharing signing links & being able to enforce signing in a sequence makes it the only open source solution that is fully loaded and allows it to compete head-to-head with established players in e-signature space. - **Email Unique Code(OTP) verification support for guest signers:** With OpenSign™, your documents are fully secure even when being signed by guest users. Guest signers can only sign the document after entering a unique code sent to their email address. - **"Expiring Docs" & "Rejection":** You can set documents to expire after certain number of days after which nobody will be able to sign. Not just this, OpenSign™ also allows signers to reject signing a document with a reason that will be promptly shared with the sender. - **Beautiful email templates:** All document signing invitations, completion notifications & reminders are formatted using great looking email templates. Not just this, you are even allowed to customise the email templates making your free document signing invitations look the way you always wanted them to be. - **PDF Template Creation:** OpenSign™ allows you to create and store PDF document templates for repeated use thereby saving you a lot of time & collect e-signatures seamlessly. - **OpenSign™ Drive:** It is a centralised secure vault for your digital documents that makes storing, signing, organizing, sharing & archieving your docs a breeze. - **Audit Trails & completion certificate:** Being a security focused solution, OpenSign™ makes it a top priority to save detailed logs for tracking document activities along with time-stamps, IP addresses, email IDs & phone numbers. A completion certificate is generated as soon as document is completed which contains all the document related logs for added safety. - **API Support:** OpenSign™ API allows seamless integration into existing systems and software. You can generate an API key from the app and refer the [official API docs](https://docs.opensignlabs.com/docs/API-docs/v1.1) to start integrating it in your existing applications. - **Integrations:** The open source document signing experience becomes even more seamless because of integrations with various Cloud storage systems, CRMs & enterprise platforms. We also have a Zapier integration that allows you to integrate it with virtually any application. Login page

--- ### Deploy Note: The default MongoDB instance used in deployment is not persistant and will be cleared on every restart. To retain your data, configure and supply your own MongoDB connection URL. #### DigitalOcean [](https://cloud.digitalocean.com/apps/new?repo=https://github.com/OpenSignLabs/Deploy-OpenSign-to-Digital-Ocean/tree/main&refcode=30db1c901ab0) #### Docker The simplest way to install OpenSign on your own server is using official docker images by running the following command - **Command for linux/MacOS** ``` export HOST_URL=https://opensign.yourdomain.com && curl --remote-name-all https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/docker-compose.yml https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/Caddyfile https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/.env.local_dev && mv .env.local_dev .env.prod && docker compose up --force-recreate ``` **Command for Windows (Powershell)** ``` $env:HOST_URL="https://opensign.yourdomain.com"; Invoke-WebRequest -Uri https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/docker-compose.yml -OutFile docker-compose.yml; Invoke-WebRequest -Uri https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/Caddyfile -OutFile Caddyfile; Invoke-WebRequest -Uri https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/.env.local_dev -OutFile .env.local_dev; Rename-Item -Path .env.local_dev -NewName .env.prod; docker compose up --force-recreate ``` **Command for Windows (CMD/Terminal)** ``` set HOST_URL=https://opensign.yourdomain.com && curl -O https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/docker-compose.yml && curl -O https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/Caddyfile && curl -O https://raw.githubusercontent.com/OpenSignLabs/OpenSign/main/.env.local_dev && rename .env.local_dev .env.prod && docker compose up --force-recreate ``` Make sure that you have `Docker` and `git` installed before you run this command - Please refer to the [Installation Guide](https://docs.opensignlabs.com/docs/self-host/docker/run-locally/) for detailed instructions on how to install OpenSign on your system. --- ### Usage For comprehensive guidelines on how to use OpenSign™, please consult our [User Manual](USAGE.md). --- ### Contribution Guidelines We welcome contributions from the open-source community. For more information on how to contribute, please read our [Contribution Guidelines](CONTRIBUTING.md). --- ### License OpenSign is licensed under the AGPL-3 License. For more details, see the [LICENSE](LICENSE) file. --- ### Acknowledgments We would like to thank all our contributors and users for their support and feedback. Special thanks to [OpenSignLabs](https://www.opensignlabs.com) for spearheading this initiative. --- ## Contributors

_{Aleksandar Jakovljevic} 💻	_{Priyanshu Dwivedi} 💻	_{Akriti Sengar} 💻	_{Parth Chawande} 💻	_{Rishabh Dewangan} 💻	_{Nitin Mishra} 💻	_{Jobin Selvanose} 📖
_{Hans Fraiponts} 📖	_{Monil Prajapati} 💻	_{Edogbanya Emmanuel} 🐛	_pranav514 💻	_Aria 💻	_{Soumyadipto Pal} 💻	_{Andrey Didenko} 💻
_{VishakhaSainani} 💻	_Andrew 💻	_Rishab 💻	_{Maurizio Pillitu} 🐛	_{Luis Parra} ️️️️♿️	_{Govinda Kocharekar} 💻	_{Bilal Ahmad Bhat} 💻
_Vikram 💻	_ugoconsonni 💻	_{Daniel Mutwiri} 💻	_Zathiel 💻	_1024mb 🌍	_{Eugene Howe} 💻

This project is tested with BrowserStack. --- ### Overview (`apps/OpenSign/README.md`) # Open Sign Open source is true platform to sign pdf with digital signature ## Available Scripts In the project directory, you can run: ### `npm start` Runs the app in the development mode.\ Open [http://localhost:3000](http://localhost:3000) to view it in your browser. The page will reload when you make changes.\ You may also see any lint errors in the console. ### `npm run build` Builds the app for production to the `build` folder.\ It correctly bundles React in production mode and optimizes the build for the best performance. The build is minified and the filenames include the hashes.\ Your app is ready to be deployed! See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information. --- ### Apps OpenSign Docs DARK MODE USAGE (`apps/OpenSign/docs/DARK_MODE_USAGE.md`) # Tailwind Dark Mode Usage Guide ## Overview This guide shows how to use the new Tailwind utilities for better dark mode visibility in OpenSign. ## Button Styling ### VS Code-style Disabled Buttons ```jsx // Option 1: Direct VS Code styling // Option 2: Themed disabled styling // Option 3: Conditional styling ``` ## Icon Styling ### Theme-aware Icons ```jsx // Better visibility in dark mode // Muted but still visible // Disabled state ``` ### CSS Variable Approach ```jsx // Using CSS variables // Inline styles with CSS variables ``` ### Legacy JavaScript Function (Still Supported) ```jsx // Existing approach - still works ``` ## Text Styling ### Improved Gray Text ```jsx // These automatically improve in dark mode More visible in dark mode Muted but readable Clear text ``` ## Complete Examples ### Toolbar with Better Visibility ```jsx const Toolbar = () => (

); ``` ### Form with Disabled States ```jsx const Form = ({ isSubmitting }) => (

); ``` ## React-Tour and Tooltip Dark Mode Support ### React-Tour Modals The react-tour modals now automatically support dark mode with VS Code-inspired styling: ```jsx // These components automatically get dark mode styling ``` ### ReactTooltip Components All ReactTooltip instances now support dark mode: ```jsx // Automatically styled for dark mode

Tooltip content

``` ### HoverCard Balloon UI The balloon tooltips in OpenSign Drive now properly support dark mode: ```jsx // These automatically get dark styling in dark mode Document information ``` ## Dark Mode Features Added ### 1. **React-Tour Modal Styling** - Background: `#1F2937` (VS Code modal background) - Text: `#E5E7EB` (soft white for readability) - Borders: `#374151` (subtle borders) - Buttons: VS Code-style primary/secondary buttons ### 2. **ReactTooltip Styling** - Background: `#1F2937` with proper contrast - Border: `#374151` for definition - Box shadow: Enhanced for dark backgrounds - Text: `#E5E7EB` for optimal readability ### 3. **HoverCard Balloon UI** - Background: `#1F2937` (matches VS Code) - Text: `#E5E7EB` for readability - Arrow: Automatically matches background color - Enhanced shadows for dark backgrounds ### 4. **React-Datepicker Support** - Calendar background: `#1F2937` - Selected dates: VS Code blue (`#007ACC`) - Hover states: Proper contrast ratios - Navigation arrows: Themed appropriately ## CSS Classes Reference | Class | Purpose | Dark Mode Color | |-------|---------|----------------| | `icon-improved` | Better icon visibility | `#CCCCCC` | | `icon-muted` | Muted but visible icons | `#999999` | | `icon-disabled` | Disabled icon state | `#858585` | | `op-btn-vscode-disabled` | VS Code disabled button | Background: `#3C3C3C` | | `btn-themed-disabled` | Themed disabled button | Uses CSS variables | | `icon-themed` | Variable-based icon color | `var(--icon-color)` | | `.reactour__helper` | `#1F2937` background | | `.react-tooltip` | `#1F2937` background | | `.HoverCardContent` | `#1F2937` background | | `.react-datepicker` | `#1F2937` background | ## Migration Guide ### From JavaScript Function to Tailwind ```jsx // Before // After ``` ### From Hardcoded Colors to Theme-aware ```jsx // Before // After (automatic improvement) // OR explicitly ``` ## Migration Notes All existing tooltip and tour components will automatically inherit the new dark mode styling when the theme is set to `opensigndark`. No code changes required for existing implementations. --- --- METRICS --- - Files Extracted: 3 - Estimated Token Budget: ~5976 tokens - Canonical Reference: https://codewiki.google/github.com/OpenSignLabs/OpenSign