Установка

Установите Alixan UI в Nuxt-проект. Компоненты копируются прямо в ваше приложение, поэтому вы владеете исходным кодом и можете свободно его настраивать.

Создайте проект

Начните с Nuxt 4 проекта. Если он у вас уже есть, этот шаг можно пропустить.

Terminal

npx nuxi@latest init my-app

nuxt.config.ts

export default defineNuxtConfig({
  app: {
    rootId: 'root', // Change appId to root.
  },
})

Добавьте Tailwind CSS

Компоненты Alixan UI используют классы Tailwind CSS и CSS-переменные для темы.

Установить Tailwind

npm install tailwindcss @tailwindcss/vite -D

app/assets/css/tailwind.css


@import 'tailwindcss';

@custom-variant dark (&:is(.dark *));

@theme {
	/* Set your own font. */
	--font-sans: 'Geist', ui-sans-serif, system-ui, sans-serif;

	/* Alixan UI text sizes. */
	--text-md: 15px;
	--text-xm: 17px;

	/* Default container */
	--container-container: 1500px;
}

@theme inline {
	--color-background: var(--background);
	--color-foreground: var(--foreground);

	--color-card: var(--card);
	--color-card-foreground: var(--card-foreground);

	--color-popover: var(--popover);
	--color-popover-foreground: var(--popover-foreground);

	--color-primary: var(--primary);
	--color-primary-foreground: var(--primary-foreground);

	--color-secondary: var(--secondary);
	--color-secondary-foreground: var(--secondary-foreground);

	--color-muted: var(--muted);
	--color-muted-foreground: var(--muted-foreground);

	--color-accent: var(--accent);
	--color-accent-foreground: var(--accent-foreground);

	--color-destructive: var(--destructive);
	--color-destructive-foreground: var(--destructive-foreground);

	--color-border: var(--border);
	--color-input: var(--input);
	--color-ring: var(--ring);

	--radius-sm: calc(var(--radius) - 4px);
	--radius-md: calc(var(--radius) - 2px);
	--radius-lg: var(--radius);
	--radius-xl: calc(var(--radius) + 2px);

}

:root {
	--radius: 0.65rem;

	--background: oklch(1 0 0);
	--foreground: oklch(0.141 0.005 285.823);

	--card: hsl(0, 0%, 98.5%);
	--card-foreground: oklch(0.141 0.005 285.823);

	--popover: oklch(1 0 0);
	--popover-foreground: oklch(0.141 0.005 285.823);

	--primary: oklch(0.141 0.005 285.823);
	--primary-foreground: oklch(0.985 0 0);

	--secondary: oklch(0.967 0.001 286.375);
	--secondary-foreground: oklch(0.21 0.006 285.885);

	--muted: oklch(0.967 0.001 286.375);
	--muted-foreground: oklch(0.552 0.016 285.938);

	--accent: oklch(0.967 0.001 286.375);
	--accent-foreground: oklch(0.21 0.006 285.885);

	--destructive: oklch(0.577 0.245 27.325);
	--destructive-foreground: oklch(1 0 0);

	--border: oklch(0.92 0.004 286.32);
	--input: oklch(0.92 0.004 286.32);
	--ring: oklch(0.708 0 0);

}

.dark {
	--background: oklch(0.141 0.005 285.823);
	--foreground: oklch(0.985 0 0);

	--card: oklch(0.21 0.006 285.885);
	--card-foreground: oklch(0.985 0 0);

	--popover: oklch(0.21 0.006 285.885);
	--popover-foreground: oklch(0.985 0 0);

	--primary: oklch(0.985 0 0);
	--primary-foreground: oklch(0.141 0.005 285.823);

	--secondary: oklch(0.274 0.006 286.033);
	--secondary-foreground: oklch(0.985 0 0);

	--muted: oklch(0.274 0.006 286.033);
	--muted-foreground: oklch(0.705 0.015 286.067);

	--accent: oklch(0.274 0.006 286.033);
	--accent-foreground: oklch(0.985 0 0);

	--destructive: oklch(0.704 0.191 22.216);
	--destructive-foreground: oklch(0.985 0 0);

	--border: oklch(1 0 0 / 10%);
	--input: oklch(1 0 0 / 15%);
	--ring: oklch(0.556 0 0);

}

