Skip to content

olagokemills/document-toolbox

Repository files navigation

PrivatePDF

PDF tools that run entirely on your device. No uploads, no accounts, no internet required.

Download the desktop app · All releases


What it does

20+ PDF tools that work 100% locally:

Category Tools
Organise Merge, Split, Rotate, Delete pages, Extract pages, Reorder pages
Enhance Watermark, Remove metadata, Lock, Unlock
Convert to PDF Word → PDF, Excel → PDF, PowerPoint → PDF, HTML → PDF, Images → PDF
Convert from PDF PDF → Word, PDF → Excel, PDF → PDF/A, PDF → Images, PDF → PowerPoint

Run locally (web app)

No installation needed — runs in your browser via Next.js.

Prerequisites: Node 20+, pnpm 9+

git clone https://github.com/olagokemills/document-toolbox.git
cd document-toolbox
pnpm install
pnpm dev:web

Open http://localhost:3000.


Run the desktop app in dev mode

pnpm dev:desktop

Opens an Electron window with hot reload.


Build the desktop installer

# macOS — produces apps/desktop/dist/PrivatePDF.dmg
pnpm package:desktop

Note: macOS and Windows installers must be built on their respective platforms. The CI release workflow handles cross-platform builds automatically on tag push.


Release a new version

git tag v1.0.0
git push origin v1.0.0

GitHub Actions builds the .dmg (macOS) and .exe (Windows) and attaches them to the release automatically.


Project structure

apps/
  local-web/        Next.js web app
  desktop/          Electron desktop app
packages/
  pdf-core/         All PDF processing logic (shared)
  shared-types/     TypeScript types and constants
website/            Static download landing page (GitHub Pages)

Development commands

Command Description
pnpm dev:web Start the web app (port 3000)
pnpm dev:desktop Start the desktop app
pnpm test Run all tests
pnpm lint ESLint across all packages
pnpm typecheck TypeScript check across all packages
pnpm build:web Production build of the web app
pnpm build:desktop Production build of the desktop app
pnpm package:desktop Build + package desktop installer

Contributing

See CONTRIBUTING.md for dev setup, branch model, and PR guidelines.

License

MIT Made with love for all

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors