@samk_dev/nuxt-uikit3

Nuxt Uikit 3

⚠️ the package is still work in progress and will be released soon ⚠️

Nuxt compatibility: ^3.0.0 UIkit 3 version 3.16.16

nuxt-uikit3 Nuxt module.

• ✨  Release Notes
• UIkit 3 Docs
• Nuxt Docs

Features

• Injects UIkit 3 into Nuxt ✅
• Use all UIKit 3 JS components without writing any JS ✅
• Use UIKit 3 icons pack ✅
• UIkit 3 documentation in Nuxt Devtools ✅

On version 1.0.0 release todos:

• scss/less to customize UIkit 3 theme
• Tests jest?? or vitest??
• Docs []
• Examples []
• Contribution guid []
• Licence []

Quick Setup

Add @samk_dev/nuxt-uikit3 dependency to your project

# Using npm
npm install --save-dev @samk_dev/nuxt-uikit3

# Using pnpm
pnpm add -D @samk_dev/nuxt-uikit3

# Using yarn
yarn add --dev @samk_dev/nuxt-uikit3

Add @samk_dev/nuxt-uikit3 to the modules section of nuxt.config.ts

export default defineNuxtConfig({
  modules: ['@samk_dev/nuxt-uikit3']
});

That's it! You can now use Nuxt Uikit 3 in your Nuxt app ✨

Module Options

By default Nuxt UIkit 3 Module loads UIkit 3 core css && core theme css, but you can select what css components to import or disable this behaviour && load your own custom css.

Default UIkit 3 core css && default theme css

export default defineNuxtConfig({
  modules: ['@samk_dev/nuxt-uikit3'],
  uikit3: {
    css: {
      /**
       * @default true
       */
      coreCss: boolean,
      /**
       * @default true
       */
      coreTheme: boolean
    },
    /**
     * @default true
     */
    icons: boolean,
    /**
     * @default true
     */
    js: boolean
  }
});

Enable in Nuxt Devtools

In order to view UIkit 3 in Nuxt Devtools you have to install @nuxt/devtools please see Nuxt Devtools Documentation and follow the Getting started section.

Once you have it installed in nuxt.config.ts and enable devtools. That's it ✨ now you have a tab with UIkit 3 docs

devtools: {
    enabled: true
  },

CSS

You can use any css class from UIkit 3 as you would normally do.

CSS Example

<section class="uk-section uk-section-default">
  <div class="uk-container">
    <h1 class="uk-heading-medium">Are You Nuxt!</h1>
    <button type="button" class="uk-button uk-button-primary">Click me!</button>
  </div>
</section>

Icons

Enable icons: true in nuxt.config.ts

// nuxt.config.ts
uikit3: {
  // ...rest of options
  icons: true;
}

<span data-uk-icon="icon: check; ratio: 2"></span>

Javascript

You can use UIkit 3 JS components by adding the data-uk-<component-name>

To work with javascript components from UIkit 3, you have to add data-uk-<component-name> Please refer to UIkit 3 documentation as they mentioned there

From UIkit 3 Docs

UIkit and reactive JavaScript frameworks. UIkit is listening for DOM manipulations and will automatically initialize, connect and disconnect components as they are inserted or removed from the DOM. That way it can easily be used with JavaScript frameworks like Vue.js and React. You can use UIkit components by adding uk-* or data-uk-* attributes to your HTML elements without writing a single line of JavaScript. This is UIkit's best practice of using its components and should always be considered first.

<!-- ❌ WILL NOT WORK -->
<div uk-sticky="offset: 50;"></div>
<!-- ✅ WILL WORK -->
<div data-uk-sticky="offset: 50;"></div>

Usage Example

Acordion Component

Using the data-uk-<component-name> method:

<template>
  <ul data-uk-accordion>
    <li class="uk-open">
      <a class="uk-accordion-title" href="#">Item 1</a>
      <div class="uk-accordion-content">
        <p>
          Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
          eiusmod tempor incididunt ut labore et dolore magna aliqua.
        </p>
      </div>
    </li>
    <li>
      <a class="uk-accordion-title" href="#">Item 2</a>
      <div class="uk-accordion-content">
        <p>
          Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
          nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor
          reprehenderit.
        </p>
      </div>
    </li>
    <li>
      <a class="uk-accordion-title" href="#">Item 3</a>
      <div class="uk-accordion-content">
        <p>
          Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
          dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat
          proident.
        </p>
      </div>
    </li>
  </ul>
</template>

Development

# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Release new version
npm run release