Docs template with Nuxt & NuxtUI 4
Hi,
Is the Docs template working. I tried last night real quickly to install the latest but got a bunch of errors in Docs template with the latest Nuxt and NuxtUI. Using NPM as package manager.
Will try tomorrow again, but just checking if it's just me?
6 Replies
Hi @Menttis. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:
----------------------
Based on the knowledge sources, the Docs template for Nuxt is designed to work with Nuxt 4 and Nuxt UI 4. The template is described as a minimal, modern documentation starter that uses Nuxt 4, Nuxt Content, and Nuxt UI, and it should be compatible with the latest versions of these packages. The recommended installation steps are:
or
This will scaffold a new project using the Docs template with the latest Nuxt and Nuxt UI versions. The template is intended to be fully compatible with Nuxt 4 and Nuxt UI 4, as indicated in the documentation and migration guides. Nuxt UI v4 is now unified and fully open-source, but it does require Nuxt 4 as a peer dependency, so both must be on their latest major versions for compatibility Migration to v4 Docs Template.
If you encountered errors, it could be due to:
- Not using the latest Nuxt 4 and Nuxt UI 4 versions.
- A temporary issue with dependencies or the npm registry.
- A local cache or lockfile issue.
Recommended steps:
1. Ensure you are using Node.js 20.x or newer.
2. Remove any existing
- Docs Template
- Nuxt UI Installation
- Migration to Nuxt UI v4 ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
node_modules and lockfiles (package-lock.json).
3. Try scaffolding the project again with the command above.
4. If you still encounter errors, check for any open issues on the Nuxt UI GitHub or Nuxt GitHub repositories, as breaking changes or bugs may occasionally occur right after major releases.
There is no explicit mention in the knowledge sources of a widespread or ongoing issue with the Docs template and the latest Nuxt/Nuxt UI, so it is likely not a general problem. If issues persist, please provide the specific error messages for further troubleshooting.
References:- Docs Template
- Nuxt UI Installation
- Migration to Nuxt UI v4 ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
<@1006885749465043007> Kapa.ai is still learning and improving, please let me know how I did by reacting below.
Can you give me more details?
Well, it installs without errors, also no errors in console, but the page just keeps in loading mode... the browser keeps just loading.
package.json:
´´´
{
"name": "nuxt-ui-template-docs",
"private": true,
"type": "module",
"scripts": {
"build": "nuxt build",
"dev": "nuxt dev",
"preview": "nuxt preview",
"postinstall": "nuxt prepare",
"lint": "eslint .",
"typecheck": "nuxt typecheck"
},
"dependencies": {
"@iconify-json/lucide": "^1.2.68",
"@iconify-json/simple-icons": "^1.2.54",
"@iconify-json/vscode-icons": "^1.2.30",
"@nuxt/content": "^3.7.1",
"@nuxt/image": "^1.11.0",
"@nuxt/ui": "^4.0.1",
"better-sqlite3": "^12.4.1",
"nuxt": "^4.1.2",
"nuxt-llms": "0.1.3",
"nuxt-og-image": "^5.1.11"
},
"devDependencies": {
"@nuxt/eslint": "^1.9.0",
"eslint": "^9.37.0",
"typescript": "^5.9.3",
"vue-tsc": "^3.1.0"
},
"resolutions": {
"unimport": "4.1.1"
},
"packageManager": "pnpm@10.18.0"
}
´´´
What command did you use to install it and what version of Node are you running?
v22.14.0
npm create nuxt@latest -- -t ui/docs