@yadoran-2025/booong-design-system
v2.1.0
Published
BOOONG shared design tokens, base styles, and legacy-compatible UI components. v2.0 — Atomic/Semantic 2-layer tokens, projector-optimized contrast, component states.
Readme
BOOONG Design System
Shared BOOONG design tokens, base styles, and legacy-compatible UI components.
Version 2 adds Atomic/Semantic color tokens, projector-friendly text contrast, motion tokens, and new feedback/state components while preserving legacy aliases.
Install
내 프로젝트에 적용하는 법
BOOONG 디자인시스템을 쓰고 싶은 프로젝트에서는 먼저 패키지를 설치하세요.
npm install @yadoran-2025/booong-design-systemReact, Vite, Next.js 같은 npm 기반 프로젝트라면 앱의 전역 진입 파일에서 CSS를 한 번만 import하면 됩니다.
import "@yadoran-2025/booong-design-system/dist/booong.css";정적 HTML 프로젝트라면 <head> 안에 아래 CSS 링크를 추가하면 됩니다.
<link rel="stylesheet" href="https://yadoran-2025.github.io/booong-design-system/releases/v2.0.0/booong.css">그 다음 프로젝트 CSS에서는 BOOONG 토큰과 컴포넌트 클래스를 그대로 사용하세요. 예를 들어 색상은 --brand, --color-primary, --text-muted 같은 변수를 쓰고, 버튼은 .btn .btn--primary, 입력 필드는 .field, .field__input 같은 클래스를 붙이면 됩니다.
프로젝트마다 필요한 레이아웃이나 화면별 스타일은 별도 CSS 파일에 작성하되, 브랜드 색상, 폰트, spacing scale, radius 같은 디자인시스템 값은 다시 정의하지 않는 것을 권장합니다.
Local Build
npm run buildThe build writes:
dist/booong.cssfor npm consumersdocs/releases/v2.0.0/booong.cssfor GitHub Pages consumers
Compatibility
Version 2 changes some visual defaults (--text-muted, heading hierarchy, strong color, and spacing values), but keeps legacy token names such as --brand, --text, and --case-bg as aliases for existing projects.
