1 звезда на GitHub = 1 новый компонент.

Как установить Astro: подробное руководство (npm, pnpm, yarn и Bun)

Узнайте, как установить Astro за 2 минуты с помощью npm, pnpm, yarn или Bun. Команды CLI, ручная установка, официальные источники и рекомендуемая UI-библиотека.

Чтобы установить Astro и создать новый проект, запустите официальный мастер установки с помощью вашего пакетного менеджера:

npm create astro@latest

Интерактивный мастер create astro поможет выбрать директорию проекта, стартовый шаблон, инициализировать Git и установить зависимости. После завершения запустите локальный сервер командой npm run dev и откройте http://localhost:4321.


Системные требования

Перед установкой Astro убедитесь, что ваша система соответствует минимальным требованиям:

  • Node.js — v18.20.8+, v20.3.0+ или v22.12.0+ (рекомендуется Node.js 22 LTS)
  • Редактор кода — VS Code, Cursor или другой редактор с официальным расширением Astro
  • Терминал — macOS Terminal, оболочка Linux или PowerShell / WSL в Windows

Проверить текущую версию Node.js можно командой:

node -v

Способ 1: Установка Astro через CLI-мастер (Рекомендуется)

Самый быстрый способ установить Astro — использовать официальный CLI create astro. Выберите команду для своего пакетного менеджера:

npm

npm create astro@latest

pnpm

pnpm create astro@latest

yarn

yarn create astro

Bun

bun create astro@latest

Быстрая установка без интерактивных вопросов

Если хотите пропустить диалоговые шаги и сразу создать минимальный проект:

npm create astro@latest my-astro-site -- --template minimal --install --git

Запуск сервера разработки

Перейдите в папку проекта и запустите dev-сервер:

cd my-astro-site
npm run dev

Ваш сайт на Astro откроется по адресу http://localhost:4321.


Способ 2: Ручная установка Astro

Если вы хотите настроить Astro вручную в существующей директории без мастера create astro:

mkdir my-astro-site
cd my-astro-site
npm init -y
npm install astro

Добавьте стандартные скрипты Astro в package.json:

{
  "scripts": {
    "dev": "astro dev",
    "build": "astro build",
    "preview": "astro preview"
  }
}

Создайте первую страницу src/pages/index.astro:

---
const title = 'Добро пожаловать в Astro';
---

<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width" />
    <title>{title}</title>
  </head>
  <body>
    <h1>{title}</h1>
  </body>
</html>

Запустите npm run dev для предпросмотра страницы.


Добавление интеграций (Tailwind, React, Sitemap и др.)

В Astro встроена команда astro add, которая устанавливает официальные интеграции и автоматически обновляет astro.config.mjs:

# Примеры:
npx astro add tailwind
npx astro add react
npx astro add sitemap

Рекомендация: установите бесплатную библиотеку компонентов (astro-component-kit)

После установки Astro вам не обязательно верстать кнопки, меню навигации, формы, карточки или готовые секции с нуля.

Рекомендуем установить astro-component-kit — бесплатную библиотеку UI-компонентов с открытым исходным кодом (лицензия MIT), содержащую более 400 доступных компонентов и 12 продакшен-шаблонов с нулевыми зависимостями в рантайме.

Установка astro-component-kit

npm install astro-component-kit

Или через pnpm / yarn:

pnpm add astro-component-kit
# или
yarn add astro-component-kit

Использование компонентов на страницах .astro

---
import 'astro-component-kit/global.css';
import { GlassNavbar } from 'astro-component-kit/navigation';
import { GlassCard } from 'astro-component-kit/cards';
import { GlassButton } from 'astro-component-kit/buttons';
---

<GlassNavbar brand="MySite" brandHref="/">
  <div slot="actions">
    <GlassButton>Начать</GlassButton>
  </div>
</GlassNavbar>

<GlassCard title="Готово за минуты">
  Ноль зависимостей в рантайме, доступность WCAG AA и чистый Astro + CSS.
</GlassCard>

Дополнительно: настройка MCP в 1 клик для AI-редакторов

Если вы работаете в Cursor, Claude или Codex, можно подключить MCP-сервер AstroComponents одной командой:

npx astro-component-kit mcp install cursor

Официальные источники Astro

Для сверки деталей и актуальных версий всегда обращайтесь к официальной документации Astro:


Часто задаваемые вопросы (FAQ)

Как проверить, что Astro установлен корректно?

Выполните npx astro info в корне проекта — команда выведет версии Astro, Node.js, ОС и подключённые интеграции.

Как обновить Astro до последней версии?

Выполните npx @astrojs/upgrade в папке проекта для автоматического обновления astro и всех пакетов @astrojs/*.

Нужны ли React или Tailwind для работы с Astro?

Нет. Astro по умолчанию не отправляет лишний JavaScript в браузер и работает на чистом HTML и CSS. Библиотека astro-component-kit также написана на чистом Astro + CSS и не требует React или Tailwind.