Astro은(는) 무엇을 하나요?
개요
Astro는 기본적으로 제로 자바스크립트를 제공하는 콘텐츠 중심 웹사이트 구축을 위한 웹 프레임워크입니다. 섬(island) 아키텍처를 통해 대화형 컴포넌트만 선택적으로 수화(hydrate)하여 뛰어난 Lighthouse 점수를 달성하면서, 대화형이 필요한 곳에서는 React, Vue, Svelte 등 모든 UI 프레임워크를 지원합니다.
사용 방법
- 페이지를 만들 때는
src/pages/에서.astro,.md,.mdx파일을 사용하는 파일 기반 라우팅을 사용하고, 공유 구조는src/layouts/에 구성하세요. - 상호작용을 추가할 때는 프레임워크 컴포넌트에 클라이언트 디렉티브를 사용하세요: 대부분의 컴포넌트는 즉시 수화가 필요 없으므로
client:load보다는client:visible또는client:idle을 선호하세요. - 콘텐츠를 관리할 때는
src/content/에서defineCollection()을 사용해 엄격한 Zod 스키마로 Content Collections를 정의하고,getCollection()과getEntry()로 질의하세요. - 렌더링 모드를 선택할 때는 마케팅 및 콘텐츠 페이지에는 정적(SSG)을 기본으로 하고, 동적 페이지에는
output: "server"를 사용하며, 페이지별로export const prerender = false를 사용하는 하이브리드 렌더링을 활용하세요. - 이미지를 최적화할 때는 원시
<img>태그 대신astro:assets의<Image>컴포넌트를 사용하여 자동 포맷 변환(WebP/AVIF), 크기 조정, 지연 로딩을 적용하세요. - 페이지 전환을 추가할 때는 클라이언트 측 라우터를 제공하지 않고 SPA와 유사한 탐색을 위해
<ViewTransitions />로 View Transitions를 활성화하세요. - UI 프레임워크를 통합할 때는 적절한 통합 모듈(
@astrojs/react,@astrojs/vue,@astrojs/svelte)을 설치하고, 정적 콘텐츠에는 Astro 컴포넌트를 사용하며, 상호작용이 필요한 경우에만 프레임워크 컴포넌트를 사용하세요.
예시
예시 1: Content Collections로 블로그 구축
사용자 요청: "타입 안전한 Markdown 콘텐츠가 있는 Astro 블로그 만들어 줘"
수행 단계:
- 프론트매터(title, date, tags, author)에 대한 Zod 스키마로 블로그 Content Collection 정의
getStaticPaths()를 사용하여 동적 라우트src/pages/blog/[slug].astro생성- 정렬과 함께
getCollection("blog")를 질의하여 블로그 인덱스 페이지 구축 - SEO 메타 태그, 내비게이션, View Transitions가 포함된 레이아웃 추가
결과: 검증된 콘텐츠, 깔끔한 URL, 부드러운 페이지 전환을 제공하는 정적으로 생성된 블로그.
예시 2: 정적 사이트에 대화형 컴포넌트 추가
사용자 요청: "내 Astro 문서 사이트에 React 검색 컴포넌트를 추가해 줘"
수행 단계:
@astrojs/react통합 모듈 설치- 상태와 이벤트 처리를 갖춘 React 검색 컴포넌트 생성
client:idle디렉티브를 사용하여 페이지에 컴포넌트 추가- Astro 페이지 프론트매터에서 정적 데이터를 props로 전달
결과: 대화형 검색 섬을 제외하고는 완전히 정적인 문서 사이트.
지침
- 정적 콘텐츠에는 Astro 컴포넌트(
.astro)를 사용하고, 상호작용이 필요한 경우에만 React/Vue/Svelte를 사용하세요. - 수화 디렉티브는
client:load보다client:visible또는client:idle을 기본으로 사용하세요. - 빌드 시 콘텐츠 오류를 잡기 위해 엄격한 Zod 스키마로 Content Collections를 정의하세요.
- 자동 최적화를 위해 원시
<img>태그보다astro:assets의<Image>를 사용하세요. - 공유
<head>, 내비게이션, 푸터가 있는 레이아웃은 얇게 유지하고, 페이지별 콘텐츠는 페이지에 넣으세요. - 마케팅 페이지는 정적(SSG), 개인화나 동적 페이지는 SSR만 사용하는 하이브리드 렌더링을 사용하세요.
- 라우터를 제공하지 않고 SPA와 유사한 탐색을 위해 View Transitions를 활성화하세요.