iCignal 설치 가이드
iCignal 제품 전용 디자인 시스템 패키지를 설치하는 방법을 안내합니다.
개요
@vortex/ui-icignal은 iCignal 제품군을 위한 전용 디자인 시스템입니다.
특징
- iCignal 브랜드 컬러: iCignal 전용 색상 팔레트
- 전용 컴포넌트: iCignal에 최적화된 UI 컴포넌트
- Tailwind Preset: iCignal 디자인 토큰이 적용된 Tailwind 설정
- Foundation 확장: @vortex/ui-foundation을 기반으로 확장
필수 요구사항
- Node.js: 20 이상
- 패키지 매니저: pnpm 9+ (권장)
- @vortex/ui-foundation: iCignal은 Foundation 패키지를 의존성으로 사용
설치 단계
1. Private Registry 설정
# .npmrc 파일 생성
echo "registry=http://repo.calsplatz.com:4873" > .npmrc2. 패키지 설치
Foundation과 iCignal 패키지를 함께 설치합니다:
# pnpm (권장)
pnpm add @vortex/ui-foundation @vortex/ui-icignal
# npm
npm install @vortex/ui-foundation @vortex/ui-icignal
# yarn
yarn add @vortex/ui-foundation @vortex/ui-icignalTailwind CSS 설정
iCignal Preset을 사용하여 Tailwind CSS를 설정합니다.
1. Tailwind CSS 설치
pnpm add -D tailwindcss@next @tailwindcss/postcss@next2. PostCSS 설정
export default {
plugins: {
"@tailwindcss/postcss": {},
},
};3. Tailwind 설정 (iCignal Preset 적용)
import type { Config } from "tailwindcss";
import icignalPreset from "@vortex/ui-icignal/tailwind-preset";
export default {
presets: [icignalPreset], // ← iCignal 디자인 토큰 적용
content: [
"./src/**/*.{js,ts,jsx,tsx,mdx}",
"./app/**/*.{js,ts,jsx,tsx,mdx}",
"./components/**/*.{js,ts,jsx,tsx,mdx}",
],
} satisfies Config;4. CSS 파일 설정
@import "tailwindcss";
@import "@vortex/ui-icignal/styles"; /* iCignal 전용 스타일 */TypeScript 설정
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["./src/*"]
}
}
}컴포넌트 사용
Foundation 컴포넌트 사용
import { Button } from "@vortex/ui-foundation";
export default function App() {
return <Button>Foundation Button</Button>;
}iCignal 전용 컴포넌트 사용
import { Button } from "@vortex/ui-foundation";
import { IcignalCard } from "@vortex/ui-icignal";
export default function App() {
return (
<IcignalCard>
<h2>iCignal Card</h2>
<Button>Click me</Button>
</IcignalCard>
);
}iCignal 디자인 토큰
iCignal Preset에는 다음 디자인 토큰이 포함됩니다:
브랜드 컬러
/* iCignal Primary Colors */
--color-icignal-primary: #...;
--color-icignal-secondary: #...;
--color-icignal-accent: #...;Tailwind 클래스 사용
<div className="bg-icignal-primary text-white">iCignal Primary Color</div>CLI로 빠르게 시작
Vortex CLI를 사용하면 iCignal 프로젝트를 빠르게 생성할 수 있습니다:
npx @vortex/cli init my-icignal-app --template vite --theme icignal
cd my-icignal-app
pnpm dev이 명령은 다음을 자동으로 설정합니다:
- ✅ React 19 + Vite 7 + TypeScript 5
- ✅ Tailwind CSS 4.0 + iCignal Preset
- ✅ @vortex/ui-foundation + @vortex/ui-icignal
- ✅ iCignal 디자인 토큰 적용
- ✅ TypeScript path aliases
패키지 구조
@vortex/ui-icignal/
├─ components/ # iCignal 전용 컴포넌트
├─ tokens/ # 디자인 토큰
├─ tailwind-preset/ # Tailwind 설정
└─ styles/ # 글로벌 스타일Foundation과의 차이점
| 항목 | Foundation | iCignal |
|---|---|---|
| 용도 | 모든 제품의 기본 | iCignal 제품 전용 |
| 색상 | 기본 팔레트 | iCignal 브랜드 컬러 |
| 컴포넌트 | 공통 컴포넌트 | iCignal 특화 컴포넌트 |
| 설치 | 단독 설치 가능 | Foundation 의존성 필요 |
문제 해결
iCignal Preset이 적용되지 않음
증상: iCignal 색상이 표시되지 않음
해결:
// tailwind.config.ts 확인
import icignalPreset from "@vortex/ui-icignal/tailwind-preset";
export default {
presets: [icignalPreset], // ← 이 줄 확인
content: ["./src/**/*.{js,ts,jsx,tsx,mdx}"],
};스타일이 적용되지 않음
증상: 컴포넌트가 스타일 없이 표시됨
해결:
/* globals.css 확인 */
@import "tailwindcss";
@import "@vortex/ui-icignal/styles"; /* ← 이 줄 확인 */다음 단계
Last updated on