Note
This project is still a work in progress! Many planned features are still being built. As a solo developer, I welcome any feedback or volunteer contributions!
Current Status: The project now supports 20 formats across document, ebook, comic, plain text, and archival formats. Individual enhancement of each format is an ongoing effort, along with further improvement of the reading experience and additional features.
WebXReader is a local-first reading application designed to help you organize, manage, and read your digital library directly in your browser.
WebXReader is hosted on multiple platforms and has several mirrors. Here are ways you can use it:
Choose from any of the following sites! New updates get deployed on all 4 mirrors simultaneously.
| Platforms hosted | Site Link |
|---|---|
| Cloudflare | webxreader.pages.dev |
| Netlify | webxreader.netlify.app |
| Firebase | webxreader.web.app |
| Vercel | webxreader.vercel.app |
The primary Netlify deployment is supported by Netlify's Open Source Program.
Important
Your library data is not shared between these mirrors. Each site stores books, bookmarks, reading progress, and preferences separately in your browser. (You can use multiple or all sites simultaneously if you want to have multiple separate libraries.)
Prefer to host it yourself? You can run WebXReader directly on your computer using the steps below.
Note: Self-hosting is not recommended for most users since you won't receive automatic updates, and all official web mirrors already work offline. Your locally hosted setup's data is also stored separately if you decide to use both a local setup and hosted sites simultaneously.
Click here to show local setup details
Prerequisites
Setup Steps
-
Clone the repository:
git clone [https://github.com/xensenx/WebXReader](https://github.com/xensenx/WebXReader) cd WebXReader -
Install dependencies:
npm install
-
Run locally (Development Mode):
npm run dev
Open the local URL shown in your terminal (usually
http://localhost:5173).
Optional: Production Build
If you want to build and serve the optimized production version (including full offline/PWA support):
npm run build
npm run previewWebXReader is built around a simple idea: your digital library should be private, fast, and accessible anywhere without needing an account or an internet connection.
- 100% Local & Private: Your books, reading progress, and bookmarks stay directly in your browser. Nothing is ever uploaded to a server, and there are no accounts or tracking.
- Works Completely Offline: Once you open any mirror, you can read your entire library without an internet connection—and even install it on your device like a native app.
- 20 Formats Out of the Box: Drop in ebooks, documents, comics, plain text, or archives directly without converting them first.
- Tailored Reading Experiences: Dedicated reader views and layouts designed around the type of content you're opening, with ongoing refinements to make every format feel smooth.
- Distraction-Free Interface: Clean, dark-mode-first design built to keep the focus on your reading rather than clutter.
Supported File Formats (20 total)
| Category | Formats |
|---|---|
| Ebooks | EPUB, MOBI, AZW3, FB2 |
| Documents | PDF, DOCX, DOC, RTF, DJVU |
| Comics | CBZ, CBR, CB7 |
| Plain Text & Web | TXT, MD, HTML, MHT |
| Archives & Images | ZIP, RAR, PNG, JPEG |
