# @prestashopcorp/puik-components

> PUIK Vue 3 components library.

Latest version **2.8.1** (published 2026-04-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install @prestashopcorp/puik-components
pnpm add @prestashopcorp/puik-components
yarn add @prestashopcorp/puik-components
bun add @prestashopcorp/puik-components
```

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.8.1 |
| Published | 2026-04-15 |
| First published | 2023-12-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 10 |
| Unpacked size | 615.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 24 |
| Author | Prestashop |
| Maintainers | rxmat_presta, natsuflame, devops-prestashop |

## Links

- npm: https://www.npmjs.com/package/@prestashopcorp/puik-components
- Repository: https://github.com/PrestaShopCorp/puik
- Homepage: https://github.com/PrestaShopCorp/puik#readme
- Issues: https://github.com/PrestaShopCorp/puik/issues
- npm.io page: https://npm.io/package/@prestashopcorp/puik-components

## Dependencies (10)

- [radix-vue](https://npm.io/package/radix-vue.md) ^1.9.17
- [sortablejs](https://npm.io/package/sortablejs.md) ^1.15.7
- [@vueuse/core](https://npm.io/package/@vueuse/core.md) ^10.11.1
- [@popperjs/core](https://npm.io/package/@popperjs/core.md) ^2.11.8
- [embla-carousel](https://npm.io/package/embla-carousel.md) ^8.6.0
- [@headlessui/vue](https://npm.io/package/@headlessui/vue.md) ^1.7.23
- [sortablejs-vue3](https://npm.io/package/sortablejs-vue3.md) ^1.3.0
- [@vueuse/components](https://npm.io/package/@vueuse/components.md) ^11.3.0
- [embla-carousel-vue](https://npm.io/package/embla-carousel-vue.md) ^8.6.0
- [@prestashopcorp/puik-theme](https://npm.io/package/@prestashopcorp/puik-theme.md) 2.8.1

## Recent versions

- 2.8.1 (latest) — 2026-04-15
- 2.0.0-beta.4 (beta) — 2024-05-21
- 0.0.1 (build-feature-package) — 2023-12-12
- 2.8.0 — 2026-04-09
- 2.7.0 — 2025-10-22
- 2.6.0 — 2025-06-04
- 2.5.1 — 2025-04-24
- 2.5.0 — 2025-04-08
- 2.4.0 — 2025-01-17
- 2.3.0 — 2024-11-19
- 2.2.0 — 2024-09-19
- 2.1.0 — 2024-07-29
- 2.0.1 — 2024-06-10
- 2.0.0 — 2024-05-28
- 2.0.0-beta.3 — 2024-05-20
- … 2 more at https://npm.io/package/@prestashopcorp/puik-components/versions

## README

<div align="center">
  <a href="https://prestashop.com">
    <img src="https://prestashop.com/sites/default/files/email/logo_x2_rebrand.png" alt="Logo" width="420">
  </a>

<h3 align="center">Puik Components</h3>

  <p align="center">
    The <b>P</b>restaShop <b>UI</b> <b>K</b>it Vue Components
  </p>
  <a href="https://uikit.prestashop.com/">Documentation</a>
</div>

## About The Project

Puik Components is a Vue Components library that aims to provide a complete set of reusable components based on the PrestaShop Design System for all the PrestaShop ecosystem.

ℹ️ [see list of available Vue components](https://github.com/PrestaShopCorp/puik/blob/main/RELEASE-NOTES-V2.md#available-components)

## Prerequisites

- Node.js LTS is required.
- Vue 3

## Installation

```sh
# NPM
$ npm install @prestashopcorp/puik-components @prestashopcorp/puik-theme --save

# Yarn
$ yarn add @prestashopcorp/puik-components @prestashopcorp/puik-theme

# pnpm
$ pnpm install @prestashopcorp/puik-components @prestashopcorp/puik-theme
```

### Style

import css in your application:

`@import "@prestashopcorp/puik-theme/index.css";`

### Auto import using Puik Resolver (recommended)

First you need to install `unplugin-vue-components`, `unplugin-auto-import` and the Puik resolver `@prestashopcorp/puik-resolver`

```sh
$ npm install -D unplugin-vue-components unplugin-auto-import @prestashopcorp/puik-resolver

# Yarn
$ yarn add unplugin-vue-components unplugin-auto-import @prestashopcorp/puik-resolver -D

# pnpm
$ pnpm install unplugin-vue-components unplugin-auto-import @prestashopcorp/puik-resolver -D
```

Then add the code below in your vite.config file

ℹ️ if you don't use Vite [follow this link](https://github.com/unplugin/unplugin-vue-components?tab=readme-ov-file#installation)

```typescript
import { defineConfig } from 'vite'
import Components from 'unplugin-vue-components/vite'
import AutoImport from 'unplugin-auto-import/vite'
import { PuikResolver } from '@prestashopcorp/puik-resolver'

export default defineConfig({
  plugins: [
    // ...
    Components({
      resolvers: [PuikResolver()],
    }),
    AutoImport({
      resolvers: [PuikResolver()],
    }),
  ],
})
```

### On demand import

Import the vue component directly into your vue file

```vue
<script setup>
import { PuikButton } from '@prestashopcorp/puik-components'
</script>

<template>
  <puik-button>Example button</puik-button>
</template>
```

---
_Source: https://npm.io/package/@prestashopcorp/puik-components · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
