pdf

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 3 Open GitHub ↗

Casual PDF — production-grade, high-fidelity PDF viewer + editor. Web, desktop (Tauri) & embeddable SDK. View/Edit/Suggest modes, real-time co-editing, e-signing, public links. One PDFium engine everywhere (WASM + native Rust). Apache-2.0.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Casual PDF

[![CI](https://github.com/CasualOffice/pdf/actions/workflows/ci.yml/badge.svg)](https://github.com/CasualOffice/pdf/actions/workflows/ci.yml)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://raw.githubusercontent.com/CasualOffice/pdf/main/LICENSE)
[![Status: planning](https://img.shields.io/badge/status-planning-orange.svg)](https://raw.githubusercontent.com/CasualOffice/pdf/main/docs/ROADMAP.md)

Production-grade, high-fidelity **PDF viewer + editor** for the Casual Office suite — web, desktop, and embeddable. Co-editing, e-signing, public share links, granular reading/editing rights, and a clean, polished UX.

**One core, three surfaces, three modes, collab optional:** desktop · web · SDK, each running **View** / **Edit** / **Suggest** (proposals an owner accepts/rejects, Google-Docs-style), **with** a collab server (co-editing) or **without** (solo single-user). Same codebase — see [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) §2b.

This repo currently holds **design & planning docs only**. No code yet — by design. The plan deliberately maximizes reuse of existing internal infrastructure (`collab`, `desktop`, `design-system`) and permissively-licensed (MIT / Apache-2.0 / BSD) open source, rather than building from the ground up.

## The one decision that shapes everything

**PDFium is the single rendering/editing engine across all three runtimes.**

| Runtime | How PDFium is used | License |
|---|---|---|
| Browser (web app) | `@embedpdf/pdfium` — PDFium compiled to **WASM**, driven by **EmbedPDF** (headless, MIT) | MIT (EmbedPDF) + Apache-2.0 (PDFium) |
| Desktop (Tauri/Rust) | `pdfium-render` — the **same** PDFium, called **natively** from Rust | Apache-2.0/MIT (binding) + Apache-2.0 (PDFium) |
| Heavy worker | A shared **Rust crate** that compiles to **WASM** (browser worker) *and* native (desktop), both binding PDFium | MIT (our crate) |

One engine → identical rendering fidelity everywhere, one set of bugs, one mental model. We never reconcile "the web renderer vs the desktop renderer."

## What we reuse (do not rebuild)

- **Co-editing & presence** → `services/collab` (Yjs + Hocuspocus + WebSocket). Document-agnostic; takes PDF as opaque bytes today. Reused essentially as-is.
- **Public links, share tokens, rooms, personal-mode auth** → already in `services/collab` (`resolveJoinRole`, share-link APIs, SQLite sessions).
- **Desktop shell** → `services/desktop` (Tauri 2, per-document webview, chunked atomic save, crash recovery, native print-to-PDF). Adding `casual_pdf` is a known, documented convention (extend `DocKind`, mount `/pdf/index.html`).
- **UI** → `@schnsrw/design-system` (React components + tokens) for toolbar/dialogs/menus.
- **App skeleton & SDK pattern** → mirror `services/document` and `services/sheet` (React 18 + Vite + TS, publishable SDK package `@casualoffice/pdf`).

## Docs

- [`docs/OVERVIEW.md`](docs/OVERVIEW.md) — repo map: structure, decisions, CI & deployment.
- [`docs/RESEARCH.md`](docs/RESEARCH.md) — competitive landscape + OSS building-block survey with a license table.
- [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — system design: PDFium-everywhere, the document model, collab layer, desktop integration, Rust/WASM worker, repo layout.
- [`docs/FEATURES.md`](docs/FEATURES.md) — every must-have feature mapped to its building block (co-editing, signing, public links, rights, redaction, …).
- [`docs/ROADMAP.md`](docs/ROADMAP.md) — phased build plan from viewer → editor → signing → desktop.

## CI & deployment

- **CI** (`.github/workflows/ci.yml`): markdown lint + link check, plus the web (lint/typecheck/build/test) and Rust (`fmt`/`clippy`/`test`/wasm) pipelines — all active as of the Phase 0 scaffold. The web checkout fetches submodules so `vendor/design-system` is present for install.
- **Deploy** (`.github/workflows/deploy-pages.yml`): **live on push to `main`** → [pdf.casualoffice.org](https://pdf.casualoffice.org). Pages Source = GitHub Actions, repo variable `PAGES_CUSTOM_DOMAIN=pdf.casualoffice.org` (writes `CNAME`), DNS pointed, Enforce HTTPS. See [`docs/OVERVIEW.md`](docs/OVERVIEW.md#ci--deployment).

## License

[Apache-2.0](LICENSE). Bundled dependencies are MIT/Apache/BSD only — no (A)GPL (see [`docs/RESEARCH.md`](docs/RESEARCH.md) §6).

## Status

Planning. See `docs/ROADMAP.md` Phase 0 for the first concrete steps.

pdf

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README