---
title: "Getting Started — Vue"
description: "Drop the EmbedPDF viewer into any page in minutes."
integration: "Vue"
source: "https://www.embedpdf.com/docs/viewer/vue/getting-started"
---

# Getting Started

The ready-made viewer gives you a complete PDF experience with a small
integration surface. Pick your stack in the sidebar; this page and every
example will stay on that integration.

## Installation

Vanilla JavaScript can load the viewer directly from a CDN. Framework projects
install their dedicated adapter with pnpm.

**`install.sh`**

```shellscript
pnpm add @embedpdf/vue-pdf-viewer
```

## Add your first viewer

Give the viewer a PDF URL and a height. The adapter handles the engine,
plugins, toolbar, and document lifecycle for you.

**`basic.vue`**

```vue
<template>
  <PDFViewer
    :config="{ src: 'https://snippet.embedpdf.com/ebook.pdf' }"
    :style="{ height: '500px' }"
    @ready="onReady"
  />
</template>

<script setup lang="ts">
import { PDFViewer } from '@embedpdf/vue-pdf-viewer';

function onReady(registry: unknown) {
  console.log('PDF viewer ready!', registry);
}
</script>
```

## Where to go next

- Configure the toolbar and available viewer controls.
- Listen to the ready event when you need access to the plugin registry.
- Switch to the Headless docs when you want to build the entire interface yourself.