---
title: "개발자용 Briks: 코드, GitHub 연동"
url: https://briks.dev/ko/developers
description: "사이트 코드를 읽고, 수정하고, 내려받고, GitHub와 동기화하고, 데이터베이스, 웹훅, 시크릿, 결제를 써요."
last_updated: 2026-10-22
---

# 개발자를 위한 Briks

Briks는 모든 사이트에 실제 코드를 작성하고, 그 코드는 직접 읽고 편집할 수 있어요. 유료 플랜에서는 다운로드도 할 수 있어요. GitHub 동기화부터 웹훅까지 제공되는 기능과, 게시할 때마다 따르는 규칙을 안내해요.

**your-site-version-14.zip** 다운로드에 담기는 것

- `app/`사이트의 페이지들이에요. 페이지 주소마다 폴더가 하나씩 있어요.
- `components/custom/`히어로와 푸터처럼 사이트에 맞춰 작성된 섹션이에요.
- `content/`사이트의 문구와 사실 정보예요.
- `public/`사이트가 그대로 제공하는 사진과 파일이에요.
- `api/`사이트 자체의 서버 코드가 있다면 그 코드예요.
- `db/`사이트가 데이터를 저장한다면 그 데이터의 구조예요.
- `.env`다운로드에는 절대 포함되지 않아요. 키는 Secrets에 남아요.

제외되는 것: 모든 Briks 사이트가 실행되는 데 쓰이는 공용 부분이라서, 다운로드한 파일만으로는 단독 실행되지 않아요.

## 코드는 내 것이에요

모든 플랜에서 유료 요금제에서 다운로드

**읽어 보기**

File Explorer에는 라이브 버전에 들어 있는 그대로, 내 사이트를 위해 작성된 파일이 보여요.

**직접 수정하기**

편집 권한이 있는 사람은 AI도 크레딧도 쓰지 않고 파일을 직접 고쳐 게시할 수 있어요. 게시 규칙을 어기는 저장은 보류되고, 빌드가 실패하면 아무것도 공개되지 않아요.

**다운로드하세요**

유료 플랜에서는 워크스페이스의 누구나 라이브 버전이나 이전 버전을 zip으로 내려받을 수 있어요.

**제외되는 것**

다운로드 파일에는 사이트 자체의 파일이 들어 있어요. 모든 Briks 사이트가 함께 쓰는 공통 부분, 설정 파일, 키는 빠져 있어서 그것만으로는 실행되지 않아요.

- [내 사이트의 코드](https://briks.dev/ko/docs/code)

## GitHub 동기화

유료 요금제

**연결**

Owner와 Admin이 프로젝트에 저장소와 브랜치를 연결해요.

**Briks에서 GitHub로**

게시되는 모든 버전은 내 브랜치의 커밋이 돼요.

**GitHub에서 Briks로**

브랜치에 푸시하면 같은 게시 규칙으로 점검하고, 빌드해서 게시해요. AI는 쓰지 않아요.

**충돌**

양쪽이 같은 파일을 바꾸면 Briks는 자신의 버전을 `briks-sync` 브랜치에 올려 두고 직접 병합하도록 해요. 강제 푸시는 절대 하지 않아요.

**들어갈 내용**

사이트 자체 파일만 담겨 있어서 저장소가 혼자 실행되지는 않아요. 설정 파일, 데이터베이스 변경 내용, 키는 절대 포함되지 않아요.

- [GitHub 동기화](https://briks.dev/ko/docs/github)

## 사이트별 데이터베이스

모든 플랜에서 유료 요금제에서 다운로드

**전용 데이터베이스**

데이터를 저장하는 사이트는 빌드에서 처음 필요할 때 기본적으로 유럽 연합에 만들어지는 전용 데이터베이스를 받아요.

**스튜디오에서**

컬렉션별로 레코드를 보고, 검색하고, 정렬하고, 추가하고, 수정할 수 있어요. 사이트의 계정, 주문, 구독을 한눈에 보는 화면도 있어요.

**다운로드**

유료 플랜에서는 모든 컬렉션을 JSON으로, 또는 컬렉션 하나를 CSV로 다운로드할 수 있어요.

**구조 바꾸기**

새 필드나 컬렉션을 쉬운 말로 요청하세요. 변경은 항상 추가만 하고, 적용 전에 Briks가 복원 지점을 만들며, 데이터를 잃을 수 있는 변경은 게시를 멈춰요.

**되돌리기**

Owner와 Admin은 데이터베이스를 이전 시점이나 복원 지점으로 되돌릴 수 있어요. 유료 플랜에서는 매일 밤 만든 복사본을 30일간 보관해요.

- [데이터베이스](https://briks.dev/ko/docs/database)
- [백업](https://briks.dev/ko/docs/backups)

## 예약 작업, 웹훅, 배포 훅

모든 플랜에서 플랜별 한도

**예약 작업**

내 사이트의 경로나 보안이 적용된 웹 주소를 원하는 시간대 기준의 일정에 맞춰 호출해요. 실행 기록은 30일간 보관돼요.

**웹훅**

사이트가 게시되거나, 양식 응답이 들어오거나, 스튜디오에서 레코드가 바뀌면 보안 주소로 Standard Webhooks 형식의 서명된 메시지를 보내요: `site.published`, `form.received`, `record.changed`. 전송에 실패하면 약 45분 동안 다시 시도해요.

**배포 훅**

다른 도구가 호출하면 AI 없이 사이트를 다시 게시하는 비공개 주소예요.

| 요금제 | 예약 작업 | 웹훅 | 하루 통화 수 |
| --- | --- | --- | --- |
| Free | 1 | 1 | 2,000 |
| Starter | 5 | 5 | 5,000 |
| Pro | 10 | 10 | 10,000 |
| Studio | 25 | 25 | 50,000 |
| Agency | 50 | 50 | 100,000 |

프로젝트마다 사용량이 따로 정해져 있어요. 하루 호출 수에는 예약 실행과 웹훅 전송이 함께 포함돼요.

- [예약 작업](https://briks.dev/ko/docs/crons)
- [웹훅](https://briks.dev/ko/docs/webhooks)
- [배포 훅](https://briks.dev/ko/docs/publish-history)

## 시크릿

모든 플랜에서

**보관 위치**

서버 코드에 필요한 키는 암호화되어 게시된 사이트에 바로 저장돼요. Briks는 키의 이름만 보관하며, 값은 누구도 다시 읽을 수 없어요.

**추가하기**

사이트를 게시하면 Editor, Admin, Owner가 프로젝트마다 최대 100개까지 추가할 수 있어요. 하나씩 또는 .env 파일로 추가해요.

**사용 방법**

서버 코드는 키를 이름으로 읽어요. 키는 방문자의 브라우저에 전달되지 않으며, 파일에 키를 직접 적으면 게시가 중단돼요.

- [시크릿](https://briks.dev/ko/docs/secrets)

## 내 계정으로 결제 받기

Free를 포함한 모든 플랜

**나만의 결제 대행사**

Stripe, PayPal, Mollie, Razorpay, Paddle, Lemon Squeezy, Polar, Creem, Dodo Payments 중 하나씩, 내 계정과 키로 연결해요. 돈은 나에게 들어오고, Briks는 수수료를 받지 않아요.

**결제와 구독**

일회성 결제는 이 모두에서 가능해요. 선택적으로 무료 체험을 붙일 수 있는 구독은 Stripe, Paddle, Polar, Lemon Squeezy에서 가능해요.

**인증됨**

결제 알림은 모두 확인을 거친 뒤에야 주문으로 인정되며, 주문과 구독은 사이트 자체 데이터베이스에 보관돼요.

**키**

Owner와 Admin이 저장할 수 있어요. 각 항목은 먼저 시험해 본 뒤, 게시된 사이트와 함께 보관돼요.

- [로그인과 결제](https://briks.dev/ko/docs/sign-in-and-payments)

## 방문자를 위한 로그인

모든 플랜에서

**기본값**

이메일과 비밀번호 로그인, 이메일 확인과 비밀번호 재설정을 지원해요.

**제공 업체**

직접 발급한 키로 Google, Apple, Microsoft, GitHub, X, Facebook, LinkedIn, Discord를 추가할 수 있어요.

**회원 전용**

로그인한 회원이나 구독자에게만 페이지와 기록을 공개해요.

## 무엇이든 요청하세요, 고정 규칙 안에서

모든 플랜에서

**요청이 먼저예요**

직접 만든 서버 코드, 내 키로 연결한 다른 서비스, 나만의 결제 흐름을 쉬운 말로 요청하세요. 이후 Briks가 하는 수정이 요청하신 내용을 되돌리는 일은 없어요.

**결정은 내가, 위험은 미리 알려 드려요**

일부 결제 규칙은 구매자가 금액을 직접 정하게 하는 것처럼 분명히 요청할 때만 완화돼요. 빌드는 그 설정을 유지하고 위험을 알려 줘요.

**다른 홈페이지**

프로젝트 설정에서 신뢰하는 웹사이트를 최대 10개까지 허용하면, 사이트가 그 웹사이트의 스크립트를 불러오고, 데이터를 보내고, 페이지를 보여 줄 수 있어요.

**절대 바뀌지 않는 규칙**

파일에 직접 적은 키, 브라우저에서 읽는 비밀 키, Briks 자체 키를 읽는 코드는 누가 요청해도 거부돼요.

## 게시할 때마다 사이트 점검

모든 플랜에서

**게시 규칙**

모든 제작, 변경, 직접 수정, GitHub 푸시는 이 규칙에 맞는지 검사해요. 규칙을 어기는 변경은 게시되지 않고, 라이브 사이트는 그대로 유지돼요.

**보안 검토**

Briks가 쓰는 코드는 데이터 유출로 가장 자주 이어지는 실수가 있는지 검토하고, 발견된 문제는 게시 전에 다시 고쳐요.

**게시 전 점검**

프로덕션으로 옮길 때는 임시 문구, 제목이나 설명이 없는 페이지, 아무 데도 연결되지 않는 링크, 없는 페이지 안내 화면이 빠졌는지 점검해요.

- [Briks 보안](https://briks.dev/ko/security)

## 로그

모든 플랜에서

**빌드**

모든 빌드, 변경, 게시와 각각이 거친 단계를 기록해요.

**요청**

사이트 자체 서버 코드로 들어온 최근 24시간의 요청과 오류예요.

**작업과 웹훅**

예약 실행과 웹훅 전송 기록을 각각 30일간 보관해요.

- [로그](https://briks.dev/ko/docs/logs)

## 오늘은 이용할 수 없어요

- 직접 쓰는 도구에서 사이트를 만들고 관리할 수 있는 API 또는 MCP 서버예요.
- 기존 리포지토리를 Briks로 가져오기.