Common Issues
Runtime issues
TIP
Issues occuring in browser
[Vue Router warn]: No match found for location with path "index"
SOLUTION
Since Vuero v2.4.0, we replaced vite-plugin-page with unplugin-vue-router which work similarly, except how they name the routes.
You have to replace routes from "index" to their path, ex: "/"
Read more on the unplugin-vue-router documentation.
TypeError: Failed to fetch dynamically imported module: http://localhost:5000/assets/xxx.xxx.js
SOLUTION
This error occur when you try to build the full vuero template downloaded from envato. This is due to demo images that we can not bundle into the final release according to envato rules.
You can use online version in replacement, or use the github version.
To use online version, search for /demo/([^'"]+)
and replace with https://vuero.cssninja.io/demo/$1
using a regex (in visual studio code it's the .*
icon)
Build issues
TIP
Issues occuring when installing, starting a dev environment or when building
error when starting runing npm run dev
: [ERROR] Could not resolve "./vite-plugin-vuero-doc"
SOLUTION
Using quickstarter v2.6.0
requires you to update the vite.config.ts
before starting the development server (we are working on a better solution for next release):
// ...
// comment this import
// local vite plugin
// import { VitePluginVueroDoc } from './vite-plugin-vuero-doc'
// ...
export default defineConfig({
// ...
plugins: [
// ...
// comment this block
// VitePluginVueroDoc({
// pathPrefix: 'documentation',
// wrapperComponent: 'DocumentationItem',
// shiki: {
// theme: {
// light: 'min-light',
// dark: 'github-dark',
// },
// },
// sourceMeta: {
// enabled: true,
// editProtocol: 'vscode://vscode-remote/wsl+Ubuntu', // or 'vscode://file'
// },
// }),
],
})
error when starting runing npm install
: npm ERR! ERESOLVE unable to resolve dependency tree
SOLUTION
- Check that your node version is up to date with latest LTS (v16.x.x) with
node -v
https://nodejs.org/ - Check your npm version with
npm -v
. It should be v8.x.xbashnpm install --global npm
- You will need to remove and reinstall your
node_modules
and remove thepackage-lock.json
file after updating npm/node.bashrm -rf node_modules package-lock.json
- Now you can install using
--legacy-peer-deps
*bashnpm install --legacy-peer-deps
npm WARN read-shrinkwrap
This version of npm is compatible with [email protected]
, but package-lock.json
was generated for [email protected]
. I'll try to do my best with it
SOLUTION
You need to update your npm version to v8.x.x which does support [email protected]
npm install --global npm
npm install --legacy-peer-deps
error when starting dev server: xxxx/vite.config.ts:230
if (!config?.isProduction)
^ SyntaxError: Unexpected token ’.’
SOLUTION
Your node version does not support Optional chaining (?.)
operator which is introduced in Node V14.
Upgrade your node to latest LTS (v16.x.x) version: https://nodejs.org/
[vite-plugin-pwa] [vite]: Rollup failed to resolve import "/demo/xxxx"
from "src/xxxx"
.
SOLUTION
This is due to demo images that we can not bundle into the final release according to envato rules.
Edit vite.config.ts
file and uncomment the rollupOptions
section:
export default defineConfig({
//...
build: {
/**
* Uncomment this section to build the demo with missing images
* Don't forget to remove this section when you replaced assets with yours
*/
rollupOptions: {
external: [/\/demo\/.*/],
},
},
//...
});