diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index b7a7c68..4754f91 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -27,7 +27,7 @@ jobs: - name: Setup Node.js uses: actions/setup-node@v4 with: - node-version: '20' + node-version-file: '.nvmrc' cache: 'pnpm' - name: Install dependencies diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index ad45555..fc8fee7 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -21,7 +21,7 @@ jobs: - name: Setup Node.js uses: actions/setup-node@v4 with: - node-version: '20' + node-version-file: '.nvmrc' cache: 'pnpm' - name: Install dependencies diff --git a/.nvmrc b/.nvmrc index 2edeafb..76be14d 100644 --- a/.nvmrc +++ b/.nvmrc @@ -1 +1 @@ -20 \ No newline at end of file +20.20.0 \ No newline at end of file diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md deleted file mode 100644 index 4750709..0000000 --- a/docs/DEVELOPMENT.md +++ /dev/null @@ -1,153 +0,0 @@ -# ๐Ÿ› ๏ธ Development Guide - -์ด ๋ฌธ์„œ๋Š” **dokdok ํ”„๋กœ์ ํŠธ๋ฅผ ์ฒ˜์Œ ์‹คํ–‰ํ•˜๋Š” ๊ฐœ๋ฐœ์ž**๋ฅผ ์œ„ํ•œ ๊ฐ€์ด๋“œ์ž…๋‹ˆ๋‹ค. -์šด์˜์ฒด์ œ(macOS / Windows)์— ๋”ฐ๋ผ **Node ์„ค์น˜ ๋ฐฉ๋ฒ•๋งŒ ๋‹ค๋ฅด๋ฉฐ**, -๊ทธ ์™ธ ์„ค์ •๊ณผ ์‹คํ–‰ ๋ฐฉ๋ฒ•์€ ๋™์ผํ•ฉ๋‹ˆ๋‹ค. - ---- - -## โœ… ํ•„์ˆ˜ ํ™˜๊ฒฝ ์š”์•ฝ (์ค‘์š”) - -- **Node.js**: `>=20.19.0 <21` -- **ํŒจํ‚ค์ง€ ๋งค๋‹ˆ์ €**: `pnpm` - - โŒ ์ง์ ‘ ์„ค์น˜ํ•˜์ง€ ์•Š์Œ - - โœ… **Corepack์ด ์ž๋™์œผ๋กœ ๊ด€๋ฆฌ** -- **pnpm ๋ฒ„์ „**: ํ”„๋กœ์ ํŠธ์— ๊ณ ์ •๋จ (`package.json`์˜ `packageManager` ์ฐธ๊ณ ) - -> Node ๋˜๋Š” pnpm ๋ฒ„์ „์ด ๋งž์ง€ ์•Š์œผ๋ฉด ์˜์กด์„ฑ ์„ค์น˜ ๋‹จ๊ณ„์—์„œ ์˜ค๋ฅ˜๊ฐ€ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. - ---- - -## 1๏ธโƒฃ ์ €์žฅ์†Œ ํด๋ก  - -```bash -git clone -cd -``` - ---- - -## 2๏ธโƒฃ Node.js ์„ค์น˜ (์šด์˜์ฒด์ œ๋ณ„) - -### ๐ŸŸข macOS / Linux ์‚ฌ์šฉ์ž - -#### โ‘  nvm ์„ค์น˜ (์ด๋ฏธ ์„ค์น˜๋˜์–ด ์žˆ๋‹ค๋ฉด ์ƒ๋žต) - -https://github.com/nvm-sh/nvm - -#### โ‘ก Node 20 ์„ค์น˜ ๋ฐ ์‚ฌ์šฉ - -```bash -nvm install 20 -nvm use -node -v -``` - -โœ… ์ถœ๋ ฅ ๊ฒฐ๊ณผ๊ฐ€ **v20.19.0 ์ด์ƒ**์ด๋ฉด ์ •์ƒ์ž…๋‹ˆ๋‹ค. - ---- - -### ๐ŸŸฆ Windows ์‚ฌ์šฉ์ž (์ค‘์š” โš ๏ธ) - -> Windows์—์„œ๋Š” ์ผ๋ฐ˜ nvm์ด ์•„๋‹Œ **`nvm-windows`**๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. - -#### โ‘  nvm-windows ์„ค์น˜ - -์•„๋ž˜ ๋งํฌ์—์„œ **Installer**๋ฅผ ๋‹ค์šด๋กœ๋“œํ•˜์—ฌ ์„ค์น˜ํ•˜์„ธ์š”. -https://github.com/coreybutler/nvm-windows - -- ์„ค์น˜ ์ค‘ _โ€œUse nvm for managing Node.js versionsโ€_ ์„ ํƒ -- ์„ค์น˜ ํ›„ **ํ„ฐ๋ฏธ๋„์„ ๋ฐ˜๋“œ์‹œ ์ƒˆ๋กœ ์—ด์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค** - -#### โ‘ก Node 20.19 ์ด์ƒ ์„ค์น˜ ๋ฐ ์‚ฌ์šฉ - -PowerShell ๋˜๋Š” CMD์—์„œ ์‹คํ–‰: - -```powershell -nvm install 20 -nvm use 20 -node -v -``` - -โœ… ์ถœ๋ ฅ ๊ฒฐ๊ณผ๊ฐ€ **v20.19.0 ์ด์ƒ**์ด๋ฉด ์ •์ƒ์ž…๋‹ˆ๋‹ค. - ---- - -## 3๏ธโƒฃ Corepack ํ™œ์„ฑํ™” (ํ•„์ˆ˜) - -dokdok์€ **Corepack์„ ์‚ฌ์šฉํ•ด pnpm ๋ฒ„์ „์„ ํ”„๋กœ์ ํŠธ ๋‹จ์œ„๋กœ ๊ณ ์ •**ํ•ฉ๋‹ˆ๋‹ค. - -```bash -corepack enable -``` - -- ํ•œ ๋ฒˆ๋งŒ ์‹คํ–‰ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค. -- macOS / Windows ๋™์ผํ•ฉ๋‹ˆ๋‹ค. - ---- - -## โš ๏ธ Corepack ์˜ค๋ฅ˜๊ฐ€ ๋ฐœ์ƒํ•  ๊ฒฝ์šฐ (์ค‘์š”) - -์•„๋ž˜์™€ ๊ฐ™์€ ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค: - -``` -Internal Error: Cannot find matching keyid -``` - -์ด๋Š” **Node์— ํฌํ•จ๋œ Corepack์ด ์˜ค๋ž˜๋œ ๊ฒฝ์šฐ** ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. - -### ํ•ด๊ฒฐ ๋ฐฉ๋ฒ• (macOS / Windows ๋™์ผ) - -```bash -npm install --global corepack@latest -corepack enable -``` - -> ์ด ๋ช…๋ น์€ **pnpm์„ ์ „์—ญ ์„ค์น˜ํ•˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ**, -> Node ๊ณต์‹ ๋„๊ตฌ์ธ Corepack์„ ์ตœ์‹ ์œผ๋กœ ์—…๋ฐ์ดํŠธํ•˜๋Š” ์ž‘์—…์ž…๋‹ˆ๋‹ค. - ---- - -## 4๏ธโƒฃ pnpm ๋ฒ„์ „ ๊ด€๋ฆฌ ๋ฐฉ์‹ - -ํ”„๋กœ์ ํŠธ๋Š” `package.json`์˜ `packageManager` ํ•„๋“œ๋ฅผ ํ†ตํ•ด -pnpm ๋ฒ„์ „์„ ๊ณ ์ •ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. - -``` -"packageManager": "pnpm@10.28.0" -``` - -๋ณ„๋„ ์„ค์ • ์—†์ด `corepack enable` ์ดํ›„ -`pnpm install`๋งŒ ์‹คํ–‰ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค. - ---- - -## 5๏ธโƒฃ ์˜์กด์„ฑ ์„ค์น˜ - -```bash -pnpm install -``` - -- Node ๋ฒ„์ „์ด ๋งž์ง€ ์•Š์œผ๋ฉด ์„ค์น˜๊ฐ€ ์ฐจ๋‹จ๋ฉ๋‹ˆ๋‹ค (์ •์ƒ ๋™์ž‘). - ---- - -## 6๏ธโƒฃ ๊ฐœ๋ฐœ ์„œ๋ฒ„ ์‹คํ–‰ - -```bash -pnpm dev -``` - ---- - -## โœ… ํ•œ ์ค„ ์š”์•ฝ - -> **Node 20.19+ ์„ค์น˜ โ†’ `corepack enable` โ†’ `pnpm install` โ†’ `pnpm dev`** - ---- - -## โ„น๏ธ ์ฐธ๊ณ  ์‚ฌํ•ญ - -- ๋ณธ ํ”„๋กœ์ ํŠธ๋Š” `package.json`์˜ `engines`์™€ `packageManager` ์„ค์ •์„ ํ†ตํ•ด - Node ๋ฐ pnpm ์‚ฌ์šฉ ๋ฒ„์ „์„ ์ผ๊ด€๋˜๊ฒŒ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. -- ์ด๋Š” ํŒ€์› ๊ฐ„ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์ฐจ์ด๋กœ ์ธํ•œ ์˜ค๋ฅ˜๋ฅผ ์ค„์ด๊ธฐ ์œ„ํ•œ ์ •์ฑ…์ž…๋‹ˆ๋‹ค. diff --git a/package.json b/package.json index bdc1570..c783cb8 100644 --- a/package.json +++ b/package.json @@ -13,7 +13,7 @@ "preview": "vite preview" }, "engines": { - "node": ">=20.19 <21" + "node": ">=20.20.0 <21" }, "devDependencies": { "@commitlint/cli": "^20.3.1",