bodalab/doc/figma-specs.md

22 lines
2.2 KiB
Markdown

# 참고: Figma 노드 ID 모음 (file_key: `MnwN1Uzg5F6ks9Clr1brLW`)
- PC 전체 페이지(컴포지트): `2247:2093` / 모바일 전체 페이지(컴포지트): `2319:5243`
- 01_HOME PC `2247:2094` / Mobile `2319:2232`
- 02_ABOUT US PC `2247:2230` / Mobile `2319:2288`
- 03_HISTORY PC `2247:2121` / Mobile `2319:2433`
- 04_VISION PC `2247:2183` / Mobile `2319:4183`
- 05_PROJECT PC `2247:2202` / Mobile `2319:4231`
- 06_CONTACT/FOOTER(문서상 라벨은 "Expertise") PC `2247:2253` / Mobile `2319:5082`
- 모바일 GNB 드로어(열린 상태): `2319:5998`
- footer 전용 인스턴스: PC `2247:2294` / Mobile `2319:4996`
- 개인정보 동의 모달: PC `2319:2118` / Mobile `2376:2184`
상세 스펙 데이터는 `doc/figma-specs-0624/` 폴더 참고(섹션별 JSON/txt, README에 사용법 정리됨).
# 참고: Figma 데이터 가져오는 법
- Figma REST API를 직접 호출하는 게 가장 안정적: `.mcp.json``FIGMA_API_KEY``GET https://api.figma.com/v1/files/{file_key}/nodes?ids={node_id}` (특정 노드 JSON), `GET https://api.figma.com/v1/images/{file_key}?ids={node_id}&format=jpg&scale=2` (이미지로 export). 노드 ID만 알면 토큰 한도·이미지 export 제약 둘 다 우회됨.
- `mcp__figma__add_figma_file(url)`은 문서 전체를 한 번에 덤프해서 토큰 한도에 걸리고, `mcp__figma__view_node(file_key, node_id)`는 PNG 렌더만 보여주고 파일로 저장은 안 됨 — 둘 다 REST API 직접 호출보다 제약이 많음.
- 컴포넌트(버튼/인풋/체크박스 등) 비교 시 주의: Components 캔버스의 **추상 컴포넌트 정의**에 있는 배경색 등은 실제로 배치된 인스턴스에서 `visible:false`로 꺼져있는 placeholder일 수 있음(예: PROJECT의 `btn/large` 컴포넌트 정의는 회색 배경이 있지만 실제 인스턴스는 그 fill이 꺼져있어서 투명이 맞음). **항상 실제 페이지에 배치된 인스턴스를 raw JSON에서 직접 찾아 그 값(fills/cornerRadius/padding)을 써야 하고, 추상 컴포넌트 스와치만 보고 판단하면 안 됨.**
- `.txt` 요약 파일은 `visible:false` 숨김 노드도 같이 추출하므로, 의심되는 텍스트는 raw JSON에서 `visible` 플래그를 직접 확인해야 함.