시작하기

Bricksmith CLI 설치 및 첫 프로젝트 생성 가이드

시작하기#

설치#

# 로컬 경로에서 활성화
dart pub global activate --source path .

# 설치 확인
bricksmith --version

첫 프로젝트 생성#

Interactive 모드 (권장)#

bricksmith create --type monorepo

프롬프트에 따라 프로젝트 정보를 입력하고, feature 브릭을 선택합니다.

Non-interactive 모드#

bricksmith create --type monorepo --no-interactive \
  --name my_app \
  --organization MyOrg \
  --features home,community,notification,payment \
  --backend serverpod

Feature 적용#

기존 프로젝트에 feature를 추가할 수 있습니다:

# community feature 추가 (frontend + backend)
bricksmith apply --feature community

# entity 이름 커스터마이징
bricksmith apply --feature community \
  --primary-entity Article \
  --secondary-entity Reply

# backend 없이 frontend만
bricksmith apply --feature community --no-backend

Console Feature 적용#

관리자 콘솔 feature를 추가할 수 있습니다:

# console feature 추가
bricksmith apply --feature console_dashboard

# 복수 console feature 동시 적용
bricksmith apply --features console_dashboard,console_user_management,console_sales_analysis

Entity 커스터마이징#

primary_entity와 secondary_entity를 지정하면 모든 파일명, 클래스명, 변수명이 자동 변환됩니다:

# 기본값: Post / Comment
bricksmith apply --feature community

# 커스텀: Article / Reply
bricksmith apply --feature community \
  --primary-entity Article \
  --secondary-entity Reply

# AI가 도메인에 맞게 자유롭게 지정 가능
bricksmith apply --feature store \
  --primary-entity Product \
  --secondary-entity ProductCategory

커스텀 bricks 경로#

기본 bricks/ 외 다른 경로에서 브릭을 참조할 수 있습니다:

bricksmith apply --feature community --bricks-dir /path/to/custom/bricks

설정 저장 및 재사용#

# 설정 저장
bricksmith create --type monorepo --save-config

# 저장된 설정 목록
bricksmith create-from-config --list

# 설정으로 생성
bricksmith create-from-config --config my_app