Build Errors

Run:

npm run build

Read the first meaningful error. Later errors are often caused by the first one.

Common Causes

• Invalid content collection frontmatter.
• Missing image imports or wrong image paths.
• Broken internal links.
• TypeScript errors in data files.
• Incorrect production URL assumptions.
• A dependency installed with an incompatible Node.js version.

Local Astro Execution

Use npm scripts or npx astro. Global Astro installs can hide project-specific dependency versions and make errors harder to reproduce.