Supabase 5분 입문 — 코드 적게 쓰는 백엔드의 정답일까

요즘 "바이브 코딩"이라는 말이 유행이죠. AI한테 시켜서 앱을 만드는 흐름인데, 이때 가장 많이 막히는 게 백엔드입니다. 데이터를 저장하고 로그인을 붙이는 그 영역이요.

이 글은 그 백엔드를 거의 코딩 없이 해결해주는 도구 Supabase(수파베이스)를 다룹니다. 저도 사이드 프로젝트에서 몇 번 써봤고, 비개발자 친구한테 추천했던 경험을 녹였습니다.

개발 경험이 없어도 따라올 수 있게 용어를 풀어 썼으니 부담 없이 읽으셔도 됩니다.

Supabase가 뭐길래

Supabase는 데이터베이스, 로그인, 파일 저장 같은 앱 뒷단(백엔드) 기능을 클릭 몇 번으로 만들어주는 서비스입니다. 직접 서버를 깔고 코드를 쓰지 않아도 되니, 비개발자나 1인 개발자에게 특히 인기가 많습니다.

비유하자면 이렇습니다. 식당을 차린다고 할 때 주방 시설부터 직접 짓는 게 전통적인 백엔드 개발이라면, Supabase는 이미 다 갖춰진 공유 주방을 빌리는 쪽에 가깝습니다. 메뉴(데이터)만 정해서 올리면 끝입니다.

핵심은 세 가지를 한 번에 준다는 점입니다.

• 데이터베이스: 회원 정보, 게시글 같은 데이터를 저장하는 창고
• 인증(Auth): 회원가입·로그인·비밀번호 찾기 같은 기능
• 스토리지: 이미지·파일을 저장할 공간

이 세 개를 따로따로 붙이려면 며칠이 걸리는데, Supabase는 가입 즉시 다 켜져 있습니다.

Firebase와 뭐가 다른가

가장 많이 비교되는 게 구글의 Firebase(파이어베이스)입니다. 둘 다 비슷한 영역이지만 결정적 차이가 있습니다.

항목	Supabase	Firebase
데이터베이스 종류	PostgreSQL (표 형태)	Firestore (문서 형태)
오픈소스 여부	⭕ 가능 (직접 설치 가능)	❌ 구글 종속
SQL 사용	⭕ 표준 SQL 그대로	❌ 자체 쿼리 문법
무료 한도 (글 작성 시점)	프로젝트 2개, DB 500MB	문서 50K 읽기/일
학습 곡선	SQL 알면 쉬움	자체 개념 학습 필요

PostgreSQL(포스트그레SQL)은 전 세계적으로 가장 널리 쓰이는 무료 데이터베이스 중 하나입니다. 엑셀 시트처럼 행과 열로 데이터를 다루는 방식이라, 한 번 익혀두면 다른 프로젝트에서도 그대로 써먹을 수 있습니다.

반면 Firebase는 구글만의 방식이라 나중에 옮기기가 까다롭습니다. Supabase는 마음에 안 들면 데이터를 통째로 내려받아 다른 곳으로 이사할 수 있다는 게 큰 장점입니다.

💡 Stack Overflow 2024 개발자 설문에서 PostgreSQL은 가장 사랑받는 데이터베이스 1위였습니다. 익혀두면 손해 볼 일이 거의 없는 기술이라는 뜻입니다.

5분 안에 첫 프로젝트 만들기

진짜로 5분이면 첫 테이블까지 만듭니다. 카드 등록도 필요 없습니다.

준비물 체크리스트

• [ ] 이메일 계정 (또는 GitHub 계정)
• [ ] 웹 브라우저
• [ ] 끝.

순서는 이렇습니다.

1. supabase.com 접속 → Start your project 클릭
   ↓
2. GitHub 또는 이메일로 가입
   ↓
3. New Project 버튼 → 프로젝트 이름·비밀번호 입력
   ↓
4. 약 1~2분 대기 (DB 자동 생성 중)
   ↓
5. Table Editor에서 첫 테이블 만들기

3번 단계에서 입력하는 비밀번호는 데이터베이스 관리자 비밀번호입니다. 별도로 메모해두세요. 나중에 데이터를 직접 내려받거나 외부 도구를 연결할 때 필요합니다.

4번에서 1~2분 정도 검은 화면에 진행 표시가 도는데, 이때 Supabase가 진짜 PostgreSQL 서버를 클라우드에 깔아주고 있는 겁니다. 차 한 잔 마시고 오면 됩니다.

첫 테이블과 데이터 넣어보기

테이블은 엑셀의 시트 한 장이라고 생각하면 쉽습니다. 가입 후 왼쪽 메뉴에서 Table Editor에 들어가 New Table을 누르면 됩니다.

예를 들어 간단한 메모 앱을 만든다고 해봅시다. 이런 식으로 컬럼(열)을 정의합니다.

컬럼 이름	타입	설명
id	int8	자동 번호 (기본 제공)
created_at	timestamp	작성 시각 (기본 제공)
title	text	메모 제목
content	text	메모 내용

text는 자유로운 글자 데이터, int8은 숫자입니다. 처음 두 개(id, created_at)는 Supabase가 자동으로 만들어주니 신경 쓰지 않아도 됩니다.

