Figma 변수란?

Figma 변수는 색상, 숫자, 문자열, 불리언 값을 Figma 파일 안에 저장하는 이름 붙은 값이며 라이트와 다크 같은 모드를 지원합니다. Figma에서 디자인 토큰에 해당하는 기본 기능이지만, Figma REST API로 읽으려면 Enterprise 플랜이 필요합니다.

무엇을 하는가

변수를 쓰면 Figma 파일이 날값을 반복하는 대신 이름 붙은 값을 담을 수 있습니다. 색상·숫자·문자열·불리언 네 가지 타입을 지원합니다.

컬렉션으로 묶을 수 있고, 각 컬렉션은 모드를 가질 수 있습니다. 라이트와 다크가 가장 흔하지만 밀도, 브랜드, 플랫폼도 쓰입니다. 변수에 연결된 레이어는 모드가 바뀔 때 함께 갱신되며, 덕분에 Figma 안에서의 테마 전환이 제대로 작동합니다.

변수는 다른 변수의 별칭이 될 수도 있고, 이렇게 시맨틱 층을 만듭니다. text/danger가 red/600을 가리키는 식입니다.

어디가 어려운가

변수는 Figma 안의 문제를 해결합니다. 바깥의 문제는 그대로 남아 있고, 팀이 놀라는 지점이 여기입니다.

Figma REST API로 변수를 읽으려면 Enterprise 플랜이 필요합니다. 엔드포인트 자체는 있고, Professional과 Organization 플랜에서는 403을 돌려줍니다.

이는 도구를 평가할 때 무시할 수 없는 결과를 낳습니다. Figma 토큰 동기화를 REST API로 하겠다는 것은 무엇이든 Enterprise 계정에서는 작동하고 대부분의 팀이 쓰는 플랜에서는 말 그대로 아무것도 하지 않습니다. 구매 전에 직접 물어볼 가치가 있습니다. 보통 마케팅 자료에는 나오지 않기 때문입니다.

플러그인은 영향을 받지 않습니다. 플러그인 API는 파일 안쪽에서 변수를 읽고, 플러그인은 어떤 플랜에서도 실행됩니다. 전송 수단이 플러그인인 도구는 여러분의 Figma 등급과 무관하게 작동합니다.

변수와 디자인 토큰

Figma 변수는 디자인 토큰의 한 형태이며, 적용 범위가 Figma로 한정됩니다. 그 자체로는 이식되지 않습니다. CSS로도, Tailwind로도, W3C 토큰 JSON 형식으로도 내장 내보내기가 없습니다.

그 간극을 메우는 것이 바로 토큰 도구의 역할입니다. 선택은 어디서나 작동하는 플러그인이냐, 그렇지 않은 REST API냐입니다.

Flash DS와의 관계

Flash DS가 바로 이 이유로 Figma 플러그인을 전송 수단으로 씁니다. 어떤 Figma 플랜에서도 변수를 읽고, 게시를 검토 가능한 토큰 diff로 바꾸며, CSS·Tailwind·Tokens Studio JSON·GitHub 풀 리퀘스트로 내보냅니다.