Editor Setup

Customize your code editor to improve the Astro developer experience and unlock new features.

VS Code is a popular code editor for web developers, built by Microsoft. The VS Code engine also powers popular in-browser code editors like GitHub Codespaces and Gitpod.

Astro works with any code editor. However, VS Code is our recommended editor for Astro projects. We maintain an official Astro VS Code Extension that unlocks several key features and developer experience improvements for Astro projects.

• Syntax highlighting for .astro files.
• TypeScript type information for .astro files.
• VS Code Intellisense for code completion, hints and more.

To get started, install the Astro VS Code Extension today.

📚 See how to set up TypeScript in your Astro project.

Our amazing community maintains several extensions for other popular editors, including:

• VS Code Extension on Open VSX Official - The official Astro VS Code Extension, available on the Open VSX registry for open platforms like VSCodium
• Nova Extension Community - Provides syntax highlighting and code completion for Astro inside of Nova
• Vim Plugin Community - Provides syntax highlighting, indentation, and code folding support for Astro inside of Vim or Neovim
• Neovim LSP and TreeSitter Plugins Community - Provides syntax highlighting, treesitter parsing, and code completion for Astro inside of Neovim

JetBrains have announced upcoming support for Astro in their Webstorm IDE. The Roadmap shows that Astro will be supported in the 2023.1 release, which is scheduled for the end of March 2023.

JetBrains’ upcoming Fleet IDE also supports language servers and therefore, our currently available tooling will be able to run there without any problem.

In addition to local editors, Astro also runs well on in-browser hosted editors, including:

• StackBlitz and CodeSandbox - online editors that run in your browser, with built-in syntax highlighting support for .astro files. No installation or configuration required!
• GitHub.dev - allows you to install the Astro VS Code extension as a web extension, which gives you access to only some of the full extension features. Currently, only syntax highlighting is supported.
• Gitpod - a full dev environment in the cloud that can install the official Astro VS Code Extension from Open VSX.

ESLint is a popular linter for JavaScript and JSX. For Astro support, a community maintained plugin can be installed.

See the project’s User Guide for more information on how to install and set up ESLint for your project.

Prettier is a popular formatter for JavaScript, HTML, CSS and more. To add support for formatting .astro files, use the official Astro Prettier plugin.

To get started, first install Prettier and the plugin:

npm install --save-dev prettier prettier-plugin-astro

Prettier will then automatically detect the plugin and use it to process .astro files when you run it:

prettier --write .

See the Prettier plugin’s README for more information about its supported options, how to set up Prettier inside VS Code, and more.