>마일드코드

바이브코딩에 필요한 프론트엔드 개념 이 영상 하나로 속시원하게 끝내드립니다

2026.10.17읽는 시간 10분영상
#입문#바이브코딩#프론트엔드
영상: 바이브코딩에 필요한 프론트엔드 개념 이 영상 하나로 속시원하게 끝내드립니다
한눈에 답하면

바이브코딩을 하다 보면 AI 가 HTML, React, TypeScript 같은 이름을 꺼내며 의견을 묻습니다. 이 글은 그 이름들이 각각 왜 필요한지를 예약 페이지 하나로 따라가고, 그 끝에서 진짜 중요한 한 가지를 정리합니다. 어떤 코드가 사용자 디바이스로 내려가고, 어떤 코드가 서버와 데이터베이스에 남아야 하는지입니다.

바이브코딩을 하다 보면 AI 가 HTML, CSS, JavaScript 부터 React, TypeScript 같은 기술 이름까지 꺼내면서 의견을 묻습니다. 몇 년 전까지만 해도 이게 뭔지 모르면 코딩을 시작도 못 했는데, 이제는 몰라도 결과물은 나오죠.

그런데 알지도 못하는 기술로 자꾸 의견을 묻고, 나는 그냥 「알아서 해 줘」라고 시키는 게 불안하고 답답하신 분들이 있습니다. 개발을 시작한 지 10년이 다 돼 가는 현직 풀스택 프로덕트 엔지니어로서, 적어도 프론트엔드만큼은 까막눈에서 벗어나 큰 그림을 볼 수 있게 정리해 보겠습니다.

먼저 숲부터: 세 곳이 있습니다

우리가 많이 쓰는 웹 서비스를 기준으로 보면 크게 세 곳이 있습니다.

어디무엇
사용자 디바이스사용자의 컴퓨터나 휴대폰. 다른 말로 클라이언트라고도 합니다
서버웹 서비스의 서버. 요청을 받아 처리합니다
데이터베이스데이터를 쌓아 두는 곳

프론트엔드는 이 중 첫 번째, 사용자 디바이스에서 동작하는 영역입니다. AI 가 꺼내는 HTML, CSS, JavaScript, React, TypeScript 같은 이름은 대부분 이 영역에서 쓰입니다.

「대부분」이라고 한 이유가 있습니다. React 나 TypeScript 는 서버 쪽에서도 씁니다. 요즘 많이 쓰는 웹 프레임워크 중에는 한 프로젝트 안에서 어떤 코드는 서버에서만 돌고 어떤 코드는 브라우저로 내려가는 구조가 기본인 것도 있어요. 그래서 기술 이름보다 그 코드가 어디서 도는가가 더 중요합니다.

이 글에서는 예약하기 버튼이 있는 페이지 하나를 예로 들겠습니다.

브라우저가 받아 오는 세 가지

브라우저는 웹페이지를 화면에 띄울 때 세 가지 파일을 받아옵니다.

파일맡는 일빠지면
HTML제목, 버튼, 예약 목록이 어디에 있는지, 뼈대보여 줄 게 없습니다
CSS색, 글꼴처럼 눈에 보이는 디자인글자와 버튼만 남은 뼈대로 돌아갑니다
JavaScript버튼을 누르면 목록에 한 줄이 추가되는 것 같은 동작버튼을 아무리 눌러도 아무 일도 안 일어납니다

이 세 가지가 합쳐져서 웹페이지 하나가 됩니다. JavaScript 를 빼도 화면이 그대로인 건 HTML 에 화면을 다 그려 둔 페이지 이야기입니다. 요즘 AI 가 만들어 주는 페이지는 JavaScript 가 화면을 그리는 경우가 많아서, JavaScript 가 없으면 아예 빈 화면이 뜨기도 합니다.

그리고 중요한 사실 하나. 이 파일들은 서버에서 완성된 화면으로 합쳐져서 오는 게 아닙니다. 파일 그대로 사용자 디바이스로 내려와서, 사용자 디바이스에서 조립됩니다.

내려간 코드는 누구나 볼 수 있습니다

파일이 내려왔다는 건 그 코드 전체가 지금 사용자 디바이스 안에 있다는 뜻입니다.

