KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

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

DoxDock

★ 25 Open GitHub ↗

Free, open-source PDF & image tools that run 100% in your browser — merge, split, compress, convert, edit & sign. No uploads, no sign-up, fully private and offline.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DoxDock

[![License: MIT](https://img.shields.io/badge/License-MIT-10b981?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](https://raw.githubusercontent.com/mithun-srinivas/DoxDock/main/LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/mithun-srinivas/DoxDock?style=for-the-badge&logo=github&logoColor=white&color=f59e0b)](https://github.com/mithun-srinivas/DoxDock/stargazers)
[![Created by Mithun S](https://img.shields.io/badge/Created%20by-Mithun%20S-4f46e5?style=for-the-badge&logo=github&logoColor=white)](https://github.com/mithun-srinivas)
[![Supported by OSCode Community](https://img.shields.io/badge/Supported%20by-OSCode%20Community-00C9FF?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAE5klEQVRIDbVWXWwUVRQ%2B996Z7dp2qQWxUQilFgr1QQuxohKIBNw21ZholUoMmqjwogaJJvXFSK0xEH8SHpTgQ9NgfKk%2BWEnQNMqTmvrzoIkhyBpiiJggEdMW2u7uzD1%2BZ2Z3dmZpscb07Ozs%2FTn3%2B84959xzV9G3TIspejHBBXuhBIpIEav%2FvtuFEpBAK6UJjw46C9y68%2B96sAGQhpRPVCiChlMOGSJ0bfBcE2JuAjgEOPJJk%2FnzL%2Frpazs%2Bxr%2F%2BaGfzmNHpGrOmg%2B7u4Y5OvmE55dmy0kwWplzlQzVPFrHrKFWY5dEPaeSwOfuzRwyLISFCjfiLqLW9uPMF9cAu%2F7oMgRpRCnTir6sJoMMmpSl3Wr%2B1n7%2F7HG5goIn%2FyWOZxXotXQ4%2BxJuy6sX3qK3Vl%2B1VSzWBZqsdbXPjpv9J%2F9yZEE9SCF84QZnyThJAzuq1dHCE2jo8xCgp1VnERtPU32bgee%2FcGaK0WAvkAF33PKE3bU0uL%2FX4t5x67Vl%2FYkKCn5QkgSIxcfiQf%2FqHwPY8POOQg%2FRPd2Zp4F114y3gkkRNimTTqW946HUynlLoVSSpil7ulB45AiKohD72yTe1S2b3D%2BpMPW%2FYWgN08VdCYA1SwHx81Mn9QjqBWenIKXVInRjmmcloNRIVW6KunbSu05%2B0avtD3j3d5TBU1ob6PDPlHD8GkLiUlGASnK%2BuTPJXn3liTuh8cb9seEuvxTljbWszanCI9r3prmoT4qTLoZkfHzOXp%2BHnSEoE0LUp4vM5e%2FF8NBc0mNP1%2FsrVpUGPiw1N9PRL3jsfOa3rlBzlisBK9%2BIffOFsnLeyTbTU1ATNXKmskKNDJl3n1uBgiTCC7pOdJlp7m%2FfMYNXBgpVqZspOXJKsK0uFIBjBTGxShhQXC75fSW%2FxHYBBs%2FpW65aIg7XywkGUkhWTGAHmtMYTm4Wbmacn%2BMLvIa%2BQRzbMTlKMuLQKCI6O2xiDA9jSJl3XiCEpC6GgJDDrk6PA1Yqlqlp2LRmcju9PKlsdA6q7nhqb4qGJkNh6pFasUS2tGAJmmSHIp0%2BOmhMfOMVJq4GorJ5xvhi1x94Wd8UEhtvm9XRzCyERyxIBKbbE2rH39cmUFLVAGC32inn9ylPel8epxqCA89inxf4%2BvnwpPI%2FQCyqhHD93x4O4LQAVSUQgBUc4tj3MK7CJMkFwo4hP65ea9o0M0zxft280mUaMIWp4gwZeRz2xK5vz23upGA6XKCoEMuCTarqJ9r4q68qCNth4R6%2Ffsl4VLfnaNrfabF9gQmgqLhxrELe9A4zl82ZRgKhwPd2%2F2%2FY8lpKN4zGIrjYOb%2BkiXBIIABLX1bw56zgupiGoAA5Tsftx1bObC9omK1VyB%2BIQsUz1v2%2B7d7k4V7Jdq1e10YZ7bQEzgd1o3L6ZW9qNBEi%2BtO0R%2FfIRxDCcL29efqsJBAP3Vl3GHhjy9x3k2lrUFe7u85c0kA8s0ZdQZRqcbB86OOf03KHiG8NebV0yaQUdYmjPgaARvcQvkqfKpTvuSt3ZbXWBu%2FbwsuXBvSNqYWSpfplvre4%2FbLOPkkrFcz%2FCCpTn%2BuuoQABzkRgp%2FF0hVUguR1jIYsK6ypcya%2BPnJo6OdrJ4lyfhfD%2BMVVCEAseX5%2FCLy5mCIydRQW8OP0fa15qLlOZrVBPPpfe%2FCOYCrB5bdIJ%2FANB%2B4OK%2FhNbJAAAAAElFTkSuQmCC&logoColor=white)](https://github.com/OSCode-Community)

**Offline-first document & image tools that run 100% in your browser. Nothing you open ever leaves your machine.**

DoxDock is a collection of ~20 everyday PDF and image utilities — merge, split, compress, convert, watermark, extract text, and more — built on one hard rule: **your files never get uploaded anywhere.** Every operation runs client-side, on your device, using your browser's own CPU. No servers, no accounts, no analytics, no network.

It exists for the moment you have a sensitive PDF — a contract, a payslip, a medical scan — and just need to _do one thing_ to it without handing it to a random online converter. Read the [ideology letter](https://doxdock.vercel.app/ideology.html) for the why.

> **Runs entirely in your browser — no uploads, no network.**

---

## Why it's "provably local" — and how to verify

Most "free online PDF tools" upload your file to a server you know nothing about. DoxDock is the opposite, and it's built so you don't have to take our word for it:

1. **A strict Content-Security-Policy forbids network access.** `index.html` ships a CSP with `connect-src 'self'` — the browser will _refuse_ any outbound `fetch`/`XHR`/`WebSocket` to any host but its own origin. If a future change tried to phone home, the browser would block it.
2. **Everything is bundled locally.** Fonts (system stack), icons (inline SVG), the pdf.js worker, and all WebAssembly are served from the app itself. There are no CDN links, no external fonts, no trackers.
3. **It's an installable PWA that works offline.** After the first load, a service worker caches everything. Pull your network cable / turn off Wi-Fi — every tool still works.

### Verify it yourself (30 seconds)

- Open DevTools → **Network** tab, then use any tool. You'll see requests only to your own origin (in dev, `localhost`) — never an external domain.
- Or: load the app once, go **fully offline** (airplane mode / disconnect), and reload. Everything keeps working.
- Or: read the source. It's MIT-licensed and small. `connect-src 'self'` is in [`index.html`](index.html); the pdf.js worker is bundled in [`src/lib/pdfjs.js`](src/lib/pdfjs.js).

We persist only **non-sensitive UI state** (your theme and last-used tool) in `localStorage`. File contents are never written to storage and never transmitted.

---

## Run with Docker

The quickest way to self-host. DoxDock ships as a static site, so the container just serves the built files with nginx — it makes **no outbound calls** and can run completely offline / air-gapped.

**With Docker:**

```bash
# build the image (--load puts it in your local image store; needed when the
# active buildx builder uses the docker-container driver)
docker build --load -t doxdock .

# run it (serves on http://localhost:8791)
docker run --rm -p 8791:80 doxdock
```

**With Docker Compose:**

```bash
docker compose up --build
# then open http://localhost:8791
```

The image is a multi-stage build (Node builds the site, nginx serves it), so the final image is tiny and contains only static assets — no Node runtime, no source. The app is published on host port **8791** (chosen to avoid clashing with common dev servers); to use a different port, change the left-hand number, e.g. `-p 3000:80` (or edit `docker-compose.yml`).

> Self-hosting keeps the "provably local" guarantee intact: the container serves files and nothing else. You can disconnect it from the internet entirely and every tool still works.

---

## Quick start

```bash
# install
npm install

# dev server (http://localhost:5173)
npm run dev

# production build -> dist/
npm run build

# preview the production build
npm run preview
```

Requirements: Node 18+. No backend, no environment variables, no services to run — it's a static site.

### Verify the offline build

```bash
npm run build
npm run preview
# open the URL, then disconnect your network and use the app.
# In DevTools → Network, confirm zero requests leave your origin.
```

---

## Supported operations

Operations whose client-side result has inherent limits are labelled honestly in the UI **and** here.

### PDF

| Tool | What it does | Caveats |
|---|---|---|
| Images → PDF | Combine images into one PDF, ordered, with page-size/orientation options | — |
| PDF → Images | Export each page as PNG or JPEG (ZIP download) | — |
| Merge PDFs | Combine multiple PDFs, drag to reorder | Encrypted PDFs unsupported |
| Split PDF | Extract page ranges or explode into single pages | Encrypted PDFs unsupported |
| Rotate PDF | Rotate all or selected pages by 90/180/270° | — |
| Organize PDF | Reorder / delete pages via thumbnails | — |
| Edit PDF | Overlay text, drawings, highlights, shapes, images, and white-out; flatten on export | Adds content on top; does not re-flow existing text |
| Compress PDF | Re-encode page images + strip metadata; before/after size | **Results vary.** "Re-encode pages" rasterizes (text becomes non-selectable); text-only PDFs barely compress — use "strip metadata" for those. |
| Watermark PDF | Text stamp, centered or tiled, with opacity/angle | — |
| Add Page Numbers | Stamp page numbers with position/format options | — |
| Extract Text | Output plain text or Markdown | Text-based PDFs only; **no OCR** for scans |
| PDF → Word | Extract text into an editable `.docx` | **Text only** — complex layout, tables, and images are not preserved; no OCR |
| Word → PDF | Convert `.docx` to PDF | **Approximate layout** — headings/lists/bold kept; exact fonts, images, columns, tables not reproduced |
| Fill PDF Form | Fill AcroForm fields and optionally flatten | Only PDFs with real form fields |

### Image

| Tool | What it does | Caveats |
|---|---|---|
| Compress Image | Quality slider, before/after size | PNG is lossless — convert to JPEG/WebP for big savings |
| Resize Image | By dimensions or percentage, keep aspect ratio | — |
| Convert Image Format | PNG ↔ JPEG ↔ WebP | — |
| Crop Image | Interactive drag-to-crop | — |
| Strip Image Metadata | Remove EXIF/GPS by re-encoding | — |
| Rotate / Flip Image | 90° steps + horizontal/vertical flip | — |

### Convert

| Tool | What it does | Caveats |
|---|---|---|
| Markdown → PDF | Render Markdown text or `.md` file to PDF | Common Markdown subset |
| HTML → PDF | Render HTML markup or `.html` file to PDF | **Approximate layout** — CSS/images not reproduced |

---

## Tech stack

- **React + plain JavaScript (JSX)** + **Vite**
- **Tailwind CSS** (the "Aurora" theme — deep slate with a mint→sky glow, light + dark)
- **vite-plugin-pwa** for the offline/installable service worker
- Client-side libraries, all bundled locally (no CDN): `pdf-lib`, `pdfjs-dist` (worker bundled), `jspdf`, `docx`, `mammoth`, `browser-image-compression`, `fflate` (zip). Plus the browser **Canvas** and **Web Crypto** APIs.

No dependency makes network calls at runtime. Heavy work (pdf.js rendering, image compression) runs in web workers to keep the UI responsive.

## Architecture

DoxDock uses a **plugin/registry** architecture. Each operation is a self-contained folder under `src/operations/<id>/` with metadata, a component, and pure helpers. A central registry auto-discovers them via `import.meta.glob` and lists them in a searchable, categorized sidebar with a Cmd/Ctrl+K command palette. Adding a tool = drop in one folder. See [CONTRIBUTING.md](CONTRIBUTING.md).

## Contributing

PRs welcome — especially new operations. See [CONTRIBUTING.md](CONTRIBUTING.md) for a step-by-step guide. The one rule that can never break: **no runtime network requests.**

## Supported by

Proudly supported by the **[OSCode Community](https://github.com/OSCode-Community)** — an open-source developer community. If DoxDock is useful to you, a ⭐ on the repo helps others find it.

## License

DoxDock

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README