Copy & Run

React 시작하기: Vite로 프로젝트 만들고 첫 컴포넌트 작성하기

Vite로 React 프로젝트를 만들고 컴포넌트를 나눠 작성합니다. 개발 서버 대신 production 빌드를 만들고, 헤드리스 Chrome으로 화면에 실제 글자가 그려지는지 확인합니다.

실습 노트 · 2026-11-14 발행 · 5분 · 2026-11 확인

Vite는 React 프로젝트를 가장 적은 설정으로 만들어 주는 도구입니다. 이 글에서는 Vite 템플릿으로 프로젝트를 만들고, 컴포넌트를 두 개로 나눠 작성한 뒤 production 빌드가 통과하고 화면에 글자가 그려지는지 확인합니다.

준비물

항목 내용
Node.js v24.15.0
npm 11.12.1
Vite 8.3.8
React 19.3.1
확인용 브라우저 Playwright로 띄운 헤드리스 Chromium
예상 소요 시간 약 20분

1. 프로젝트 만들기

템플릿 옵션으로 React를 고르고 의존성을 설치합니다.

npm create vite@latest react-lab -- --template react --no-interactive
cd react-lab
npm install

설치가 끝나면 found 0 vulnerabilities가 출력됩니다. 생성된 package.json의 의존성은 다음과 같습니다.

dependencies: react ^19.3.1, react-dom ^19.3.1
devDependencies: vite ^8.3.6, @vitejs/plugin-react ^6.1.2, ...

2. 컴포넌트 두 개 작성하기

컴포넌트는 함수 하나가 화면의 한 덩어리를 그리는 단위입니다. 인사말을 그리는 Greeting을 따로 파일로 만듭니다.

src/components/Greeting.jsx

export default function Greeting({ name }) {
  return <h2>안녕하세요, {name}님</h2>;
}

name은 부모가 넘기는 값(props)입니다. 부모는 <Greeting name="copyandrun" />처럼 값을 바꿔 같은 컴포넌트를 여러 번 쓸 수 있습니다.

src/App.jsx

import Greeting from "./components/Greeting.jsx";

export default function App() {
  return (
    <main>
      <h1>첫 React 컴포넌트</h1>
      <Greeting name="copyandrun" />
    </main>
  );
}

3. 빌드하기

개발 서버 대신 배포용 파일을 만듭니다.

npm run build
✓ 17 modules transformed.
dist/index.html                   0.45 kB │ gzip:  0.29 kB
dist/assets/index-nqMpL4T3.css    1.78 kB │ gzip:  0.81 kB
dist/assets/index-1y5RAdxV.js   219.71 kB │ gzip: 68.72 kB
✓ built in 167ms

dist 폴더에 HTML 한 장과 JavaScript, CSS 파일이 생깁니다. 이 파일들을 정적 서버에 올리면 React 앱이 동작합니다.

4. 화면 확인하기

vite preview로 dist를 띄우고 헤드리스 Chromium으로 접속해 글자를 읽습니다.

npx vite preview --port 4173 --strictPort --host 127.0.0.1
h1: 첫 React 컴포넌트
h2: 안녕하세요, copyandrun님

받은 HTML 원문에는 <div id="root"></div>만 있습니다. 화면의 글자는 브라우저가 JavaScript를 실행한 뒤에 채워집니다. 그래서 JavaScript를 실행하지 않는 크롤러나 curl로 받은 원문에서는 내용이 보이지 않습니다. 이 점은 서버 렌더링을 쓰는 사이트와 구분해서 알아 둘 필요가 있습니다.

5. 확인 체크리스트

  • npm create vite로 React 프로젝트를 만들고 의존성을 설치했습니다.
  • props를 받는 Greeting 컴포넌트를 App에서 그렸습니다.
  • npm run build가 성공하고 dist에 HTML, JavaScript, CSS가 생긴 것을 확인했습니다.
  • 헤드리스 Chromium에서 h1과 h2 글자가 그려지는 것을 확인했습니다.

이 글의 다음 단계

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글