#code 1 error when creating a new starlight

5 messages · Page 1 of 1 (latest)

mellow rivetBOT
#

Hi @spiral shore. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

#

The error message itself is informative: dependency installation failed during the setup wizard, but the project was still initialized successfully. The output even confirms this:

■ Dependencies installed

This is a bit contradictory, but the key line is:

Dependencies failed to install, please run pnpm install to install them manually after setup.

What to do

Simply navigate into your new project directory and run pnpm install manually:

cd ./radiant-resonance
pnpm install

Once dependencies are installed, start the dev server: [Starlight Getting Started]

pnpm dev

This is a known pattern — if the automatic dependency installation step fails during create astro, you can always install dependencies manually afterward. [Install Astro]

If pnpm install also fails, it may be worth checking your Node.js version (Astro requires v22.12.0 or higher, and odd-numbered versions like v23 are not supported) or your network connection. [Install Astro]

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

#

@spiral shore Kapa.ai is still learning and improving, please let me know how I did by reacting below.

#

Let me check the knowledge base for you again. One moment! :books:

#

The knowledge sources do not contain enough information to explain specifically what "exit code 1" means in this context.

In general computing terms, an exit code of 1 typically indicates a generic error or failure — meaning the process did not complete successfully. In this case, it signals that the pnpm install step run by the create astro wizard failed for some reason.

The Astro documentation does note that if you see this kind of dependency installation failure, the recommended fix is to run pnpm install manually after setup. [Install Astro] The error itself doesn't point to a specific Astro-level cause — it's a generic process failure that could stem from network issues, Node.js version incompatibility, or package manager problems.

For deeper diagnosis, I'd recommend checking:

  • Your Node.js version (node -v) — Astro requires v22.12.0 or higher, and odd-numbered versions like v23 are not supported. [Dev Environment Setup]
  • Running pnpm install manually in the project directory and reviewing any additional error output it produces, which may give a more specific reason for the failure.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: