Skip to content

Contributing

Jump to bottom Edit New page
hyoseong edited this page Feb 22, 2026 · 30 revisions

ν”„λ‘œμ νŠΈ μ„€μ •

이 ν”„λ‘œμ νŠΈμ— 관심을 κ°€μ Έμ£Όμ…”μ„œ κ°μ‚¬ν•©λ‹ˆλ‹€. κΈ°μ—¬λŠ” μ–Έμ œλ‚˜ ν™˜μ˜μž…λ‹ˆλ‹€! πŸŽ‰

λ³Έ ν”„λ‘œμ νŠΈλŠ” GitHub의 ν’€ λ¦¬ν€˜μŠ€νŠΈ(PR) 기반으둜 κΈ°μ—¬λ₯Ό κ΄€λ¦¬ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€.
λ¨Όμ € ν”„λ‘œμ νŠΈλ₯Ό ν¬ν¬ν•˜κ³  PR을 λ³΄λ‚΄λŠ” 방법을 μ°Έκ³ ν•΄ μ£Όμ„Έμš”.

둜컬 μ‹€ν–‰ ν™˜κ²½ μ„€μ •

  1. Bun μ„€μΉ˜ν•˜κΈ°
  2. ν”„λ‘œμ νŠΈλ₯Ό ν¬ν¬ν•˜κ³  PR을 λ³΄λ‚΄λŠ” 방법을 μ°Έκ³ ν•΄μ„œ 리포지토리λ₯Ό μžμ‹ μ˜ 계정에 ν¬ν¬ν•˜κ³ , ν΄λ‘ ν•©λ‹ˆλ‹€.
    1. 이 λ•Œ ν΄λ‘ ν•œ 리포지토리λ₯Ό μ—…μŠ€νŠΈλ¦Ό 리포지토리와 λ™κΈ°ν™”ν•˜λŠ” 섀정을 ν•¨κ»˜ μ μš©ν•˜λ©΄ 기여에 μš©μ΄ν•©λ‹ˆλ‹€.
  3. ν„°λ―Έλ„μ—μ„œ μ•„λž˜ λͺ…λ Ήμ–΄λ₯Ό μ‹€ν–‰ν•©λ‹ˆλ‹€:
cd path/to/daleui
#  μ˜μ‘΄μ„± μ„€μΉ˜
bun install

# Storybook μ‹€ν–‰ (λ””μžμΈ μ‹œμŠ€ν…œ κΈ°μ—¬ μ‹œ)
bun run sb # or bun run storybook

# λ§ˆμΌ€νŒ… μ›Ήμ‚¬μ΄νŠΈ μ‹€ν–‰ (λ§ˆμΌ€νŒ… μ›Ήμ‚¬μ΄νŠΈ κΈ°μ—¬ μ‹œ)
bun run dev

기술 μŠ€νƒ

μ½”λ“œ μž‘μ„± 및 κ²€ν† 

  • μ»΄ν¬λ„ŒνŠΈ 섀계와 κ΅¬ν˜„μ€ κ΅¬λΆ„ν•΄μ„œ Pull Requestλ₯Ό μ œμΆœν•©λ‹ˆλ‹€. λ°”λžŒμ§ν•œ μ»΄ν¬λ„ŒνŠΈ API에 λŒ€ν•œ 사전 ν•©μ˜λ₯Ό μ§„ν–‰ν•¨μœΌλ‘œμ¨ μ—‰λš±ν•œ κ΅¬ν˜„μ„ λ°©μ§€ν•˜κΈ° μœ„ν•¨μž…λ‹ˆλ‹€.
  • PR 병합을 ν•˜κΈ° μœ„ν•΄μ„œλŠ” μ΅œμ†Œ 1λͺ…μ˜ λ™λ£Œ κ°œλ°œμžλ‘œλΆ€ν„° μŠΉμΈμ„ λ°›μ•„μ•Ό ν•˜μ§€λ§Œ, ν’ˆμ§ˆ ν–₯상을 μœ„ν•΄μ„œ κΈ΄κΈ‰ 건이 μ•„λ‹ˆλΌλ©΄ 2개의 μŠΉμΈμ„ λ°›λŠ” 것이 ꢌμž₯λ©λ‹ˆλ‹€.
  • [Proposed] "Resolve conversation" λ²„νŠΌμ€ μ½”λ“œ κ²€ν† μžκ°€ ν”Όλ“œλ°±μ΄ 본인이 μ˜λ„ν•œ λŒ€λ‘œ μ‘°μΉ˜λ˜μ—ˆλŠ”μ§€ ν™•μΈν•˜λŠ” μ°¨μ›μ—μ„œ λˆ„λ¦…λ‹ˆλ‹€. μ½”λ“œ μž‘μ„±μžκ°€ μž„μ˜λ‘œ Resolved ν‘œμ‹œν•  μ‹œ λΆˆν•„μš”ν•œ μ˜€ν•΄κ°€ 생길 수 μžˆμŠ΅λ‹ˆλ‹€.

