mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
316 lines
22 KiB
HTML
316 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-sign</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-sign.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-sign">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-sign.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-sign</h1><p class="lede">Hanzo Sign is an open-source DocuSign alternative for electronic document signing.</p><h1>Hanzo Sign - Open Source Document Signing</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-id.md</code>, <code>hanzo/hanzo-kms.md</code>, <code>hanzo/hanzo-platform.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Sign is an <strong>open-source DocuSign alternative</strong> for electronic document signing. Turborepo monorepo with a React Router (Remix) + Hono server frontend, tRPC + ts-rest APIs, Prisma ORM, and PDF signing via P12 certificates or Google Cloud KMS. Live at <code>sign.hanzo.ai</code>. Version 2.7.1. Licensed AGPL-3.0.</p>
|
|
<h3>Why Hanzo Sign?</h3>
|
|
<ul><li><strong>Self-hostable</strong>: Full control over your signing infrastructure</li><li><strong>Open source</strong>: Inspect and audit the entire signing pipeline</li><li><strong>Multiple signing providers</strong>: Local P12 certificates or Google Cloud HSM</li><li><strong>Swappable storage</strong>: Database or S3-compatible object storage</li><li><strong>API-first</strong>: REST (V1) and tRPC (V2) APIs with OpenAPI spec</li><li><strong>Enterprise features</strong>: Teams, custom branding, webhooks, bulk sending</li><li><strong>i18n</strong>: Multi-language via Lingui</li><li><strong>AI integration</strong>: Google Vertex AI (Gemini) for document analysis</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Frontend</strong>: React 18, React Router v7 (Remix), Tailwind CSS, shadcn/ui, Radix UI</li><li><strong>Server</strong>: Hono (on Node.js)</li><li><strong>Database</strong>: PostgreSQL 15 (Prisma ORM + Kysely)</li><li><strong>API</strong>: tRPC (V2, current), ts-rest (V1, deprecated)</li><li><strong>Auth</strong>: Arctic (OAuth), WebAuthn/Passkeys, Hanzo IAM (hanzo.id)</li><li><strong>Email</strong>: React Email, Nodemailer (SMTP, Resend, MailChannels)</li><li><strong>PDF</strong>: @libpdf/core, pdfjs-dist, PDF-Lib</li><li><strong>Jobs</strong>: Inngest or local database-backed queue</li><li><strong>Build</strong>: Turborepo + npm workspaces, Vite</li><li><strong>Testing</strong>: Playwright (E2E)</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>hanzoai/sign</code> (fork of <code>documenso/documenso</code>).</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Sending documents for electronic signature</li><li>Building document signing workflows</li><li>Self-hosting a DocuSign-like service</li><li>Creating document templates for recurring signatures</li><li>Bulk sending documents via API</li><li>Embedding signing into existing applications</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Node.js</strong> v22 or above</li><li><strong>PostgreSQL</strong> database</li><li><strong>SMTP server</strong> or email provider (Resend, MailChannels)</li><li><strong>P12 signing certificate</strong> (or Google Cloud KMS)</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | UI | <code>https://sign.hanzo.ai</code> (port 3000) | | API V2 | <code>/api/v2/<em></code> (tRPC + OpenAPI) | | API V1 | <code>/api/v1/</em></code> (ts-rest, deprecated) | | Auth | Arctic OAuth + WebAuthn + Hanzo IAM | | DB | PostgreSQL (Prisma + Kysely) | | Root package | <code>@hanzo/sign-root</code> | | Version | 2.7.1 | | License | AGPL-3.0 | | Repo | <code>github.com/hanzoai/sign</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Developer Quickstart (Docker)</h3>
|
|
<pre><code class="lang-bash"># Clone and setup
|
|
git clone https://github.com/hanzoai/sign.git
|
|
cd sign
|
|
cp .env.example .env
|
|
|
|
# One command: install, start db/mail containers, migrate, seed, dev
|
|
npm run d</code></pre>
|
|
<h3>Manual Setup</h3>
|
|
<pre><code class="lang-bash">npm install
|
|
cp .env.example .env
|
|
|
|
# Set required env vars:
|
|
# NEXTAUTH_SECRET, NEXT_PUBLIC_WEBAPP_URL
|
|
# NEXT_PRIVATE_DATABASE_URL, NEXT_PRIVATE_DIRECT_DATABASE_URL
|
|
# NEXT_PRIVATE_SMTP_FROM_NAME, NEXT_PRIVATE_SMTP_FROM_ADDRESS
|
|
|
|
npm run prisma:migrate-dev
|
|
npm run translate:compile
|
|
npm run dev</code></pre>
|
|
<h3>Docker (Production)</h3>
|
|
<pre><code class="lang-bash">docker run -d --restart=unless-stopped \
|
|
-p 3000:3000 \
|
|
-v hanzo-sign:/app/data \
|
|
--name hanzo-sign \
|
|
hanzo-sign:latest</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code> Remix App (Hono Server)
|
|
apps/remix
|
|
/api/v1/* /api/v2/* /api/trpc/* /api/jobs/* React Router UI
|
|
(ts-rest) (tRPC) (tRPC) (Jobs API)
|
|
| | | |
|
|
@hanzo/sign-api @hanzo/sign-trpc @hanzo/sign-lib @hanzo/sign-email
|
|
|
|
|
+--------------+--------------+
|
|
| | |
|
|
Storage Jobs PDF Signing
|
|
Provider Provider Provider
|
|
| | |
|
|
DB or S3 Inngest/Local Local P12 or GCloud HSM</code></pre>
|
|
<h3>Monorepo Packages</h3>
|
|
<p><strong>Applications</strong> (<code>apps/</code>):</p>
|
|
<p>| Package | Description | Port | |---------|-------------|------| | <code>@hanzo/sign-remix</code> | Main app (React Router + Hono) | 3000 | | <code>@hanzo/sign-documentation</code> | Documentation site (Nextra) | 3002 | | <code>@hanzo/sign-openpage-api</code> | Public analytics API | 3003 |</p>
|
|
<p><strong>Core Packages</strong> (<code>packages/</code>):</p>
|
|
<p>| Package | Description | |---------|-------------| | <code>@hanzo/sign-lib</code> | Core business logic (server, client, universal) | | <code>@hanzo/sign-trpc</code> | tRPC API layer with OpenAPI (V2) | | <code>@hanzo/sign-api</code> | REST API layer via ts-rest (V1) | | <code>@hanzo/sign-prisma</code> | Database layer (Prisma ORM + Kysely) | | <code>@hanzo/sign-ui</code> | UI components (shadcn + Radix + Tailwind) | | <code>@hanzo/sign-email</code> | Email templates (React Email) | | <code>@hanzo/sign-auth</code> | Auth (Arctic OAuth, WebAuthn/Passkeys) | | <code>@hanzo/sign-signing</code> | PDF signing (Local P12, Google Cloud KMS) | | <code>@hanzo/sign-ee</code> | Enterprise Edition features | | <code>@hanzo/sign-assets</code> | Static assets |</p>
|
|
<h3>Swappable Providers</h3>
|
|
<p><strong>Storage</strong> (<code>NEXT_PUBLIC_UPLOAD_TRANSPORT</code>):</p>
|
|
<ul><li><code>database</code> -- Store files as Base64 in PostgreSQL (default)</li><li><code>s3</code> -- S3-compatible storage (AWS, MinIO, etc.)</li></ul>
|
|
<p><strong>PDF Signing</strong> (<code>NEXT_PRIVATE_SIGNING_TRANSPORT</code>):</p>
|
|
<ul><li><code>local</code> -- P12 certificate file (default)</li><li><code>gcloud-hsm</code> -- Google Cloud KMS Hardware Security Module</li></ul>
|
|
<p><strong>Email</strong> (<code>NEXT_PRIVATE_SMTP_TRANSPORT</code>):</p>
|
|
<ul><li><code>smtp-auth</code> -- Standard SMTP with credentials (default)</li><li><code>smtp-api</code> -- SMTP with API key</li><li><code>resend</code> -- Resend API</li><li><code>mailchannels</code> -- MailChannels API</li></ul>
|
|
<p><strong>Background Jobs</strong> (<code>NEXT_PRIVATE_JOBS_PROVIDER</code>):</p>
|
|
<ul><li><code>local</code> -- Database-backed queue (default)</li><li><code>inngest</code> -- Managed cloud service</li></ul>
|
|
<h3>Document Signing Flow</h3>
|
|
<ol><li>Upload document to storage provider (DB or S3)</li><li>Add recipients (signers, viewers, approvers)</li><li>Add signature fields (positions on PDF)</li><li>Send document (triggers email job)</li><li>Recipient signs via unique link</li><li><code>seal-document</code> job finalizes the PDF</li><li>Signing provider cryptographically signs the PDF</li><li>Signed PDF stored back to storage provider</li></ol>
|
|
<h3>Auth / IAM Integration</h3>
|
|
<p>Hanzo Sign supports Hanzo IAM (hanzo.id) for production auth:</p>
|
|
<pre><code class="lang-bash">IAM_URL="https://hanzo.id"
|
|
IAM_CLIENT_ID="<your-client-id>"
|
|
IAM_CLIENT_SECRET="<your-client-secret>"</code></pre>
|
|
<p>Also supports Google OAuth, Microsoft OAuth, and generic OIDC providers.</p>
|
|
<h3>Signing Certificates</h3>
|
|
<p>For local signing, generate a P12 certificate:</p>
|
|
<pre><code class="lang-bash">openssl genrsa -out private.key 2048
|
|
openssl req -new -x509 -key private.key -out certificate.crt -days 365
|
|
read -s -p "Enter certificate password: " CERT_PASS
|
|
openssl pkcs12 -export -out certificate.p12 -inkey private.key -in certificate.crt \
|
|
-password env:CERT_PASS -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES -macalg sha1</code></pre>
|
|
<p>Place at <code>apps/remix/resources/certificate.p12</code>.</p>
|
|
<h3>Environment Variables</h3>
|
|
<p>| Variable | Purpose | Options | |----------|---------|---------| | <code>NEXTAUTH_SECRET</code> | Session encryption | Random string | | <code>NEXT_PUBLIC_WEBAPP_URL</code> | Public URL | <code>https://sign.hanzo.ai</code> | | <code>NEXT_PRIVATE_DATABASE_URL</code> | PostgreSQL connection | Connection string | | <code>NEXT_PUBLIC_UPLOAD_TRANSPORT</code> | Storage provider | <code>database</code>, <code>s3</code> | | <code>NEXT_PRIVATE_SIGNING_TRANSPORT</code> | Signing provider | <code>local</code>, <code>gcloud-hsm</code> | | <code>NEXT_PRIVATE_SMTP_TRANSPORT</code> | Email provider | <code>smtp-auth</code>, <code>smtp-api</code>, <code>resend</code>, <code>mailchannels</code> | | <code>NEXT_PRIVATE_JOBS_PROVIDER</code> | Jobs provider | <code>local</code>, <code>inngest</code> | | <code>IAM_URL</code> | Hanzo IAM endpoint | <code>https://hanzo.id</code> |</p>
|
|
<h3>Development Services (Docker)</h3>
|
|
<p>| Service | Port | |---------|------| | PostgreSQL | 54320 | | Inbucket (Mail UI) | 9000 | | Inbucket (SMTP) | 2500 | | MinIO (S3 Dashboard) | 9001 | | MinIO (S3 API) | 9002 |</p>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | No emails received | Using dev quickstart | Check Inbucket at http://localhost:9000 | | "Failed to get private key bags" | P12 cert has no password | Re-create with password (min 4 chars) | | Can't see env vars in scripts | Env not loaded | Wrap with <code>npm run with:env -- npm run myscript</code> | | IPv6 deployment | Default binds IPv4 | Pass <code>npm run start -- -H ::</code> | | Lingui errors | Translations not compiled | Run <code>npm run translate:compile</code> |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-id.md</code> - IAM and authentication (hanzo.id)</li><li><code>hanzo/hanzo-kms.md</code> - Secret management</li><li><code>hanzo/hanzo-platform.md</code> - PaaS deployment</li><li><code>hanzo/hanzo-commerce.md</code> - E-commerce (contracts, checkout)</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: signing, documents, pdf, docusign, e-signature <strong>Prerequisites</strong>: Node.js 22+, PostgreSQL, SMTP</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-sign.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |