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` — 살아있는지