Cheat Sheet เริ่มโปรเจกต์ Nuxt 4 + Nuxt UI v4 + Tailwind CSS v4
Cheat sheet เริ่มโปรเจกต์ Nuxt 4 พร้อม Nuxt UI v4 และ Tailwind CSS v4 ตั้งแต่ create nuxt ติดตั้ง module ตั้งค่า main.css จนถึงสร้าง layout
เริ่มโปรเจกต์ Nuxt 4 กับ Nuxt UI v4 ไม่ต้องตั้งค่า Tailwind เองแล้ว ไม่ต้องลง @tailwindcss/vite หรือเพิ่ม vite plugin
แค่ลง @nuxt/ui คู่กับ tailwindcss ใส่ module ใน nuxt.config.ts แล้ว import สองตัวนี้ใน app/assets/css/main.css ก็ใช้ได้เลย
Init NuxtJS
Docs: https://nuxt.com/docs/4.x/getting-started/installation
npm create nuxt@latest <project-name>
✔ Which package manager would you like to use?
npm
✔ Initialize git repository?
Yes
ℹ Initializing git repository...
❯ Would you like to install any of the official modules?
◼ @nuxt/content – The file-based CMS with support for Markdown, YAML, JSON
◼ @nuxt/eslint – Project-aware, easy-to-use, extensible and future-proof ESLint integration
◼ @nuxt/fonts – Add custom web fonts with performance in mind
◼ @nuxt/icon – Icon module for Nuxt with 200,000+ ready to use icons from Iconify
◼ @nuxt/image – Add images with progressive processing, lazy-loading, resizing and providers support
◼ @nuxt/scripts – Add 3rd-party scripts without sacrificing performance
◻ @nuxt/test-utils – Test utilities for Nuxt
◼ @nuxt/ui – The Intuitive UI Library powered by Reka UI and Tailwind CSS
Nuxt 4 เก็บโค้ดของแอปไว้ในโฟลเดอร์ app/ ทั้ง pages/, layouts/, components/, plugins/ และ assets/ path ในบทความนี้เลยขึ้นต้นด้วย app/
Preventing Yarn (Allow only NPM)
"engines": {
"yarn": "Please use NPM!",
"node": "22.x",
"npm": ">=6"
}
echo "22" > .nvmrc
echo "engine-strict=true" > .npmrc
ติดตั้ง Nuxt UI v4 กับ Tailwind CSS v4
Docs: https://ui.nuxt.com/docs/getting-started/installation/nuxt
ถ้าตอน create ยังไม่ได้เลือก @nuxt/ui ให้ลงเอง
npm install @nuxt/ui tailwindcss
ใส่ module และไฟล์ css ใน nuxt config
export default defineNuxtConfig({
modules: ['@nuxt/ui'],
css: ['~/assets/css/main.css'],
})
สร้างไฟล์ css
@import 'tailwindcss';
@import '@nuxt/ui';
ครอบแอปด้วย <UApp> เพื่อให้ toast, tooltip และ overlay ที่เปิดจากโค้ดของ Nuxt UI ทำงาน
<template>
<UApp>
<NuxtLayout>
<NuxtPage />
</NuxtLayout>
</UApp>
</template>
Nuxt Layout
Docs: https://nuxt.com/docs/4.x/directory-structure/app/layouts
<NuxtLayout> ใน app/app.vue ด้านบนจะใช้ layout ชื่อ default เป็นค่าเริ่มต้น
<template>
<div>
<p>Some default layout content shared across all pages</p>
<slot />
</div>
</template>
ถ้าหน้าไหนต้องใช้ layout อื่น ให้สร้างไฟล์ layout ชื่อนั้นไว้ใน app/layouts/ เช่น app/layouts/no-auth.vue แล้วเลือกจากหน้านั้นด้วย definePageMeta
<template>
<div>Login Page</div>
</template>
<script setup lang="ts">
definePageMeta({
layout: 'no-auth',
})
</script>