Getting Started

Introduction

Welcome to Nuxt PDF Kit - A full-featured PDF viewer module for Nuxt.

Welcome to Nuxt PDF Kit, a complete PDF viewer module for Nuxt, built with Nuxt UI and Tailwind CSS v4.

What is Nuxt PDF Kit?

Nuxt PDF Kit is a comprehensive solution for displaying, navigating, and interacting with PDF documents in your Nuxt applications. Powered by PDF.js, it offers a beautiful and responsive interface right out of the box.

PDF Rendering

High-quality PDF rendering powered by Mozilla's PDF.js library.

Full-Text Search

Easily search through your PDF documents with highlighting and navigation.

Nuxt UI

A beautiful interface built with Nuxt UI.

Dark Mode

Built-in light/dark theme toggle with session persistence.

Why Choose Nuxt PDF Kit?

Building a PDF viewer in Nuxt requires addressing the following challenges:

  • PDF.js complexity - Understanding and configuring the PDF.js library
  • SSR issues - Handling client-only components and hydration
  • UI development - Creating a responsive, accessible interface from scratch
  • Feature implementation - Adding features like search, zoom, print, download, and more

Nuxt PDF Kit solves all these challenges by providing:

Nuxt UI
feature
A beautiful, responsive interface with dark/light mode support right out of the box.
SSR Compatible
feature
Works seamlessly with Nuxt's server-side rendering, no configuration needed.
Zero Configuration
feature
Automatically installs dependencies (@nuxt/ui, @vueuse/nuxt) - simply add and use.
Responsive
feature
Mobile-friendly, with an adaptive toolbar that works across all devices.
Feature Complete
feature
Full features, including search, zoom, rotation, print, download, thumbnails, keyboard shortcuts, and more.

Key Features

Nuxt PDF Kit includes everything you need for a complete PDF viewing experience:

FeatureDescription
PDF RenderingHigh-quality rendering with PDF.js
Text SearchFull-text search with highlighting and navigation
Zoom ControlsZoom in/out, fit page, fit width, custom percentage
RotationRotate documents clockwise
View ModesSingle page, dual page, dual with cover
Scroll ModesVertical, horizontal, wrapped, page-by-page
ThumbnailsSidebar with page thumbnails
Keyboard ShortcutsNavigate with arrow keys, zoom with +/-
Dark ModeBuilt-in theme toggle with session persistence
Print & DownloadNative print and download support
Virtual ScrollingEfficient rendering for large documents
Responsive ModeAuto-fit pages to the container width

Requirements

Before getting started, ensure your project meets the following requirements:

  • Nuxt >= 3.0.0
  • Node.js >= 18
Nuxt PDF Kit automatically installs required dependencies, such as @nuxt/ui and @vueuse/nuxt, if they are not already present in your project.

Quick Example

Here’s a simple example to help you get started:

<template>
 <NuxtPdfKit src="/sample.pdf" />
</template>

That's it! You now have a fully-featured PDF viewer in your Nuxt application.

Ready to get started? Head over to the Installation guide.

Copyright © 2026