For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web/glossary.md (or send Accept: text/markdown).

보게 될 단어들

설정 가이드, 오류 메시지, 제품 자체가 사용하는 용어를 쉬운 말로 정의합니다.

이 가이드에 대해 질문하기

파일과 폴더

이 단어들은 다운로드한 코드를 설명합니다. 설정 가이드는 파일을 열거나 편집하라고 할 때마다 이 이름들을 사용합니다.

저장소(Repository) — 프로젝트 폴더와 그 전체 변경 이력으로, GitHub에 호스팅되고 컴퓨터에 복사됩니다.
클론(Clone) — 컴퓨터에 있는 저장소의 복사본. git clone 명령이 만듭니다.
모노레포(Monorepo) — 여러 앱과 공유 패키지를 담은 하나의 저장소. All Platforms 번들이 하나입니다.
package.json — 모든 앱이나 패키지에 있는 파일로, 이름, 명령, 필요한 라이브러리를 나열합니다.
pnpm-workspace.yaml — 모노레포 루트의 파일로, 어떤 폴더가 워크스페이스에 속하는지 나열합니다.
록파일(Lockfile) — 설치된 모든 라이브러리의 정확한 버전을 기록하는 파일로, 매번 설치가 일치하게 합니다.

컴퓨터의 도구

첫 실행 전에 한 번 설치하는 프로그램들입니다. 가이드는 node --version 같은 명령에서 이들을 언급합니다.

터미널(Terminal) — 명령을 입력하는 창으로, Windows의 PowerShell이나 macOS의 Terminal 같은 것입니다.
Node.js — 브라우저 밖에서 JavaScript를 실행하는 프로그램. 키트의 서버와 스크립트가 그 위에서 돌아갑니다.
npm — Node.js에 번들된 라이브러리 설치 프로그램. 이 키트에서는 주로 Corepack에 도달하는 데 씁니다.
Corepack — 프로젝트가 고정한 정확한 패키지 매니저 버전을 켜주는 도구입니다.
pnpm — 라이브러리를 다운로드하고 프로젝트 스크립트를 실행하는 패키지 매니저. corepack pnpm으로 부릅니다.
Git — 저장소를 다운로드하고 변경 사항을 하나하나 기록하는 도구입니다.
편집기 또는 IDE — 폴더를 열고 파일을 편집하는 앱. 가이드는 Visual Studio Code를 사용합니다.

구성 관련 단어

설정은 터미널이 아니라 파일에 있습니다. 이 단어들은 설정이 어디에 있고 무엇이라 부르는지 다룹니다.

환경 변수 — EMAIL_PROVIDER=local 같은 이름 있는 설정으로, 앱의 동작을 바꿉니다.
.env — 데이터베이스 마이그레이션 같은 명령이 쓰는 설정을 담은 저장소 루트의 파일입니다.
.env.local — 한 앱의 설정 파일로, 웹 서버용이라면 apps/web/.env.local입니다.
시크릿(Secret) — 비공개로 유지해야 하는 값으로, 비밀번호나 서명 키 같은 것입니다. 절대 커밋하거나 채팅에 붙여넣지 마세요.
API 키 — 외부 서비스가 주는 시크릿 문자열로, 앱을 허용된 호출자로 인식하게 합니다.
프로바이더(Provider) — 키트가 AI, 이메일, 결제, 스토리지 같은 일에 쓸 수 있는 외부 서비스입니다.

제품이 쓰는 단어

실행 중인 앱과 그 설정 화면이 이 용어들을 사용합니다. 워크스페이스는 두 가지 다른 의미로 나타납니다 — 맥락을 확인하세요.

워크스페이스(Workspace) — 제품에서는 한 팀의 별도 사용자, 데이터, 설정. pnpm 명령에서는 모노레포 안의 한 패키지 폴더로, --filter로 선택합니다.
엔타이틀먼트(Entitlement) — 워크스페이스가 유료 기능을 사용할 수 있다는 서버의 기록입니다.
마이그레이션(Migration) — 테이블을 만들거나 업데이트하는 버전 있는 데이터베이스 변경. 명령으로 적용합니다.
세션(Session) — 만료되거나 로그아웃할 때까지 누가 요청하는지 서버에 알려주는 로그인 상태입니다.
웹훅(Webhook) — 결제된 인보이스 같은 일이 일어날 때 외부 서비스가 앱의 URL로 보내는 메시지입니다.
계정 대 조직(Account vs organization) — 계정은 한 사람의 로그인이고, 조직은 멤버가 참여하는 공유 팀 공간으로 워크스페이스라고도 합니다.

웹 개발 단어

브라우저에서 앱을 열 때 실행, 빌드, 배포 가이드가 쓰는 용어입니다.

Ctrl + C는 Ctrl을 길게 누른 채 C를 누르고 떼는 것입니다 — 터미널에서 실행 중인 명령을 멈춥니다.

localhost — 브라우저 주소에서 이 컴퓨터를 가리키는 이름. 개발 중 앱이 거기서 실행됩니다.
포트(Port) — :3000처럼 localhost 뒤의 번호 붙은 문. 실행 중인 앱마다 다른 것을 씁니다.
개발 서버(Dev server) — 작업하는 동안 앱을 계속 다시 빌드하고 제공하는 명령. Ctrl + C로 멈춥니다.
빌드(Build) — 소스 코드를 서버가 배포하는 최적화된 파일로 바꾸는 단계입니다.
서버 렌더링(SSR) — 서버가 페이지를 조립한 뒤 보내는 방식으로, 첫 화면이 완성된 상태로 도착합니다.