Skip to content
This is an unmaintained snapshot of the Astro v4 docs. View the latest docs.

Prepare your dev environment

Get ready to…

  • Install any tools that you will use to build your Astro website

You will use a command line (terminal) to create your Astro project and to run key commands to build, develop, and test your site.

You can access the command line through a local terminal program for your operating system. Common applications include Terminal (MacOS/Linux), Command Prompt (Windows), and Termux (Android). One of these will probably already be on your machine.

For Astro to run on your system, you will also need to have Node.js installed, version v18.17.1 or v20.3.0 or later. (v19 is not supported.)

To check to see whether you already have a compatible version installed, run the following command in your terminal:

Terminal window
node -v
// Example output
v18.17.1

If the command returns a version number higher than v18.17.1 or v20.3.0 (excluding any v19), you’re good to go!

If the command returns an error message like Command 'node' not found, or a version number lower than the required, then you need to install a compatible Node.js version.

Additionally, you will need to download and install a code editor to write your code.

  1. Download and install VS Code or another code editor of your choice.

Which of the following is…

  1. A code editor, for making changes to your files and their content?

  2. An online version control provider for your repository?

  3. An application for running commands?

  • FreeCodeCamp.org external — a free educational site with full courses or quick refreshers in HTML, CSS, JS, and more.

Contribute

What’s on your mind?

Create GitHub Issue

Quickest way to alert our team of a problem.

Community