FAQ & Troubleshooting

Basic knowledge of Vue 3 and the Composition API is recommended. You don't need to understand Nuxt internals — most customization involves editing .vue files and JSON data files.

Yes. A Regular License on ThemeForest covers one end product used by one client. For SaaS or multiple end products, an Extended License is required.

No — the template ships with static JSON mock files. See the API Usage and Backend Integration sections for connecting a real backend.

Try running with the legacy resolver flag:

npm install --legacy-peer-deps

If the issue persists, delete node_modules and package-lock.json and try again:

rm -rf node_modules package-lock.json
npm install

Another process is using port 3000. Either stop that process, or start the dev server on a different port:

npm run dev -- --port 3001

1. Check the terminal for errors — most blank screen issues are caused by a missing dependency or a syntax error.
2. Make sure your Node.js version satisfies ^22.12.0 || ^24.11.0 || >=26.0.0 (Nuxt 4's requirement): node -v.
3. Try clearing the Nuxt cache: rm -rf .nuxt and restart. :::

PWA install prompts only appear over HTTPS. On localhost it works in Chrome and Edge, but not Safari. Make sure you're not using Firefox, which doesn't support PWA installation.

Installed PWAs cache assets via a service worker. The app uses registerType: 'prompt' — when a new version is deployed, a prompt will appear asking the user to update. If the prompt doesn't appear:

1. Open the installed app and pull to refresh.
2. In Chrome DevTools → Application → Service Workers, click Update or Unregister, then reload.
3. On mobile, clear the app cache in browser settings and reopen. :::

Check that your environment variables (.env) are set on the hosting platform. Platforms like Vercel and Netlify have a dedicated UI for adding environment variables — they are not read from the .env file in production.

Static hosts need to be configured to serve index.html for all routes. On Netlify, add a _redirects file to public/:

/* /index.html 200

On Vercel this is handled automatically.