프레임워크는 왜 쓸까?
기능이 많아지면 HTML 파일만으로는 버거워져요. AI가 "React로 만들게요"라고 할 때 무슨 뜻인지, 무엇이 달라지는지 알아봐요.
🎯 이번 레슨을 마치면
- 프레임워크와 컴포넌트가 왜 필요한지 설명할 수 있다
- npm 설치, 개발 서버, 빌드가 각각 무엇인지 안다
- 프레임워크 프로젝트를 Cloudflare에 배포할 때 필요한 설정을 안다
조립 설명서가 있는 가구 키트
AI가 자주 고르는 도구들
| 이름 | 무엇인가요? | 이럴 때 |
|---|---|---|
| React | 화면을 컴포넌트로 만드는 가장 많이 쓰이는 도구 | 로그인·목록·입력이 많은 웹앱 |
| Vite | React 같은 프로젝트를 빠르게 만들고 미리 보게 해 주는 개발 도구 | React 웹앱을 가볍게 시작할 때 |
| Next.js | React에 페이지 이동, 서버 기능까지 갖춘 큰 프레임워크 | 규모가 큰 서비스 (Vercel에서 가장 편해요) |
| Astro | 글·소개 위주 사이트에 강한 프레임워크 (이 교육 사이트도 Astro예요) | 블로그, 포트폴리오, 회사 소개 |
| Vue, Svelte | React와 비슷한 역할의 다른 선택지 | 팀이나 취향에 따라 |
꼭 알아 둘 세 가지 말
프레임워크를 쓰면 HTML 파일을 더블클릭해서 여는 방식이 아니게 돼요. Codex가 이런 말을 하면 이렇게 이해하세요.
| Codex의 말 | 뜻 | 비유 |
|---|---|---|
“패키지를 설치할게요” (npm install) | 필요한 부품(남이 만든 코드)을 내려받아요. node_modules 폴더가 생겨요 | 키트 부품 상자 받기 |
“개발 서버를 켰어요” (localhost:5173) | 내 컴퓨터에서만 열리는 미리보기 주소예요. 고치면 바로 반영돼요 | 공방 안에서 시험 조립 |
“빌드했어요” (npm run build) | 배포용 파일을 만들어요. 보통 dist 폴더에 생겨요 | 완성품 포장 |
Codex에게 맡기기
동네 모임 예약 웹앱을 만들려고 해. Vite와 React로 프로젝트를 시작해 줘. - 왜 이 도구를 쓰는지, 폴더 구조가 어떻게 되는지 초보자 눈높이로 설명해 줘. - 개발 서버를 켜서 미리보기 화면을 보여 줘. - node_modules 폴더와 비밀 정보 파일(.env)은 Git에 올라가지 않게 해 줘. - Cloudflare에 배포할 때 넣어야 할 빌드 명령과 결과 폴더 이름도 알려 줘.
배포 설정이 하나 늘어요
4-4 레슨에서 Cloudflare와 GitHub를 연결할 때, 정적 HTML은 빌드 설정을 비워 뒀죠. 프레임워크 프로젝트는 두 가지를 알려 줘야 해요.
| 설정 | Vite + React의 보통 값 |
|---|---|
| 빌드 명령 (Build command) | npm run build |
| 결과 폴더 (Build output) | dist |
| 환경 변수 | Supabase 주소와 공개용 키 (예: VITE_SUPABASE_URL) |
퀴즈
Codex가 '개발 서버를 켰어요. localhost:5173에서 볼 수 있어요'라고 했어요. 이 주소를 친구에게 보내면?
📝 정리해 볼까요?
- 프레임워크는 뼈대와 규칙이 갖춰진 조립 키트예요. 화면을 컴포넌트(레고 블록)로 나눠 다시 쓰기 쉬워요.
npm install은 부품 받기, 개발 서버는 내 컴퓨터에서만 보이는 미리보기, 빌드는 배포용 파일(보통 dist 폴더) 만들기예요.- Cloudflare에 올릴 때는 빌드 명령(npm run build)과 결과 폴더(dist)를 알려 줘야 해요.
📖 새로 나온 용어
- 프레임워크 Framework
- 웹을 빨리 만들도록 뼈대와 규칙을 미리 갖춰 둔 도구 세트예요. 정해진 틀 안에 내 코드를 채워 넣어요. 비유: 조립 설명서가 있는 가구 키트
- 라이브러리 Library
- 자주 쓰는 기능을 모아 둔 코드 묶음이에요. 내가 필요할 때 골라서 불러 써요. 비유: 공구 상자
- 컴포넌트 Component
- 버튼, 카드처럼 다시 쓸 수 있게 만든 화면 조각이에요. 비유: 레고 블록
- npm
- 다른 사람이 만든 JavaScript 도구(패키지)를 내려받아 쓰게 해 주는 프로그램이에요. 비유: 코드용 앱스토어
- 빌드 Build
- 개발용 코드를 실제 서비스에 올릴 수 있는 파일로 변환·정리하는 과정이에요. 비유: 원고를 인쇄용 책으로 만들기
잘했어요! 완료 표시는 이 브라우저에 저장돼요.