Skip to content
MasteryMesh DocsMasteryMesh Docs

Common Issues

npm install Fails

Section titled “npm install Fails”

Check Node.js and npm versions. Delete node_modules and the lockfile only when you understand the dependency impact, then reinstall. Network, registry, or permission errors may require local environment fixes.

Unsupported Node.js Version

Section titled “Unsupported Node.js Version”

Use a current Node.js LTS version compatible with the theme. Hosting should use the same major version where possible.

Port Already in Use

Section titled “Port Already in Use”

npm run dev may choose another port or fail depending on the environment. Stop the process using the port or use the URL Astro prints in the terminal.

Astro Command Not Found

Section titled “Astro Command Not Found”

Use project-local commands:

Terminal window
npm run dev
npm run build
npx astro --help

Do not require a global Astro installation.