Skip to content

Repository files navigation

ViewDocx

BuildLatest releaseLicense: MITPlatform

A small Windows desktop app for opening and viewing Microsoft Word .docx files — without installing Microsoft Office.

Built with Tauri 2 and docx-preview (Apache-2.0).

Website:maks417.github.io/ViewDocx

Download

Releases — pick the latest version and download one of:

FileWho it's for
*-setup.exeMost people — run the installer and follow the prompts
*.msiIT departments — silent or managed deployment

The installer is about 5–10 MB. On first install it may download the WebView2 runtime if your PC does not already have it (internet required once).

Windows SmartScreen: the app is not code-signed yet. Windows may show “Unknown publisher” on first run. Choose More info → Run anyway to continue.

Features

  • Open .docx from the toolbar, drag-and-drop, double-click (file association), or the Recent list (up to 10 files)
  • Layout rendering for tables, images, page breaks, headers, and footers
  • Zoom (including fit width), print, and Save as PDF (vector export with selectable text — no print dialog)
  • Status bar with file path and document stats
  • Small footprint — uses the system WebView instead of bundling a full browser

Using ViewDocx

  1. Install from a release (see above), or build from source (contributors).
  2. Open a document:
    • Open on the toolbar, or Ctrl+O
    • Drag a .docx onto the window
    • Double-click a .docx in File Explorer (after install)
    • Pick a file from Recent (clock icon)
  3. Use the toolbar for zoom, print, and PDF export.

Keyboard shortcuts

ActionShortcut
OpenCtrl+O
Save as PDFCtrl+Shift+S
PrintCtrl+P
Zoom inCtrl++
Zoom outCtrl+-
Actual size (100%)Ctrl+0

Requirements and limitations

OSWindows 10 or later (64-bit). macOS and Linux builds are not shipped yet.
RuntimeWebView2 — included on Windows 11; installed by the setup program on older systems when needed.
Formats.docx only. Legacy .doc files are detected and reported as unsupported.
Save as PDFWindows only (uses WebView2 PrintToPdf).
EditingView-only — this is a reader, not a Word replacement.

For contributors

TauriRustTypeScriptViteWebView2

Prerequisites

  • Node.js 18+ (22 used in CI)
  • Rust (stable)
  • Windows with WebView2 for local runs (same as end users)

On Windows, install Visual Studio Build Tools with the Desktop development with C++ workload if tauri build fails to find a linker.

Development

git clone https://github.com/Maks417/ViewDocx.git
cd ViewDocx
npm install
npm run tauri dev

Frontend-only work (no Rust changes):

npm run dev # Vite on http://localhost:1420

Repository layout

PathPurpose
src/TypeScript UI (toolbar, viewer, drag-and-drop)
src-tauri/Rust backend, Tauri config, bundling
.github/workflows/CI build on push/PR; release on version tags

Build installers locally

Artifacts are written to src-tauri/target/release/bundle/.

npm run build:installer
OutputUse
nsis/*-setup.exeEnd-user installer (downloads WebView2 bootstrapper when needed)
msi/*.msiMSI for IT / silent install

Microsoft Store: not configured yet (requires a code-signing certificate). src-tauri/tauri.microsoftstore.conf.json and npm run build:store are kept for a possible future submission — see Tauri — Microsoft Store.

Releases and CI

  • build.yml — builds on every push and pull request to main / master; uploads Windows installers as workflow artifacts.
  • release.yml — runs when a version tag is pushed; builds Windows installers and publishes a GitHub Release with assets attached.

Cutting a release (maintainers):

npm run release:bump -- 1.0.4 # syncs package.json, tauri.conf.json, Cargo.toml
git add -A
git commit -m "Release v1.0.4"
git tag v1.0.4
git push
git push origin v1.0.4

Accepted tag forms: v1.0.4 or 1.0.4 (see the workflow on.push.tags list).

To also ship macOS or Linux installers, uncomment the extra matrix rows in release.yml (and the matching jobs in build.yml).

Release notes and assets are defined in the workflow (releaseBody, releaseDraft: false). Edit .github/workflows/release.yml to change the default release text or switch to draft releases.

License

Application code is under the MIT License. Third-party dependencies use permissive licenses (MIT / Apache-2.0).

About

Lightweight app to view docx files

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages