제작 종료(2026-09-18). 장문 없음 — 표·링크만.

관련 링크
허브 Astro 블로그
디자인 ‣
CMS ‣
Posts DB ‣
레포 cpt4567/former-force
Figma EWt5VrwYVBpTAfXpqJnRah
홈 원본 김민섭의 notion

1. 아키텍처

층 내용
공개 셸 Astro · dark-only · Admin UI 없음
CMS SSOT Notion Posts · 빌드타임 @notionhq/client
시크릿 .env NOTION_TOKEN · NOTION_DATABASE_ID (gitignore)
목록 캐시 .cache/notion · dev TTL 10m · NOTION_CACHE=0 bust
본문 캐시 목록보다 짧으면 refetch (b79c690)
로컬 /Users/mac/develop/astro-blog/former-force

2. 라우트 · 페이징 · 태그

항목 확정
Home Latest ≤5 · NN NOTES · 전체보기 → /posts
내비 「게시글」→ /posts
pageSize 10
페이징 path /posts/page/[n] · /tags/[tag]/page/[n]
기타 / · /posts/[slug] · /insights · /about
VT TopNav persist + 콘텐츠 스켈레톤 · ~220ms · CONTENT LOADING · QUIET
URL 슬러그 칩 표시
ai ai
javascript javascript
pattern pattern
next-js next js
library-skills library & skills
server server
docker docker
ci-cd CI/CD
android android
ios ios
react-native react native
note note
astro astro
infra infra

3. 환경변수

키 용도 비고
NOTION_TOKEN Notion API gitignore
NOTION_DATABASE_ID Posts DB f8df805f4a9d457785ded495a53b5e8d
NOTION_CACHE 캐시 bust 0이면 강제 refetch

4. Figma ↔ 구현

영역 Figma 비고
Home / 히어로 2:78 / 2:18 L1 「동작하게 만들고,」 · L2 틸 「읽히게 남긴다.」
Specs 138:572 —
Pagination 144:396 pageSize 10
Transition / Skeleton 143:* VT ~220ms
Export /workspace/astro-blog-figma/exports/ 레포 docs/screenshots/
히어로 아이콘 정적 PNG 에셋 2552851 · WebGL 후순위

5. 결정 로그

결정 값
테마 dark-only · ThemeToggle 없음
Home Latest ≤5
pageSize 10
페이징 URL path only (/posts/page/[n] …)
히어로 모션 WebGL 후순위 · 정적 PNG 우선
사이트명 / 하이라이트 Kim mr. · Shiki github-dark
About 개발자 소개 · GitHub cpt4567 · mailto:[email protected]
토큰 색 shell #0B1220 · Ink Teal #0F766E (purple 금지)
제작 상태 종료 (구현·결정 SSOT = 이 페이지)

6. 남은 일

항목 상태
GH Actions 배포 개발 진행 중
WebGL 히어로 후순위
Soft 보류
홈 개발글 → Posts Published 이관 중 (배포→infra · RN 잔여)