μ˜μ‘΄μ„±

  • 항상 μ˜μ‘΄μ„±μ„ μ΅œμ‹  μƒνƒœλ‘œ μœ μ§€ν•˜κΈ° μœ„ν•΄μ„œ Dependabot을 μ½”λ“œ μ €μž₯μ†Œμ— μ„€μ •ν•΄λ†“μ•˜μŠ΅λ‹ˆλ‹€.
  • Dependabot이 올린 PR을 λŠ¦μ§€ μ•Šκ²Œ κ²€ν†  및 λ³‘ν•©ν•˜κ³  μƒˆλ‘œμš΄ 버전이 μΌμœΌν‚€λŠ” breaking changesλ₯Ό λŒ€μ‘ν•˜λŠ” μž‘μ—…μ€ νŒ€ 개발자 λͺ¨λ‘μ˜ 곡동 μ±…μž„μž…λ‹ˆλ‹€.
  • Dependabot이 올린 PR을 λ°˜λ“œμ‹œ PR μ½”λ©˜νŠΈλ₯Ό ν†΅ν•΄μ„œ Dependabotμ—κ²Œ μ›ν•˜μ‹œλŠ” μž‘μ—…μ„ μ‹œμΌœμ£Όμ„Έμš”. 직접 μˆ˜μ •ν•˜μ‹œλ©΄ Dependabot은 ν•΄λ‹Ή PR을 더 이상 μžλ™μœΌλ‘œ 관리해주지 μ•ŠμŠ΅λ‹ˆλ‹€.

ν’ˆμ§ˆ 검사

main λΈŒλžœμΉ˜μ— ν’ˆμ§ˆ 기쀀에 λ―Έλ‹¬ν•˜λŠ” μ½”λ“œκ°€ μœ μž…μ΄ λ˜μ§€ μ•Šλ„λ‘ PR을 μ˜¬λ¦¬μ‹œλ©΄ μžλ™μœΌλ‘œ ν’ˆμ§ˆ 검사가 μ§„ν–‰λ˜κ³  μ‹€νŒ¨ν•  경우 병합이 λΆˆκ°€λŠ₯ν•©λ‹ˆλ‹€. 각 ν’ˆμ§ˆ κ²€μ‚¬λŠ” κ°œλ°œμžκ°€ 둜컬 ν™˜κ²½μ—μ„œ 직접 μ§„ν–‰ν•˜μ‹€ μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€.

Formatting

Prettierλ₯Ό ν†΅ν•΄μ„œ 일관적인 μ½”λ“œ ν¬λ©§νŒ…μ„ μœ μ§€ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. VSCode μ‚¬μš©μž 뢄듀은 Prettier μ΅μŠ€ν…μ…˜μ„ μ“°μ‹œλ©΄ μ½”λ“œλ₯Ό μž‘μ„±ν•˜λ©΄μ„œ μžλ™μœΌλ‘œ μ½”λ“œλ₯Ό ν¬λ©§νŒ…ν•  수 μžˆμ–΄μ„œ νŽΈν•˜λ‹ˆ μΆ”μ²œλ“œλ¦½λ‹ˆλ‹€.

Prettier options λŠ” κΈ°λ³Έ μ„€μ •κ°’μœΌλ‘œ ν•΄μ£Όμ‹œκΈΈ λ°”λžλ‹ˆλ‹€.

Linting

ESLintλ₯Ό ν†΅ν•΄μ„œ 잠재적인 문제λ₯Ό λ°œκ²¬ν•˜κ³  λͺ¨λ²” 사둀λ₯Ό λ”°λ₯΄κ³  μžˆμŠ΅λ‹ˆλ‹€. λ¦°νŒ… κ·œμΉ™μ„ μœ„λ°˜ν•˜κ³  μžˆλŠ” μ½”λ“œκ°€ μžˆλŠ”μ§€ ν™•μΈν•˜λ €λ©΄ λ‹€μŒ λͺ…λ Ήμ–΄λ₯Ό μ‹€ν–‰ν•©λ‹ˆλ‹€.

$ bun run lint

Type Checking

TypeScirptλ₯Ό ν†΅ν•΄μ„œ 정적 νƒ€μž… 검사λ₯Ό ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. νƒ€μž… 였λ₯˜κ°€ μžˆλŠ”μ§€ ν™•μΈν•˜λ €λ©΄ λ‹€μŒ λͺ…λ Ήμ–΄λ₯Ό μ‹€ν–‰ν•©λ‹ˆλ‹€.

$ bunx tsc

npm νŒ¨ν‚€μ§€ 배포 κ³Όμ •

flowchart TD
  MAIN[main 브랜치]
  RELEASE_PR["버전 bump &<br/>Release PR 생성<br/>(GitHub Action)"]
  TAG["νƒœκ·Έ 생성 &<br/>GitHub Release Draft 생성<br/>(GitHub Action)"]
  PUBLISH["npm publish μ‹€ν–‰<br/>(GitHub Action)"]

  MAIN -->|"GitHub UIμ—μ„œ<br/>Release PR μ‹€ν–‰<br/>(개발자)"| RELEASE_PR
  RELEASE_PR -->|"Release PR 리뷰 & 머지<br/>(개발자)"| TAG
  TAG -->|"GitHub Release λ°œν–‰<br/>(개발자)"| PUBLISH
Loading
Add a custom footer
Add a custom sidebar

Clone this wiki locally