크롬에는 개발자 도구가 있습니다. 개발자들이 웹페이지의 구성요소와 코드를 확인할 때 쓰는 창이에요. 여기서 Sources 탭을 누르면 예약 페이지가 받아온 파일 목록이 나오고, JavaScript 파일을 하나 열면 예약하기 버튼을 눌렀을 때 실행되는 코드가 그대로 보입니다. 보는 것뿐 아니라 내 화면에서 고쳐서 돌려 보는 것도 됩니다.

CAUTION

사용자 디바이스로 내려간 코드는 마음만 먹으면 누구나 볼 수 있습니다. 그래서 화면 쪽에서 버튼을 막아 두는 검사는 우회할 수 있고, 화면 코드에 넣은 비밀은 비밀이 아닙니다.

React 는 같은 숫자가 두 곳에 생길 때 필요합니다

HTML, CSS, JavaScript 셋이면 화면은 다 만들 수 있는데 AI 는 왜 자꾸 React 를 꺼낼까요. React 가 필요해지는 건 페이지가 커지기 시작할 때입니다.

예약 페이지 맨 위에는 남은 자리 숫자가 있고, 그 아래에 예약 목록이 있다고 해 볼게요. 예약을 하나 취소했더니 목록에서는 한 줄이 지워졌는데 남은 자리 숫자는 그대로입니다. 두 곳이 같은 데이터를 각자 따로 들고 있어서 한쪽만 바뀐 거예요. 같은 데이터를 두 군데에 두면 한쪽을 고칠 때마다 다른 쪽도 고쳐야 해서 맞추기가 어렵습니다.

React 는 화면을 버튼, 목록, 숫자처럼 작은 단위로 나눠서 만듭니다. 이 작은 단위를 컴포넌트라고 부릅니다. 그리고 데이터를 한 곳에만 두고, 그 데이터가 바뀌면 그걸 쓰는 컴포넌트들이 자동으로 새 값을 받아서 다시 그리게 할 수 있어요. 데이터와 화면이 어긋나는 문제를 React 가 도와주는 겁니다.

꼭 React 여야 하는 건 아닙니다. 다만 AI 는 많이 쓰이고 자료가 많은 React 를 추천하는 경향이 강하고, 다른 걸 고를 이유를 스스로 설명할 수 있는 게 아니라면 저는 일단 React 로 시작하시길 권합니다.

TypeScript 는 실행하기 전에 잡아 줍니다

컴포넌트로 나누니 맞추기는 쉬워졌는데, 페이지가 커질수록 컴포넌트가 많아지고 컴포넌트끼리 데이터를 잘못 넘기는 일이 생깁니다.

예약 목록 컴포넌트는 예약한 사람 이름과 예약 시간을 받기로 되어 있는데, 다른 컴포넌트가 예약 시간 자리에 전화번호를 넘기는 거예요. JavaScript 는 실행해 보기 전까지 이런 오류를 알려 주지 않습니다. 결국 예약 목록을 연 사용자가 깨진 화면을 먼저 보게 되죠.

그래서 TypeScript 를 씁니다. 예약 시간 칸에는 시간, 이름 칸에는 이름이 들어간다고 미리 정해 두면, 정의와 맞지 않는 코드에 에디터가 빨간 밑줄을 바로 긋습니다. 실행하기 전에 먼저 검사하는 겁니다. AI 가 짠 코드를 한 줄씩 다 읽지 않아도 컴포넌트끼리 안 맞는 곳을 먼저 걸러 줘요.

다만 검사를 통과했다고 해서 원하는 대로 동작한다는 뜻은 아닙니다. 틀린 종류의 값을 넘기는 실수를 잡아 줄 뿐입니다.

설치는 npm, 묶기는 번들러

여기서 또 문제가 생깁니다. React 에서 흔히 쓰는 문법도, TypeScript 코드도 브라우저는 그대로는 실행하지 못합니다. 브라우저가 기본으로 읽는 건 HTML, CSS, JavaScript 입니다.

이 부분에서 이름이 두 종류 나오는데, 하는 일이 다릅니다.

