@vivliostyle/viewer

Vivliostyle Viewer

Vivliostyle Viewer is a Web application for HTML+CSS typesetting and rich paged viewing with EPUB/Web publications support.

• Online Vivliostyle Viewer: https://vivliostyle.org/viewer/
• Download Vivliostyle Viewer: https://vivliostyle.github.io
• View samples online: https://vivliostyle.org/samples/

How to use

To use the distribution package vivliostyle-viewer-*.zip

• Unzip the downloaded ZIP file.
• Open a terminal (or Windows command prompt)
• Run the start-webserver or start-viewer script (or Windows batch) file located in the unzipped directory. For example:

$ ./vivliostyle-viewer-latest/start-webserver

or in Windows command prompt,

> vivliostyle-viewer-latest\start-webserver

If a message,

Please install Node.js or Ruby or Python and rerun this script, or use your favorite HTTP server.

is shown, install either of them (recommend Node.js and rerun the script, or use your favorite web server.

The start-webserver script starts a local web server and opens the default browser. The current directory is used as the root of the web server. Run start-webserver --help to see the usage help.

The start-viewer script starts a local web server (calls start-webserver) and opens Vivliostyle Viewer (located in ./viewer/) in browser. Run start-viewer --help to see the usage help.

To use the npm package @vivliostyle/viewer

npm install @vivliostyle/viewer

Vivliostyle Viewer is located in ./node_modules/@vivliostyle/viewer/lib/, so you need to start a web server and open this location in the browser to start the Vivliostyle Viewer.

Documentation

See online Vivliostyle Documents for the latest documents, or open ./docs/ in the distribution package using local web server.

Bug reports & feature requests

Please send them to

• GitHub Issues: https://github.com/vivliostyle/vivliostyle.js/issues

Source code

• Vivliostyle.js on GitHub: https://github.com/vivliostyle/vivliostyle.js

License

Licensed under AGPL Version 3.

Changelog

2.35.0 (2025-09-18)

Bug Fixes

• Fix accessibility problem in output PDF (failed to read aloud) (b5a04a7), closes #1555
• Fix margin-block-start ignored on block with forced page break after clearing a page float (656891a), closes #1557
• Top page float should not absorb margin/border/padding of the block below (Regression in v2.33.0) (ba6f670), closes #1071 #1075 #1519

Features

• Support clear:left/right/inline-start/inline-end/both for page floats (6b69026), closes #1550 #1549
• Support clear:page/column/region for clearing page floats (9fa3341), closes #1551