Skip to Content
Getting StartediCignal 설치 가이드

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" > .npmrc

2. 패키지 설치

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-icignal

Tailwind CSS 설정

iCignal Preset을 사용하여 Tailwind CSS를 설정합니다.

1. Tailwind CSS 설치

pnpm add -D tailwindcss@next @tailwindcss/postcss@next

2. 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과의 차이점

항목FoundationiCignal
용도모든 제품의 기본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