Skip to content
Docs
가이드로 돌아가기

설정

배우기

hua.config.ts 파일의 모든 설정 옵션 상세 가이드

최소 설정

대부분의 옵션은 합리적인 기본값을 가지고 있어 최소한의 설정만으로 시작할 수 있습니다.

typescript
// Minimal configuration
import { defineConfig } from "@hua-labs/hua/framework";

export default defineConfig({
  branding: {
    name: "My App",
  },
});

전체 설정 예시

typescript
// hua.config.ts
import { defineConfig } from "@hua-labs/hua/framework";

export default defineConfig({
  // Branding
  branding: {
    name: "My App",
    primaryColor: "#6366f1",
    logo: "/logo.svg",
  },

  // Internationalization
  i18n: {
    defaultLanguage: "en",
    supportedLanguages: ["en", "ko", "ja"],
    translationsPath: "/api/translations",
  },

  // Motion/Animation
  motion: {
    reducedMotion: "user",
    defaultDuration: 300,
    defaultEasing: "ease-out",
  },

  // Theme
  theme: {
    defaultTheme: "system",
    storageKey: "my-app-theme",
  },

  // Plugins (Pro)
  plugins: [
    // Advanced UI exports such as @hua-labs/ui/advanced
  ],
});

브랜딩 옵션

옵션타입기본값설명
namestring"App"브랜딩에 사용되는 애플리케이션 이름
primaryColorstring"#6366f1"주 브랜드 색상 (hex)
logostring | ReactNodeundefined로고 이미지 경로 또는 컴포넌트

다국어(i18n) 옵션

옵션타입기본값설명
defaultLanguagestring"en"기본 언어 코드
supportedLanguagesstring[]["en"]지원되는 언어 코드 목록
translationsPathstring"/api/translations"번역 데이터를 가져오는 API 경로

모션 옵션

옵션타입기본값설명
reducedMotion"user" | "always" | "never""user"감소된 모션 선호도 처리 방식
defaultDurationnumber300기본 애니메이션 지속 시간 (ms)
defaultEasingstring"ease-out"기본 이징 함수

접근성 고려사항

"user" 모드는 사용자의 시스템 설정(prefers-reduced-motion)을 존중합니다. 접근성을 위해 이 설정을 권장합니다.

환경 변수

설정 값은 환경 변수로도 오버라이드할 수 있습니다:

bash
# .env.local
HUA_DEFAULT_LANGUAGE=ko
HUA_PRIMARY_COLOR=#10b981
HUA_REDUCED_MOTION=always