단계하는 일이름
설치남이 만들어 둔 코드 묶음(패키지)을 받아 오고, 버전까지 기록해서 내 컴퓨터와 배포 서버에 똑같이 깔리게 합니다패키지 매니저: npm, pnpm, yarn
빌드React · TypeScript 코드를 브라우저가 실행할 수 있는 JavaScript 로 바꾸고, 사용자 디바이스로 보낼 코드를 몇 개 파일로 묶습니다번들러: Vite, webpack, Rspack

빌드로 묶인 파일을 보통 번들이라고 부릅니다. 이 번들이 사용자 디바이스로 전송되면, 사용자는 브라우저에서 예약 페이지를 쓸 수 있게 됩니다.

npm run build 같은 명령을 치니까 npm 이 묶는 것처럼 보이지만, npm 은 정해 둔 빌드 명령을 실행해 줄 뿐이고 실제로 바꾸고 묶는 건 번들러입니다. 그리고 빌드는 사용자가 페이지를 열 때마다 하는 게 아니라 배포하기 전에 한 번 일어납니다.

버튼을 직접 만들지 않는 이유

기능이 늘어날수록 예약하기 버튼, 이름 입력창, 예약 내용을 확인하는 팝업 창 같은 구성요소가 계속 필요해집니다. 이걸 전부 직접 만들려면 손이 정말 많이 가고, 키보드만으로 조작하는 기능 같은 접근성은 빠지기 쉬워요. 그러면 마우스를 쓰기 어려운 사용자는 팝업 창을 닫지 못하는 일도 생깁니다.

그래서 컴포넌트 라이브러리를 씁니다. 다른 개발자가 미리 만들어 둔 컴포넌트 묶음을 npm 으로 설치해서 가져다 쓰는 방식이에요. 그런데 설치한 라이브러리는 버튼 모양이나 동작을 내 페이지에 맞게 고치기가 어렵습니다. 코드가 설치한 패키지 안에 들어 있어서, 원하는 디자인을 입히려면 우회하는 코드를 따로 써야 하거든요.

shadcn/ui 는 방식이 다릅니다. 라이브러리를 통째로 설치하는 대신, 버튼 같은 컴포넌트의 코드를 내 프로젝트 안에 파일로 추가합니다. 버튼 동작을 바꾸고 싶으면 내 프로젝트에 들어온 그 파일을 직접 고치면 돼요. 접근성을 고려해 만든 컴포넌트를 가져오면서도 내 페이지에 맞게 고칠 수 있는 거죠.

꼭 shadcn/ui 여야 하는 건 아닙니다. 비슷한 오픈소스가 정말 많아요. 요즘 많이 보이는 이름이라 예로 들었습니다.

휴대폰 앱은 원래 두 번 만듭니다

사용자가 웹 브라우저만 쓰는 건 아니죠. 예약 페이지를 휴대폰 앱으로도 만들고 싶다면요.

웹은 브라우저가 파일을 받아 와서 실행했습니다. 앱은 보통 앱 스토어에서 설치 파일을 내려받아 휴대폰에 설치한 다음 실행합니다. 그리고 휴대폰 앱은 기본적으로 Android 앱과 iOS 앱을 따로 만들어야 해요. Android 는 Kotlin 이나 Java, iOS 는 Swift 나 Objective-C 로 화면을 만들거든요. 같은 예약 앱을 두 번 만들어야 하는 셈입니다.

그래서 React Native 를 쓰는 분들이 있습니다. 웹에서 쓰던 React 로 Android 앱과 iOS 앱을 함께 만들 수 있어요. 웹페이지를 앱 안에 그대로 띄우는 방식은 아닙니다. React 로 쓴 컴포넌트를 앱이 실행될 때 Android 와 iOS 각각의 화면 요소로 바꿔서 보여 줍니다. 그래서 웹에서 화면 영역을 나눌 때 쓰는 div 대신 React Native 에서는 View 라는 컴포넌트를 씁니다.

AI 가 Expo 를 꺼내면, React Native 앱을 만들 때 함께 쓰는 프레임워크라고 보시면 됩니다.

데스크톱 앱은 Electron

컴퓨터에 설치하는 데스크톱 앱도 비슷합니다. 기본적으로는 Windows, macOS 처럼 운영체제마다 따로 만들어야 해요.

