From 14161ba496136fb3bbb635ca50daccae774e2fe7 Mon Sep 17 00:00:00 2001 From: infra Date: Sun, 14 Jun 2026 23:52:04 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20VS=20Code=EB=A1=9C=20=ED=8F=B4=EB=8D=94?= =?UTF-8?q?=20=EC=97=AC=EB=8A=94=20=EB=B2=95=20+=20=ED=84=B0=EB=AF=B8?= =?UTF-8?q?=EB=84=90=20=EC=97=B4=EA=B8=B0=20+=20npm=20install=20=EA=B0=95?= =?UTF-8?q?=EC=A1=B0=20(=EC=B4=88=EB=B3=B4=EC=9A=A9)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- MANUAL.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/MANUAL.md b/MANUAL.md index 68bbaee..666975f 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -118,11 +118,27 @@ git clone https://gitea.bokdev.in//.git `~/projects/sample` 은 바로 돌려볼 수 있는 Node 예제이며 **읽기 전용 참조**입니다. 직접 고치지 말고, **`new-project` 명령으로 복사**해서 본인 프로젝트를 시작하세요. +**(1) 터미널 열기** — VS Code 상단 메뉴 **Terminal → New Terminal** (화면 아래쪽에 터미널 창이 뜹니다) + +**(2) 프로젝트 만들기** — 터미널에 입력: ```bash new-project myapp # sample 을 ~/projects/myapp 으로 복사 + .project-env(DB/S3) 자동생성 -cd ~/projects/myapp # 폴더에 들어오면 .project-env 가 자동 적용됨($DATABASE_URL 등 사용 가능) -npm install -npm run dev # http://localhost:3000 에서 실행 +``` +> `myapp` 은 예시입니다. 원하는 이름으로 바꿔도 됩니다. + +**(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` — 살아있는지