Skip to content

feat(phase-1.5): design.md 비주얼 계약을 Home·목업·Prism·HeroVisual에 적용한다 - #58

Open
gitgitWi wants to merge 15 commits into
mainfrom
feat/phase-1.5-visual
Open

gitgitWi wants to merge 15 commits into
mainfrom
feat/phase-1.5-visual

Conversation

@gitgitWi

@gitgitWi gitgitWi commented Sep 9, 2026 •

Copy link
Copy Markdown
Owner

스택: base feat/phase-1-scaffold ← head feat/phase-1.5-visual — Phase 1(#56)이 먼저 머지돼야 이 디프가 맞다.

왜

Phase 1 스캐폴드는 paper #FAFAF8·sage #3F6B5A 자리 토큰과 껍데기 Home만 갖고 있다. Phase 2 콘텐츠 이식 전에 docs/conventions/design.md 계약(따뜻한 캔버스·민트 액센트·손글씨 디스플레이·Prism Vitesse Light)을 실제 페이지에 고정해야 이후 MDX·Collections가 같은 레이아웃 위에 올라간다.

흐름

flowchart TD
  subgraph ASIS["AS-IS"]
    A1["Phase 1 토큰·Home 껍데기"] --> A2["design.md와 시각 불일치"]
    A2 --> A3["Phase 2 레이아웃 재작업 위험"]
  end
  subgraph TOBE["TO-BE"]
    B1["design.md StyleX·Prism·폰트"] --> B2["Home·mock article·wiki"]
    B2 -->|"성공"| B3["Phase 2는 콘텐츠만 이식"]
    B2 -->|"한계"| B4["한글 웹폰트 용량은 perf를 깎을 수 있음"]
  end
  style A3 fill:#ffebee,stroke:#c62828,color:#c62828
  style B3 fill:#e8f5e9,stroke:#2e7d32,color:#2e7d32
  style B4 fill:#fff3e0,stroke:#e65100,color:#e65100
Loading

효과

flowchart LR
  P["이 PR"] --> U["사용자: Home·목업 기사·위키가 design.md 톤으로 보인다"]
  P --> Q["품질: Prism language-*·copy·Three Home-only client visible·a11y 100"]
Loading

범위

flowchart TD
  subgraph IN["이번 PR"]
    I1["토큰·Noto KR·Prism AA·CodeBlock·HeroCanvas island·Home·mock·Storybook"]
  end
  subgraph NEXT["후속"]
    N1["MDX Collections·실 기사 — phase-2 PLAN"]
    N2["colorway 다중 테마 — phase-2"]
  end
  subgraph OUT["제외"]
    X1["Pagefind·다크모드·Quiz — SPEC 비목표"]
    X2["기사 본문 Three — Home 히어로만"]
  end
Loading

검증

$ bun run check
Result (80 files):
- 0 errors
- 0 warnings
- 0 hints

$ bunx oxfmt --check .
All matched files use the correct format.

$ bunx oxlint .
(출력 없음, exit 0)

$ bunx vitest run
 Test Files  1 passed (1)
      Tests  4 passed (4)

$ bun run lint:stylex
(exit 0)

$ bun run build
9 page(s) built in 652ms
Complete!

$ bun run build-storybook
Storybook build completed successfully

$ bunx lighthouse :4321 / 와 /articles/mock --only-categories=accessibility --preset=desktop
Home a11y: 100
mock article a11y: 100

@gitgitWi gitgitWi added conventions Commit, PR, and code-style rules astro Astro, StyleX, GitHub Pages phase-1.5 Phase 1.5 Visual: design.md, Prism Vitesse Light, Home/mock layouts labels Sep 9, 2026
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@gitgitWi gitgitWi self-assigned this Sep 9, 2026
@gitgitWi
gitgitWi marked this pull request as ready for review September 9, 2026 17:46
@gitgitWi
gitgitWi added this pull request to stack #62 September 13, 2026 18:38
Base automatically changed from feat/phase-1-scaffold to main October 2, 2026 04:40
gitgitWi and others added 15 commits October 2, 2026 13:40
컨셉 목업의 다크 코드는 버리고 캔버스·액센트에 가까운 Vitesse Light 계열을 쓴다.

Co-authored-by: Cursor <cursoragent@cursor.com>
콘텐츠 이식 전에 토큰·레이아웃·Prism을 컨셉에 맞춘다.

Co-authored-by: Cursor <cursoragent@cursor.com>
코드는 Prism 라이트, 레이아웃은 mock, three는 히어로 island만 올린다.

Co-authored-by: Cursor <cursoragent@cursor.com>
Phase 1 paper/sage hex를 canvas·accent #16A36A·4px space로 맞춘다.
Three.js는 Home만 lazy 로드하고 reduced-motion·모바일은 SVG 폴백을 쓴다.
preview에 prism-vitesse-light를 로드하고 ColorwayShell 토큰명을 맞춘다.
변경 내용 없이 줄바꿈·공백만 정리한다.
client: visible island와 한글 글리프 번들에 필요하다.
Co-authored-by: Cursor <cursoragent@cursor.com>
인라인 IntersectionObserver 대신 Astro visible 하이드레이션을 쓴다.

Co-authored-by: Cursor <cursoragent@cursor.com>
Lighthouse가 14px 메타·코드 토큰에서 3.x:1을 잡았다.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@gitgitWi
gitgitWi force-pushed the feat/phase-1.5-visual branch from e622ca7 to c18a757 Compare October 2, 2026 04:40

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

astro Astro, StyleX, GitHub Pages conventions Commit, PR, and code-style rules phase-1.5 Phase 1.5 Visual: design.md, Prism Vitesse Light, Home/mock layouts

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant