JS
#astro#output#static#ssg#config

Astro: output static — статическая сборка по умолчанию

Режим output: 'static' (по умолчанию) — все страницы генерируются при сборке. Без adapter, подходит для блогов и лендингов.

Как использовать

  1. Скопируйте нужный фрагмент кода.
  2. Вставьте в свой проект и при необходимости измените под задачу.
  3. Проверьте зависимости и окружение (версии, переменные).

По умолчанию Astro использует output: "static": при astro build все страницы рендерятся в статические HTML-файлы. Adapter не требуется. Документация: Output modes, Static output.

// astro.config.mjs
import { defineConfig } from 'astro/config';

export default defineConfig({
  output: 'static', // можно не указывать — значение по умолчанию
});

Что получается:

  • Все страницы и маршруты превращаются в HTML при сборке.
  • Деплой на любой статический хостинг (Netlify, Vercel, GitHub Pages, CDN).
  • API routes и getServerSideProps-подобная логика недоступны без перехода на server или hybrid.

Когда выбирать static:

  • Блог, документация, лендинги, маркетинг-сайт.
  • Контент известен на момент сборки.
  • Интерактив только через островки (формы можно через сторонние сервисы или отдельный backend).

Usage:

Не указывайте output или укажите output: "static". Для SSR или API routes переключитесь на output: "server" или output: "hybrid" и добавьте adapter.

Notes:

⚠️ При output: "static" страницы с export const prerender = false не поддерживаются — такой экспорт имеет смысл только при output: "hybrid" или "server".

Похожие сниппеты