Astro 기반의 개인 개발 블로그입니다. MDX, React, Tailwind CSS를 사용합니다.

• Node.js >=22.12.0
• npm

npm install

npm run dev

브라우저에서 http://localhost:4321로 접속합니다.

npm run build

빌드 결과물은 dist/ 디렉토리에 생성됩니다.

npm run preview

src/
├── assets/         # 폰트, 이미지 등 정적 자원
├── components/     # 재사용 가능한 컴포넌트
├── content/        # 블로그 포스트 (MDX)
│   └── blog/
├── layouts/        # 페이지 레이아웃
├── pages/          # 라우팅 페이지
├── styles/         # 전역 스타일
└── consts.ts       # 사이트 메타데이터 상수

src/consts.ts에서 사이트 기본 정보를 수정합니다.

export const SITE_TITLE = '개발 블로그';
export const SITE_DESCRIPTION = '...';
export const SITE_AUTHOR = '...';
export const GITHUB_URL = 'https://github.com/your-username';

astro.config.mjs에서 배포 URL을 설정합니다.

export default defineConfig({
  site: 'https://your-username.github.io',
  // ...
});

src/content/blog/ 디렉토리에 .md 또는 .mdx 파일을 추가합니다.

---
title: '포스트 제목'
description: '포스트 설명'
pubDate: '2026-01-01'
---

본문 내용...

• Astro — 정적 사이트 프레임워크
• React — 인터랙티브 컴포넌트
• Tailwind CSS — 스타일링
• MDX — 마크다운 + JSX
• Giscus — 댓글 시스템 (GitHub Discussions 기반)