Skip to content

Open source · Pre-release

E-signatures you run on your own servers

Send a PDF, collect signatures in the order you choose and get back one sealed file with an audit trail anyone can check. Embed the TypeScript packages in your product, or run the service with Docker.

  1. 1Send
  2. 2Sign
  3. 3Seal
  4. 4Verify

How it works

Four steps, from the first invitation to a file you can prove.

  1. 1

    Send

    Upload a PDF, add the people who need to sign and place their fields. Each person gets a private link that expires.

  2. 2

    Sign in order

    Signers act one after another, or all at once. Each can confirm a one-time code by email or SMS before signing.

  3. 3

    Seal

    After the last signature, the values are drawn onto the pages, a certificate page is added and the file is sealed with your certificate.

  4. 4

    Verify

    Anyone with the file can check the seal and the audit trail offline, without asking the server that produced it.

What you get

Small packages with clear jobs. Use the whole service, or only the parts you need.

  • Signing order

    Sequential or parallel routing. People with the same order sign together. Reminders and expiry are built in.

  • One-time codes

    Email or SMS codes: six digits, valid for ten minutes, locked after five wrong tries and rate limited.

  • Tamper-evident audit trail

    Every action is appended to a log chained with SHA-256. The chain head is printed on the certificate page.

  • PAdES seal

    The final PDF carries a PAdES signature made with your certificate. Any later edit shows up in Adobe Reader.

  • Aadhaar eSign

    For documents that need a statutory signature in India, through your own account with a licensed provider.

  • React components

    A signature pad, a signing view and field placement. Unstyled, and themed with CSS variables.

  • Self-host with Docker

    One image configured with environment variables, PostgreSQL and your mail server. Documents stay with you.

  • Open source

    Apache-2.0 libraries you can use in any product, and an AGPL-3.0 server and app you can self-host for free. Read every line, no usage limits.

Embed it in your backend

Start the server inside your own Node app, then create and send envelopes over its HTTP API with an API key.

Pre-release Not on npm yet; build it from the repository. The API may change before 0.1.

Read the Node guide
ts
import { readFile } from 'node:fs/promises';
import { startSignServer } from '@codevibe_technology/sign-server';

const sign = await startSignServer({
  databaseUrl: process.env.DATABASE_URL!,
  filesDir: './data/files',
  smtp: {
    host: 'smtp.example.com',
    port: 587,
    secure: false,
    user: 'sign',
    pass: process.env.SMTP_PASS!,
    from: 'Sign <sign@example.com>',
  },
  seal: { p12: await readFile('./seal.p12'), passphrase: process.env.SEAL_P12_PASSPHRASE! },
  apiKeys: [process.env.SIGN_API_KEY!],
  publicUrl: 'https://sign.example.com',
});

await sign.listen(3000);

Built by Codevibe

Codevibe Sign is made and maintained by Codevibe, and it is the signing layer in our own products. The code, the issues and the roadmap are public.

First product using it

Hrvibe uses Codevibe Sign for employee documents such as offer letters and policies.

How the law in India sees each one, in short.

Some documents cannot be signed electronically at all, such as wills, powers of attorney and property sale deeds. This is not legal advice. Read the legal notes.

Questions

Is it free?

Yes. The libraries are Apache-2.0 and the server and app are AGPL-3.0, free to self-host. You pay only for what you run it on: your server, your mail and SMS delivery, and eSign credits with your provider if you use Aadhaar eSign.

Can I use it in production today?

Not yet. Every package works end to end and is tested, but nothing is published to npm and the APIs may change before 0.1. Try it now and wait for 0.1 before you rely on it.

Do my documents leave my servers?

No. You run the service, so documents, keys and personal data stay in your infrastructure. The one exception is Aadhaar eSign, where the document goes to the eSign provider you chose.

Is a signature made with it legally valid?

In India, an agreement signed electronically is generally enforceable, and the audit trail is the evidence. Some documents need a statutory electronic signature such as Aadhaar eSign, and a few cannot be signed electronically at all. See the legal page, and take your own advice.

What certificate do I need to seal files?

A PKCS#12 file with a certificate and key. It identifies you as the operator, not the signer. A self-signed certificate works for testing; for files other people will open in Adobe Reader, use one from a trusted issuer.

Does Codevibe sell Aadhaar eSign?

No. You open an account with a provider such as Leegality, buy credits from them and give the package your API keys. Each eSign is billed to you by the provider.

Can I build a commercial product on it?

Yes. The licence allows it. The licence does not cover the Codevibe names and logos, so please do not call your product or hosted service "Codevibe Sign".

Which stack does it need?

Node 20 or later and PostgreSQL for the server. Your own backend can be in any language, since it talks to the server over HTTP. The UI components are for React.

Read the docs, then try it

Start with the concepts, or go straight to sending your first envelope.

Libraries under Apache-2.0, server and apps under AGPL-3.0. "Codevibe", "Codevibe Sign" and "Hrvibe" are trademarks of Codevibe Technology and are not covered by the licences.