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)

package.json
"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

nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxt/ui'],
  css: ['~/assets/css/main.css'],
})

สร้างไฟล์ css

app/assets/css/main.css
@import 'tailwindcss';
@import '@nuxt/ui';

ครอบแอปด้วย <UApp> เพื่อให้ toast, tooltip และ overlay ที่เปิดจากโค้ดของ Nuxt UI ทำงาน

app/app.vue
<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 เป็นค่าเริ่มต้น

app/layouts/default.vue
<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

app/pages/login.vue
<template>
  <div>Login Page</div>
</template>

<script setup lang="ts">
definePageMeta({
  layout: 'no-auth',
})
</script>

กลับไปหน้า Blog

Copyright © 2026