Files
skills/public/hanzo-dataroom.md

5.7 KiB

Hanzo Dataroom - Document Sharing & Analytics

Category: Hanzo Ecosystem Related Skills: hanzo/hanzo-platform.md, hanzo/hanzo-iam.md

Overview

Hanzo Dataroom is the open-source DocSend alternative -- a document sharing platform with built-in analytics, custom domains, and secure link-based access. Papermark fork rebranded for the Hanzo ecosystem. Built with Next.js 15, Prisma ORM on PostgreSQL, and Tinybird for analytics. Supports S3/Vercel Blob storage, Stripe billing, SAML SSO (BoxyHQ), and Hanzo IAM OAuth. Enterprise features live in ee/ under a separate license.

What it actually is

  • Next.js 15 full-stack app (pages router + app router)
  • Prisma ORM with PostgreSQL (multi-schema: prisma/schema/)
  • Document storage: AWS S3 or Vercel Blob (configurable)
  • Analytics: Tinybird (page-by-page view tracking)
  • Auth: NextAuth.js with Hanzo IAM OAuth, passkeys (Hanko)
  • Email: Resend (transactional) + react-email templates
  • Payments: Stripe (in ee/stripe/)
  • Background jobs: Trigger.dev v3
  • Rich text: Tiptap editor
  • PDF rendering: react-pdf, mupdf, pdf-lib
  • AI features: OpenAI + Google Vertex AI SDKs for document AI
  • Notion import: react-notion-x
  • Enterprise: SAML SSO, custom branding, datarooms (in ee/)
  • Deployed at dataroom.hanzo.ai

Upstream

Fork of Papermark. Description still references Papermark. License: AGPLv3 (core) + enterprise license (ee/LICENSE.md).

When to use

  • Sharing documents with per-page view analytics
  • Building a branded document portal with custom domains
  • Investor datarooms with NDA/email verification gates
  • Self-hosting a DocSend alternative

Quick reference

Item Value
Repo github.com/hanzoai/dataroom
Package hanzo-dataroom (private)
Version 0.1.0
Branch main
Stack Next.js 15, React 18, TypeScript, Tailwind CSS
ORM Prisma 6.5 on PostgreSQL
Auth NextAuth.js + Hanzo IAM OAuth + passkeys (Hanko)
Analytics Tinybird
Storage AWS S3 or Vercel Blob
Payments Stripe
Email Resend + react-email
Jobs Trigger.dev v3
AI OpenAI, Google Vertex AI
License AGPLv3 (core), enterprise license (ee/)
Live dataroom.hanzo.ai
Node >= 22

Quickstart

git clone https://github.com/hanzoai/dataroom.git
cd dataroom
npm install

# Configure
cp .env.example .env
# Required: POSTGRES_PRISMA_URL, NEXTAUTH_SECRET, BLOB_READ_WRITE_TOKEN or S3 creds
# Auth: IAM_URL, IAM_CLIENT_ID, IAM_CLIENT_SECRET
# Email: RESEND_API_KEY
# Analytics: TINYBIRD_TOKEN

# Initialize database
npm run dev:prisma

# Development
npm run dev # http://localhost:3000

# Production
npm run build
npm start

Architecture

dataroom.hanzo.ai
 |
 Next.js 15 App
 |
 ┌────┼────────┬──────────┬──────────┐
 │ │ │ │ │
PostgreSQL S3/Blob Tinybird Stripe
(Prisma) (docs) (analytics) (billing)
 │
 ├── Hanzo IAM (OAuth)
 ├── Resend (email)
 ├── Trigger.dev (jobs)
 └── Hanko (passkeys)

Directory structure

hanzoai/dataroom/
 package.json # hanzo-dataroom v0.1.0
 Dockerfile # Container build
 middleware.ts # Auth + custom domain routing
 next.config.mjs # Image domains, rewrites, redirects
 app/ # Next.js app router pages
 pages/ # Next.js pages router (API routes)
 components/ # React UI (shadcn/ui based)
 emails/ # react-email templates
 lib/ # Shared utilities
 tinybird/ # Analytics datasources and endpoints
 prisma/
 schema/ # Multi-file Prisma schema
 migrations/ # Database migrations
 add-migration.sh # Migration helper script
 ee/ # Enterprise features
 features/ # Datarooms, SAML SSO, advanced analytics
 emails/ # Enterprise email templates
 stripe/ # Billing integration
 limits/ # Plan-based feature gates
 LICENSE.md # Enterprise license
 context/ # React context providers
 styles/ # Global CSS
 public/ # Static assets
 components.json # shadcn/ui config
 trigger.config.ts # Trigger.dev v3 config
 vercel.json # Vercel deployment config

Key environment variables

Variable Purpose
POSTGRES_PRISMA_URL PostgreSQL connection (pooled)
POSTGRES_PRISMA_URL_NON_POOLING PostgreSQL connection (migrations)
NEXTAUTH_SECRET NextAuth session secret
IAM_URL Hanzo IAM URL (https://hanzo.id)
IAM_CLIENT_ID Hanzo IAM OAuth client ID
IAM_CLIENT_SECRET Hanzo IAM OAuth client secret
BLOB_READ_WRITE_TOKEN Vercel Blob token (if using Vercel storage)
NEXT_PRIVATE_UPLOAD_BUCKET S3 bucket name (if using S3)
RESEND_API_KEY Resend email API key
TINYBIRD_TOKEN Tinybird analytics token
STRIPE_* Stripe keys (enterprise billing)
TRIGGER_SECRET_KEY Trigger.dev API key
NEXT_PRIVATE_DOCUMENT_PASSWORD_KEY Encryption key for document passwords

Database

Prisma multi-schema setup in prisma/schema/. Run migrations:

npm run dev:prisma # Generate client + deploy migrations
npx prisma migrate dev # Create new migration
bash prisma/add-migration.sh # Helper for adding migrations

Tinybird analytics

cd lib/tinybird
tb push datasources/*
tb push endpoints/get_*

Docker

docker build -t hanzo-dataroom .
docker run -p 3000:3000 --env-file .env hanzo-dataroom
  • hanzo/hanzo-iam.md -- OAuth provider (Hanzo IAM at hanzo.id)
  • hanzo/hanzo-platform.md -- PaaS deployment
  • hanzo/hanzo-sql.md -- PostgreSQL database

Last Updated: 2026-03-13 Category: Hanzo Ecosystem Related: dataroom, documents, analytics, docsend, papermark, sharing Prerequisites: Node.js 22+, PostgreSQL, S3 or Vercel Blob, Resend API key