@layer base {
	*,
	::after,
	::before,
	::backdrop,
	::file-selector-button {
		border-color: var(--border);
	}

	* {
		@apply m-0 p-0 box-border scroll-smooth outline-none;
	}

	html,
	body {
		@apply size-full min-h-full bg-background text-foreground overflow-hidden;
	}

	body {
		::-webkit-scrollbar {
			width: 6px;
			height: 6px;
		}

		::-webkit-scrollbar-track {
			border-radius: 10px;
			background: color-mix(in srgb, var(--border) 20%, transparent);
		}

		::-webkit-scrollbar-thumb {
			border-radius: 10px;
			background: color-mix(in srgb, var(--muted-foreground) 20%, transparent);
			cursor: grabbing;
		}

		::-webkit-scrollbar-thumb:hover {
			background: color-mix(in srgb, var(--foreground) 40%, transparent);
		}
	}

	#root {
		@apply h-full min-h-full w-full flex flex-col divide-y overflow-y-auto;
	}

	hr {
		@apply w-full h-px;
	}

	button:not(:disabled),
	[role='button']:not(:disabled) {
		cursor: pointer;
	}
	p,
	span {
		color: inherit;
	}

	select {
		-webkit-appearance: none;
		-moz-appearance: none;
		appearance: none;
		background: transparent;
	}

	input::-webkit-inner-spin-button,
	input::-webkit-outer-spin-button {
		-webkit-appearance: none;
	}

	input[type='search']::-webkit-search-cancel-button {
		@apply hidden;

		-webkit-appearance: none;
		appearance: none;
	}

	input[type='number'] {
		-moz-appearance: textfield;
	}
}

/* Used for dialog, drawer and overlays. */
@utility backdrop {
	@apply fixed inset-0 bg-black/30 dark:bg-black/80;
}

Оставьте backdrop utility в Tailwind CSS. Dialog, Drawer, Global Loader и мобильные overlay используют ее для единого цвета затемнения: fixed inset-0 bg-black/30 dark:bg-black/80.

nuxt.config.ts

import tailwindcss from '@tailwindcss/vite'

export default defineNuxtConfig({
  css: ['~/assets/css/tailwind.css'],
  features: {
    inlineStyles: true,
  },
  vite: {
    plugins: [tailwindcss()],
  },
})

Добавьте i18n (рекомендуется)

Alixan UI лучше всего работает с Nuxt i18n, потому что labels документации, заголовки таблиц и page meta используют ключи переводов. Установите missingWarn в false, если приложение также передает обычные значения через $t.

Установить Nuxt i18n

npm install @nuxtjs/i18n

Конфигурация

Используйте strategy: 'prefix_except_default' чтобы язык по умолчанию оставался без prefix, а остальные locales получали prefix.

Для более подробной информации перейдите в Подробнее в гайде i18n.

nuxt.config.ts

export default defineNuxtConfig({
  modules: ['@nuxtjs/i18n'],
  i18n: {
    vueI18n: './configs/i18n.config.ts',
    defaultLocale: 'en',
    strategy: 'prefix_except_default',
    detectBrowserLanguage: false,
    locales: [
      { code: 'en', name: 'English', file: 'en.json' },
      { code: 'ru', name: 'Русский', file: 'ru.json' },
      { code: 'kk', name: 'Қазақша', file: 'kk.json' },
    ],
  },
})

Укажите внешний vueI18n config и отключите i18n warnings в i18n/configs/i18n.config.ts.

i18n/configs/i18n.config.ts

export default {
  // Disable warnings because some UI props intentionally pass plain strings through $t.
  missingWarn: false,
  fallbackWarn: false,
}

Установите компонент

Запустите CLI из корня проекта. Компонент и необходимые утилиты будут скопированы в ваш проект.

npx alixan-ui-nuxt add button

Будут созданы файлы: components/ui/button/Button.vue , utils/cn.ts . Nuxt auto-import подключит компонент после копирования.

Используйте компонент

Используйте компонент напрямую в Vue-шаблонах. Для самого компонента не нужен импорт из пакета.

<template>
  <Button color="primary">
    Save changes
  </Button>
</template>