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

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

- 주소: https://copyandrun.com/blog/react-vite-first-component-setup/
- 분야: 시큐어코딩
- 발행일: 2026-11-14
- 태그: React, Vite, 컴포넌트, npm, 빌드

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를 고르고 의존성을 설치합니다.

```bash
npm create vite@latest react-lab -- --template react --no-interactive
cd react-lab
npm install
```

설치가 끝나면 `found 0 vulnerabilities`가 출력됩니다. 생성된 `package.json`의 의존성은 다음과 같습니다.

```text
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`

```jsx
export default function Greeting({ name }) {
  return <h2>안녕하세요, {name}님</h2>;
}
```

`name`은 부모가 넘기는 값(props)입니다. 부모는 `<Greeting name="copyandrun" />`처럼 값을 바꿔 같은 컴포넌트를 여러 번 쓸 수 있습니다.

`src/App.jsx`

```jsx
import Greeting from "./components/Greeting.jsx";

export default function App() {
  return (
    <main>
      <h1>첫 React 컴포넌트</h1>
      <Greeting name="copyandrun" />
    </main>
  );
}
```

## 3. 빌드하기

개발 서버 대신 배포용 파일을 만듭니다.

```bash
npm run build
```

```text
✓ 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으로 접속해 글자를 읽습니다.

```bash
npx vite preview --port 4173 --strictPort --host 127.0.0.1
```

```text
h1: 첫 React 컴포넌트
h2: 안녕하세요, copyandrun님
```

받은 HTML 원문에는 `<div id="root"></div>`만 있습니다. 화면의 글자는 브라우저가 JavaScript를 실행한 뒤에 채워집니다. 그래서 JavaScript를 실행하지 않는 크롤러나 `curl`로 받은 원문에서는 내용이 보이지 않습니다. 이 점은 서버 렌더링을 쓰는 사이트와 구분해서 알아 둘 필요가 있습니다.

## 5. 확인 체크리스트

- [x] `npm create vite`로 React 프로젝트를 만들고 의존성을 설치했습니다.
- [x] props를 받는 `Greeting` 컴포넌트를 `App`에서 그렸습니다.
- [x] `npm run build`가 성공하고 `dist`에 HTML, JavaScript, CSS가 생긴 것을 확인했습니다.
- [x] 헤드리스 Chromium에서 `h1`과 `h2` 글자가 그려지는 것을 확인했습니다.
