PDF Splitter

A fast, beautiful cross-platform desktop app that splits any multi-page PDF into individual page files — built with Tauri 2 and Leptos (Rust → WASM).

---

Overview

PDF Splitter is a cross-platform (macOS and Windows) desktop application that takes any multi-page PDF document and extracts every page into its own individual PDF file.

The app is built on a native Tauri 2 shell with a Leptos 0.7 UI compiled to WebAssembly via Trunk, providing:

• Native performance — a lean Rust binary with zero Electron overhead.
• Parallel page processing — automatically scales to all available CPU cores for fast extraction.
• Beautiful, native-feel UI — glassmorphism design, dark-mode support, and smooth animations.
• Drag & drop — drop a PDF straight onto the window to quickly begin splitting.
• 100% Fidelity — guarantees perfect quality for fonts, images, and embedded resources.

The frontend was migrated from Vue 3 + TypeScript + Vite to Leptos + Trunk. See MIGRATION.md for the full rationale, procedure, and the runtime gotchas encountered (Tauri global API loading, reactive-signal disposal, CSP for WASM).

---

Getting Started

Prerequisites

• Rust + Cargo (≥ 1.80) with the wasm32-unknown-unknown target:

  rustup target add wasm32-unknown-unknown

• Trunk (the WASM web bundler):

  cargo install trunk

• macOS: Xcode Command Line Tools (xcode-select --install)
• Windows: Build Tools for Visual Studio (C++ build tools)
• (Optional, only to run the frontend unit tests) — Node.js and wasm-bindgen-cli:

  cargo install wasm-bindgen-cli --version 0.2.126

Development

# 1. Clone the repository
git clone https://github.com/suradet-ps/pdf-splitter.git
cd pdf-splitter

# 2. Start the app (hot-reload for both the Rust backend and the Leptos UI)
cargo tauri dev

cargo tauri dev runs trunk serve for the UI (hot-reload at http://127.0.0.1:1420) and launches the Tauri window.

To iterate on the frontend only (no Tauri window), run the Trunk dev server directly:

cd src
trunk serve        # serves the Leptos app at http://127.0.0.1:1420

Production Build

# Build the optimized binary + platform installer (macOS .app/.dmg, Windows .msi/.exe)
cargo tauri build

The output artifacts are generated in src-tauri/target/release/bundle/.

Note: an automated GitHub Actions workflow (build-windows.yml) builds and releases the Windows installer whenever a new v* tag is pushed. Its toolchain (Bun-based tauri CLI invocation) should be updated to the Cargo-based cargo tauri build described above.

---

Tech Stack

• Backend: Rust, Tauri 2, lopdf (PDF processing), rayon (parallel processing).
• Frontend: Leptos 0.7 (client-side rendered), compiled to wasm32-unknown-unknown via Trunk. No JavaScript/TypeScript/bundler.

Repository layout

crates/pdf-split-core/   # pure-Rust PDF engine (no Tauri dependency)
src-tauri/               # Tauri app shell + Rust commands (thin IPC layer)
src/                     # Leptos frontend crate (excluded from the Cargo workspace;
                         #   built & tested separately with trunk / wasm-bindgen-test)

The frontend crate is intentionally excluded from the Cargo workspace because its web-sys / leptos dependencies only build for wasm32, which would break cargo clippy --workspace / cargo test --workspace on the host. Validate it separately:

cd src
cargo fmt --check
cargo clippy --target wasm32-unknown-unknown --all-targets   # -D warnings
cargo test  --target wasm32-unknown-unknown                  # wasm-bindgen-test-runner + Node
trunk build                                                # emits ../dist

---

License

This project is open source and available under the MIT License.