저장하면 끝입니다. 이 테이블에 행(데이터)을 추가해볼 수 있고, 화면에서 직접 한 줄씩 입력해도 되고, 외부 앱에서 API로 넣어도 됩니다.

API 키와 첫 데이터 호출

여기서부터가 진짜 백엔드 느낌입니다. Supabase는 테이블을 만들면 자동으로 API를 생성해줍니다. 따로 코드를 쓰지 않아도 외부에서 데이터를 주고받을 수 있다는 뜻입니다.

API라는 단어가 낯설다면 이렇게 생각하세요. API는 "데이터를 주문받는 창구"입니다. 식당에서 주방에 직접 들어가지 않고 점원에게 주문하듯, 외부 앱은 API로 Supabase에 "메모 다 보여줘", "이 메모 저장해줘"라고 요청합니다.

Project Settings → API 메뉴에서 두 가지를 확인할 수 있습니다.

• Project URL: 우리 프로젝트의 주소
• anon public 키: 일종의 출입증

이 둘을 ChatGPT나 Claude한테 던져주면서 "이 Supabase에 메모 저장하는 React 코드 만들어줘"라고 시키면, AI가 알아서 짜줍니다. 바이브 코딩의 핵심 흐름입니다.

⚠️ 주의: service_role 키라는 게 따로 있는데, 이건 절대 외부에 노출하면 안 됩니다. 관리자 권한이 다 풀린 마스터 키라서, 노출되면 데이터가 통째로 털릴 수 있습니다. 공개해도 되는 건 anon public 키뿐입니다.

자주 막히는 부분

저도 처음에 헤맸고, 주변에 추천했을 때 비개발자 친구들이 공통으로 막힌 지점들입니다.

1. RLS(행 수준 보안) 때문에 데이터가 안 보임

테이블을 만들고 API로 불러왔는데 빈 배열만 옵니다. 분명 데이터를 넣었는데도요. 이건 RLS(Row Level Security) 라는 보안 기능이 기본으로 켜져 있기 때문입니다.

해결법은 두 가지입니다. 테스트 단계에서는 Authentication → Policies에서 "모든 사용자가 읽기 가능" 정책을 추가하거나, 잠깐 RLS 자체를 끄면 됩니다. 단, 실제 서비스에서는 절대 끄면 안 됩니다. 누구나 데이터를 가져갈 수 있게 되니까요.

2. 무료 한도와 프로젝트 일시 정지

글 작성 시점 기준 무료 플랜은 일주일 동안 아무 활동이 없으면 프로젝트가 자동으로 일시 정지됩니다. 사이드 프로젝트로 묻어두면 어느 날 갑자기 안 됩니다. 대시보드에서 Resume 버튼만 누르면 살아나니 당황하지 마세요.

3. 비밀번호를 까먹은 경우

처음 만들 때 입력한 DB 비밀번호는 복구 불가입니다. 새로 발급받아야 합니다. Project Settings → Database → Reset password에서 재설정할 수 있는데, 외부 도구에 연결해뒀다면 그것들도 다 다시 설정해야 합니다. 처음부터 비밀번호 관리 앱에 저장하길 권합니다.

어떤 사람한테 추천하는가

직접 써본 입장에서 정리하면 이렇습니다.

이런 분께	추천도
AI한테 시켜서 토이 프로젝트 만들고 싶은 비개발자	⭐⭐⭐⭐⭐
SQL을 익히고 싶은 입문자	⭐⭐⭐⭐⭐
Firebase 쓰다가 답답함을 느낀 개발자	⭐⭐⭐⭐
대규모 트래픽 서비스를 운영할 사람	⭐⭐⭐ (유료 플랜·최적화 필요)
완전 정적인 블로그만 만들 사람	⭐⭐ (오버스펙)

특히 블로그 글 자동 백업 시스템, 간단한 회원제 커뮤니티, 개인 가계부 앱 같은 걸 만들고 싶은 분이라면 Supabase + AI 코딩 도구 조합이 정말 강력합니다. 며칠이면 동작하는 결과물이 나옵니다.

반대로 트래픽이 폭주하는 본격 서비스라면 무료 플랜으로는 부족하고, 인덱스·쿼리 최적화 지식이 따로 필요해집니다. 입문하기엔 좋지만 만능은 아니라는 점은 짚고 갑니다.

마무리

Supabase는 "백엔드를 직접 만들기엔 부담스러운데, Firebase는 구글 색이 너무 짙어서 싫다"는 사람들에게 가장 자연스러운 선택지입니다. 5분 가입 → 테이블 생성 → API 자동 생성으로 이어지는 흐름이 정말 매끄럽거든요.

오늘은 일단 회원가입하고 빈 프로젝트 하나만 만들어보세요. 그것만으로도 감이 잡힙니다.

다음 단계로 ChatGPT나 Claude에 "내 Supabase에 ○○ 기능을 붙이는 코드 만들어줘"라고 시켜보면, 바이브 코딩이 왜 화제인지 체감하실 겁니다. 저도 그렇게 시작했고, 지금은 작은 도구 몇 개를 그렇게 만들어 쓰고 있습니다.