Vanilla Extract
Lynx에서 Vanilla Extract로 정적 CSS를 생성하고 SEED 토큰을 사용하는 방법을 안내합니다.
Vanilla Extract는 TypeScript로 작성한 스타일을 빌드 시 CSS로 추출해요.
.css.ts에서 스타일을 정의하고, 생성된 클래스 이름을 Lynx 네이티브 엘리먼트의 className에 적용하세요.
정적인 스타일을 렌더링할 때마다 JavaScript에서 생성할 필요가 없어요.
요구사항과 설치
rspeedy-plugin-vanilla-extract는 Vanilla Extract의 webpack 플러그인에 Rspeedy 호환 처리를 추가해요.
이 가이드는 배포된 플러그인 0.2.0의 의존성 조건을 기준으로 해요.
| 패키지 | 조건 |
|---|---|
@rsbuild/core | 1.x |
webpack | 5.x |
| Rspeedy·ReactLynx 플러그인 | 위 Rsbuild 환경과 호환되는 버전 |
먼저 프로젝트에서 사용하는 Rspeedy의 Rsbuild 버전을 확인하세요. 플러그인 0.2.0의 peer dependency는 @rsbuild/core: ^1이에요.
Rsbuild 2 기반 프로젝트에 @rsbuild/core@1을 추가로 설치하는 것만으로 호환성이 확보되지는 않아요.
Rsbuild 2를 사용 중이라면 이를 지원하는 플러그인 버전을 확인하거나, Tailwind CSS 4 가이드를 참고하세요.
공통 SEED 패키지는 Installation에서 설치하고, 다음 의존성을 추가하세요.
Rspeedy 설정
기존 lynx.config.ts의 플러그인 목록에 pluginVanillaExtract({})를 추가하세요.
기존 ReactLynx 플러그인과 SEED feature flags 설정은 유지해요.
SEED CSS 불러오기
토큰의 TypeScript 참조를 import하는 것만으로 토큰 값이 선언되지는 않으므로 base.css도 반드시 불러오세요.
Lynx에서는 웹용 @seed-design/css 대신 @seed-design/lynx-css를 사용해요.
루트 <page>의 색상 모드 설정은 Theming을 참고하세요.
스타일과 SEED 토큰 사용하기
Last updated on