Qui Max

screenshot of Qui Max
vite
vue
scss

Qui Max

A Vue 3.x Neumorphic design system for Web. Written in TypeScript with Composition API 🔥

Overview

Qui is a Neumorphic design system for building web applications. It is written in TypeScript with Composition API and is specifically designed for Vue 3.x. The library includes over 30 components, all fully written with the Composition API and utilizes TypeScript for type safety. Qui also includes an icon pack, colors & grid support, and neumorphic styles. It provides a Storybook Sandbox for easy exploration and a documentation site for reference. Qui also offers support for different languages through its localization feature.

Features

  • 30+ Vue 3 components: A comprehensive library of components for building web applications with Vue 3.
  • Fully written with Composition API: Makes use of the Composition API, the new recommended way of writing Vue 3 components.
  • Typescript: Provides type safety for a better development experience.
  • Icons Pack: Includes a collection of icons that can be easily used in Vue 3 applications.
  • Colors & Grid: Supports customizable colors and a grid system for designing UI layouts.
  • Neumorphism Styles: Provides neumorphic styles, a popular design trend, for a modern and sleek look.
  • Storybook Sandbox: Offers a live demo of the components in action for easy exploration and testing.
  • Documentation: Provides a documentation website for a reference on how to use the components effectively.

Installation

To install Qui, you have two options: import the entire library or import specific components as needed.

Fully Import

To fully import Qui, follow these steps:

  1. In your main.js file, import Qui:
import Qui from 'qui';
  1. In your Vue component, import the specific component(s) you want to use:
import { Button, Input } from 'qui';
  1. Configure the setup according to your requirements. For example, you can:
  • Import styles separately to avoid unused CSS:
import 'qui/dist/styles.css';
  • Set localization messages to support any language for the components:
Qui.localization.messages = {
  en: {
    button: 'Click me',
    input: 'Type something',
  },
  fr: {
    button: 'Cliquez ici',
    input: 'Entrez quelque chose',
  },
};
  • Control the setup of components:
Qui.setup({
  zIndex: 100,
  // other options
});

Code Examples

To learn how to use each component, refer to the component's stories in the Storybook Sandbox.

Using with Nuxt 3

To use Qui with Nuxt 3, follow these steps:

  1. Create a file in your plugins folder, e.g., qui.js.

  2. Add the following configuration to your nuxt.config.ts file:

export default {
  plugins: [
    { src: '~/plugins/qui.js', mode: 'client' },
  ],
}

Summary

Qui is a powerful Neumorphic design system specifically designed for Vue 3. Its extensive library of components, written with the Composition API and TypeScript, makes it easy to build great products for customers. With features like icons pack, neumorphic styles, and localization support, Qui is a comprehensive solution for designing and developing web applications. Its intuitive documentation and the Storybook Sandbox further facilitate the use and exploration of its components. Whether you are a beginner or an experienced developer, Qui provides the tools needed to create modern and visually appealing user interfaces.

vite
Vite

Vite is a build tool that aims to provide a faster and leaner development experience for modern web projects

vue
Vue

Vue.js is a lightweight and flexible JavaScript framework that allows developers to easily build dynamic and reactive user interfaces. Its intuitive syntax, modular architecture, and focus on performance make it a popular choice for modern web development.

scss
SCSS

SCSS is a preprocessor scripting language that extends the capabilities of CSS by adding features such as variables, nesting, and mixins. It allows developers to write more efficient and maintainable CSS code, and helps to streamline the development process by reducing repetition and increasing reusability.

ui-kit
UI Kits & Components

A UI kit provides developers with a set of reusable components that can be easily integrated into a website or application. These components are pre-designed with consistent styling and functionality, allowing developers to save time and effort in the design and development process. UI kits can be either custom-built or third-party, and often include components for buttons, forms, typography, icons, and more.

eslint
Eslint

ESLint is a linter for JavaScript that analyzes code to detect and report on potential problems and errors, as well as enforce consistent code style and best practices, helping developers to write cleaner, more maintainable code.

Stylelint

Stylelint is a modern linter for CSS that helps you avoid errors and enforce consistent styling conventions. It provides rules for detecting errors and warnings, and can be configured to match your specific project's requirements.

typescript
Typescript

TypeScript is a superset of JavaScript, providing optional static typing, classes, interfaces, and other features that help developers write more maintainable and scalable code. TypeScript's static typing system can catch errors at compile-time, making it easier to build and maintain large applications.