docs: VS Code로 폴더 여는 법 + 터미널 열기 + npm install 강조 (초보용)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
infra
2026-06-14 23:52:04 +09:00
parent 3c93c7240e
commit 14161ba496

View File

@@ -118,11 +118,27 @@ git clone https://gitea.bokdev.in/<org>/<repo>.git
`~/projects/sample` 은 바로 돌려볼 수 있는 Node 예제이며 **읽기 전용 참조**입니다. `~/projects/sample` 은 바로 돌려볼 수 있는 Node 예제이며 **읽기 전용 참조**입니다.
직접 고치지 말고, **`new-project` 명령으로 복사**해서 본인 프로젝트를 시작하세요. 직접 고치지 말고, **`new-project` 명령으로 복사**해서 본인 프로젝트를 시작하세요.
**(1) 터미널 열기** — VS Code 상단 메뉴 **Terminal → New Terminal** (화면 아래쪽에 터미널 창이 뜹니다)
**(2) 프로젝트 만들기** — 터미널에 입력:
```bash ```bash
new-project myapp # sample 을 ~/projects/myapp 으로 복사 + .project-env(DB/S3) 자동생성 new-project myapp # sample 을 ~/projects/myapp 으로 복사 + .project-env(DB/S3) 자동생성
cd ~/projects/myapp # 폴더에 들어오면 .project-env 가 자동 적용됨($DATABASE_URL 등 사용 가능) ```
npm install > `myapp` 은 예시입니다. 원하는 이름으로 바꿔도 됩니다.
npm run dev # http://localhost:3000 에서 실행
**(3) VS Code 로 그 폴더 열기** — 만든 폴더를 편집기에 띄웁니다(왼쪽 파일 목록에 보이게):
- 상단 메뉴 **File → Open Folder…**
- 경로 입력칸에 **`/home/coder/projects/myapp`** 입력 → **OK**
- (또는 왼쪽 맨 위 📁 **Explorer** 아이콘 → **Open Folder** 버튼)
- 창이 새로고침되며 왼쪽에 `myapp` 의 파일들이 보이면 성공입니다.
> 폴더를 열면 VS Code 가 그 폴더를 "작업 공간"으로 삼습니다. 이제 왼쪽 목록에서 파일을 눌러 편집하고,
> 터미널도 자동으로 그 폴더(`~/projects/myapp`)에서 시작됩니다.
**(4) 실행** — 다시 터미널(Terminal → New Terminal)에서:
```bash
npm install # 처음 1회: 필요한 라이브러리 설치 (이걸 안 하면 실행이 실패합니다)
npm run dev # 앱 실행 (미리보기는 7-2 참고)
``` ```
동작 확인 엔드포인트: 동작 확인 엔드포인트:
- `GET /healthz` — 살아있는지 - `GET /healthz` — 살아있는지