그래서 Electron 을 쓰는 분들이 있습니다. 웹페이지를 만들 때 쓰는 HTML, CSS, JavaScript 로 데스크톱 앱을 만들고, 같은 코드로 Windows, macOS, Linux 앱을 함께 만들 수 있습니다. Electron 은 크롬의 기반인 Chromium 과, 컴퓨터에서 JavaScript 를 실행하는 Node.js 를 앱 안에 함께 넣습니다.

개발자들이 쓰는 코드 에디터 VS Code 도 Electron 으로 만든 앱입니다. 대신 브라우저를 앱마다 통째로 넣다 보니, Electron 쪽 설명으로는 Electron 앱은 대부분 용량이 100MB 를 넘습니다.

앱이라고 숨겨지지 않습니다

여기까지 오면 공통점이 보입니다. 웹이든 휴대폰 앱이든 데스크톱 앱이든, 우리가 쓴 화면 코드는 전부 사용자 디바이스로 내려갑니다. 앱은 설치 파일째로 내려갈 뿐이에요.

앱은 개발자 도구로 코드를 못 보니까 비밀 키를 넣어도 괜찮을 것 같죠. 그렇지 않습니다. 설치 파일을 받은 사람은 누구나 앱 안에 든 비밀 키를 꺼낼 수 있습니다. 그러면 다른 사람이 내 AI 서비스 비밀 키를 쓰고, 요금은 앱을 만든 내가 내게 될 수도 있어요.

그래서 비밀 키를 쓰는 코드는 서버에 둡니다. 서버에서만 실행되는 코드는 사용자 디바이스로 전송되지 않기 때문입니다. 화면 코드가 데이터베이스에 바로 접근하지 않고 서버를 거치게 하는 게 기본인 이유도 같습니다.

화면이 데이터베이스에 바로 붙는다면

그런데 요즘 바이브코딩으로 만든 앱은 화면 코드가 데이터베이스에 바로 연결되는 경우가 제가 보기엔 정말 흔합니다. 이 경우 화면 코드 안에 Supabase 같은 데이터베이스의 키가 들어갑니다.

그래서 Supabase 는 키를 두 가지로 나눕니다. Supabase 문서의 비유를 빌리면 현관문에 붙여 두는 키와 주머니에 넣고 다니는 마스터키입니다.

키어디에무엇을 여나
공개 키원래 화면 코드에 넣도록 만든 키. 누구나 볼 수 있습니다로비까지만
비밀 키화면 코드에 절대 넣지 않습니다. 서버에만모든 문

그런데 방마다 문을 잠가 두지 않으면 현관 키 하나로 모든 방이 열립니다. 누군가 화면을 거치지 않고 요청을 직접 보내서 다른 사람 예약의 결제 상태를 「결제 완료」로 바꿀 수도 있어요.

그래서 데이터베이스에 방마다 자물쇠를 겁니다. 이 데이터베이스의 자물쇠를 RLS 라고 부릅니다. AI 가 RLS 를 꺼내면 「데이터베이스의 자물쇠 설정」이라고 이해하시면 됩니다. 정리하면, 화면에 들어간 공개 키는 원래 공개이고 문을 잠그는 건 데이터베이스의 자물쇠입니다.

실제로 있었던 일입니다.

  • Lovable 이라는 바이브코딩 서비스로 만든 앱들을 조사한 한 보안 연구자의 보고에서, 그중 한 앱은 결제를 하지 않고도 결제 완료 기록을 저장할 수 있었다고 합니다. Lovable 은 이 기록에 이의를 달면서 앱 데이터 보호는 각 고객의 책임이라는 입장을 냈습니다.
  • 2026년 2월에는 Moltbook 이라는 서비스가 화면 코드에 Supabase 키를 넣어 둔 채 데이터베이스에 자물쇠를 걸지 않아서 API 토큰 150만 개가 노출돼 있었다고 보안 회사 Wiz 가 밝혔습니다.

예약하기 버튼 하나를 다시 따라가 보면

예약하기 버튼을 한 번 누르는 과정을 처음부터 다시 따라가 보겠습니다.

