프로젝트 생성
기획이 끝났으니 이제 실제 프로젝트를 만들어 봅시다. 처음 하시는 분도 따라 하실 수 있도록 한 단계씩 안내합니다.
터미널 열기
Cursor를 실행하고 터미널을 엽니다. 기억나시죠?
- 상단 메뉴에서 Terminal → New Terminal
- 또는 단축키: Ctrl + ` (숫자 1 왼쪽의 키)
화면 아래쪽에 검은 창이 나타나면 준비 완료입니다.
프로젝트 만들기
터미널에 아래 명령어를 입력하고 Enter를 누릅니다:
npx create-next-app@latest my-cafe
my-cafe는 프로젝트 이름입니다. 본인의 가게에 맞게 바꿔도 됩니다. 예를 들어my-salon,my-bakery등. 단, 영어 소문자와 하이픈(-)만 사용하세요.
설정 질문에 답하기
명령어를 실행하면 몇 가지 질문이 나옵니다. 아래와 같이 답해 주세요:
| 질문 | 답변 | 설명 |
|---|---|---|
| Would you like to use TypeScript? | Yes | 타입이 있는 JavaScript. AI가 더 정확하게 코드를 씁니다 |
| Would you like to use ESLint? | Yes | 코드 실수를 자동으로 잡아주는 도구 |
| Would you like to use Tailwind CSS? | Yes | 앞에서 배운 스타일 도구 |
Would you like your code inside a src/ directory? |
Yes | 코드를 깔끔하게 정리합니다 |
| Would you like to use App Router? | Yes | 파일이 곧 페이지가 되는 최신 방식 |
| Would you like to use Turbopack? | Yes | 개발할 때 속도가 빨라집니다 |
| Would you like to customize the import alias? | No | 기본값으로 충분합니다 |
방향키로 Yes/No를 선택하고 Enter를 누르면 됩니다. 설치에 1~2분 정도 걸립니다.
프로젝트 열기
설치가 끝나면 Cursor에서 프로젝트를 열어봅시다:
- File → Open Folder 를 클릭합니다
- 방금 만든
my-cafe폴더를 찾아서 선택합니다 - "폴더 선택"을 클릭합니다
왼쪽에 파일 목록이 나타납니다.
폴더 구조 살펴보기
왼쪽 파일 목록에 여러 파일과 폴더가 보입니다. 전부 이해할 필요는 없습니다. 중요한 것만 알아두세요:
| 폴더/파일 | 역할 |
|---|---|
src/app/ |
여기에 페이지를 만듭니다 |
src/app/page.tsx |
메인 페이지 (홈) |
src/app/layout.tsx |
모든 페이지에 공통으로 적용되는 틀 |
public/ |
이미지 파일을 넣는 곳 |
package.json |
프로젝트 설정 정보 (건드릴 일 거의 없음) |
나머지 파일들은 신경 쓰지 않아도 됩니다. AI가 필요할 때 알아서 수정합니다.
실행해 보기
프로젝트가 잘 만들어졌는지 확인해 봅시다. 터미널에 입력합니다:
npm run dev
잠시 후 이런 메시지가 나타납니다:
▲ Next.js 15.x.x
- Local: http://localhost:3000
Chrome에서 http://localhost:3000 에 접속하면 Next.js 기본 화면이 보입니다. 검은 배경에 "Next.js" 로고가 보이면 성공입니다!
localhost:3000은 "내 컴퓨터에서만 보이는 임시 주소"입니다. 다른 사람은 아직 볼 수 없습니다. 나중에 배포하면 전 세계 누구나 볼 수 있게 됩니다.
터미널에서 Ctrl + C를 누르면 서버가 종료됩니다. 다시 시작하려면 npm run dev를 입력하면 됩니다.
이 절의 요약
npx create-next-app@latest my-cafe명령어로 프로젝트를 만듭니다- TypeScript, Tailwind CSS, App Router를 Yes로 선택합니다
src/app/폴더에 페이지를 만들고,public/폴더에 이미지를 넣습니다npm run dev로 실행하고 localhost:3000에서 확인합니다- 다음 절에서 기본 화면을 우리 가게 메인 페이지로 바꿔봅니다