JS/react

Next.js 시작하기, Next.js 프로젝트 생성하기

isaac.kim 2023. 6. 16. 20:00
728x90
반응형

Next.js 시작하기, Next.js 프로젝트 생성하기

 

React 프레임워크 Next.js를 시작해 보자.

 

간단히 Next.js 프로젝트를 생성하는 방법에 대해 알아보자.

 

먼저 Next.js 공식 홈페이지로 접속한다.

https://nextjs.org/

 

Next.js by Vercel - The React Framework

Next.js Boilerplate A Next.js app and a Serverless Function API. Image Gallery Starter An image gallery built on Next.js and Cloudinary. Next.js Commerce An all-in-one starter kit for high-performance e-commerce sites.

nextjs.org

 

Next.js 공식 페이지에 들어가면 [Get Started], [Learn Next.js] 2개 의 버튼이 보인다.

나중에는 둘 다 들어가서 봐야겠지만, [Get Started]만 봐도 프로젝트 생성까지는 할 수 있다.

 

반응형

 

 

순서

1. next.js web-app 생성하기

2. 생성된 next-app 실행해 보기

3. 시작페이지 수정하기 : app/page.tsx & app/layout.tsx

4. Next.js Project Structure

 

 

* react나 Next 등 FE 프레임워크를 사용하기 위해선 사전에 node.js, npm 이 설치가 되어 있어야 한다.

 

 

 

1. next.js web-app 생성하기

npx create-next-app@latest

거의 모든 소프트웨어 설치를 진행할 때 default 값으로 설치하는 게 best practice 이므로 그대로 설치한다.

 

 

프로젝트를 생성했으면 IDE로 열어준다. (필자 Visual Studio Code 사용)

 

 

2. 생성된 next-app 실행해 보기

npm run dev

실행하고 다음 url로 접속한다.

http://localhost:3000

 

NEXT.JS 페이지가 뜬 것을 볼 수 있다.

프로젝트 디렉터리에서 app 폴더의 page.tsx를 수정하면 이 페이지를 수정할 수 있는 것으로 보인다.

 

프로그래밍 학습의 국룰 "Hello world"를 찍어보자.

 

 

3. 시작페이지 수정하기 : app/page.tsx & app/layout.tsx

메인 페이지에 Hello world를 띄워보자.

 

 

app/page.tsx 파일을 다음과 같이 수정한다.

좌: app/page.tsx Sourc code / 우: next-app 첫 메인 페이지

 

공식 문서에서 app/layout.tsx 도 수정하라고 한다.

해보자.

 

app/layout.tsx 수정하기

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  )
}

일단 이렇게 수정을 해두면 프로젝트 시작 설정이 된 것 같다.

 

다음은 public folder를 생성하라고 한다. (위치 : project root)

그런데 프로젝트 생성하면 자동으로 public 폴더가 생성되어 있다.

여기에는 이미지, 폰트 등 공개 파일을 보관한다.

 

 

4. Next.js Project Structure

Next.js 프로젝트 구조에 대해서 공부해 본다.

 

최상위 위치의 파일들 (프로젝트 Root의 파일들)

 

각 파일들의 설명을 확인할 수 있다.

 

Next.js

Ecosystem

최상위 위치의 폴더들

Routing Conventions에 대한 내용이 있는데,

framework라서 App Routing에 사용되는 파일이 정해져 있는 것 같다.

 

일단 웹에서 Routing은 중요하기 때문에 Routing에 대한 규칙은 확인한다.

 

추후 개발을 할 때 Routing Conventions을 참고하면 된다.

 

 

전체를 이해하고 공부하면 좋겠지만,

Next.js를 a부터 z까지를 학습하는 과정이 아니기 때문에 일부 내용은 생략한다.

 

 

간단하게 Next.js 프로젝트를 생성하고 실행하는 방법에 대해 알아보았다.

728x90
반응형