어디서무슨 일
배포 전TypeScript 가 컴포넌트끼리 주고받는 데이터를 미리 검사하고, 번들러가 코드를 번들로 묶습니다
사용자 디바이스페이지를 열면 HTML, CSS, JavaScript 가 내려오고, 화면은 React 컴포넌트로 나뉘어 있습니다. 앱이라면 React Native 나 Electron 으로 만든 앱을 설치한 겁니다
서버비밀 키를 쓰는 코드는 여기에 있습니다
데이터베이스화면이 바로 붙는 구성이라면, 자물쇠(RLS)가 한 번 더 확인합니다

처음에 프론트엔드를 화면 디자인 정도로 생각하셨던 분도 계셨을 겁니다. 프론트엔드는 사용자 디바이스로 전송되어 사용자 디바이스에서 실행되는 코드입니다. 앱으로 만들면 코드가 안 보일 것 같지만, 설치 파일도 결국 사용자 디바이스로 내려갑니다.

여기서 예로 든 기술들이 전부도 아니고, 다른 선택지도 많습니다. 큰 그림을 잡기 위해 많이 쓰이는 것 위주로 골랐을 뿐이에요. 중요한 건 이름을 외우는 게 아니라 어디서 어떤 기술이 필요하고, 그게 왜 쓰이는지 아는 겁니다.

이 정도만 구분할 수 있으면 충분합니다

가져가시면 좋은 건 프론트엔드가 어느 영역인지에 대한 감입니다. AI 가 작성한 코드가 사용자 디바이스로 전송되는지, 서버와 데이터베이스에 남는지를 구분할 수 있는 정도면 충분합니다.

바이브코딩이라는 말을 처음 쓴 것으로 알려진 안드레이 카파시도 스스로 웹 개발 경험은 거의 없다고 밝혔습니다. 그가 2025년 4월 블로그에 바이브코딩으로 웹 앱을 만든 경험을 적었는데, React 화면은 정말 빨리 나와서 80% 끝났다고 느꼈지만 실제로는 20%에 가까웠다고 합니다. 남은 일은 API 키, 배포, 로그인, 결제였어요. 전부 사용자 디바이스만으로는 끝나지 않고 서버 쪽이 끼는 일입니다. 데이터베이스는 결국 다음으로 미뤘다고 적었고요.

저도 현직에서 일하면서 보면 웹 화면이든 앱 화면이든 이제 AI 가 누구보다 빨리 만듭니다. 그런데 어떤 코드를 사용자 디바이스로 보내고 어떤 코드를 서버와 데이터베이스에 남길지는, 두 영역의 차이를 알아야만 직접 정할 수 있습니다. 그걸 모르면 불안해하면서 AI 에게 전부 맡길 수밖에 없죠.

COPY THIS PROMPT
이 프로젝트를 점검만 해줘. 아직 아무것도 고치지 마.

1. 사용자 디바이스(브라우저나 앱)로 내려가는 코드와, 서버에서만 실행되는 코드를 나눠서 표로 보여줘.
 폴더나 파일 단위로 짚어주면 돼.
2. 화면 쪽 코드에 들어 있는 키나 설정값을 전부 찾아서, 원래 공개해도 되는 값인지
 서버에만 있어야 하는 비밀 값인지 하나씩 표시해줘.
3. 화면 코드가 데이터베이스에 바로 연결되는 곳이 있으면 알려주고,
 그 테이블마다 자물쇠(RLS)가 켜져 있는지, 어떤 규칙인지 설명해줘.
4. 화면에서만 막고 서버나 데이터베이스에서는 다시 확인하지 않는 곳이 있으면 짚어줘.

설명은 개발을 모르는 사람이 읽는다고 생각하고 쉬운 말로 해줘.

자주 묻는 것

COURSE
만드는 건 이제 쉽습니다. 문제는 그다음입니다.

바이브코딩 바닥부터 프로 개발자처럼 서비스를 운영하는 법과 수익화까지, 인프런 강의 「모두의 클로드 코드」에 순서대로 담았습니다.

개인 링크 페이지, 구글 로그인과 관리자 화면이 붙은 구독 관리 서비스, 결제 알림이 오는 모바일 앱, 자동 배포 파이프라인까지 네 가지를 직접 만들어 봅니다.

모두의 클로드 코드 보기