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글자가 그려지는 것을 확인했습니다.
이 글의 다음 단계
- React useState와 useEffect 기초: 카운터와 데이터 불러오기useState로 화면이 바뀌는 값을 만들고, useEffect로 화면 밖 작업(문서 제목 바꾸기, 데이터 불러오기)을 처리합니다. 클릭 테스트와 정리 함수(cleanup)가 실제로 동작하는지 헤드리스 Chromium으로 확인합니다.
- React XSS 점검: dangerouslySetInnerHTML과 사용자 입력 렌더링같은 댓글 입력을 React 기본 렌더링과 dangerouslySetInnerHTML로 각각 그려 보고, 스크립트 실행 여부를 헤드리스 Chromium으로 확인합니다. 위험한 코드를 찾는 방법과 안전한 기본 형태를 정리합니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com