> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 명령, 파일 및 구성

명령을 붙여 넣을 위치, 올바른 프로젝트 폴더를 여는 방법, .env 파일을 편집하는 방법, 서버를 중지하고 비밀을 공유하지 않고 설정 오류를 보고하는 방법을 알아보세요.

## 터미널에 명령어가 뜹니다

터미널은 컴퓨터에 대한 지침을 입력하는 창입니다. Visual Studio Code에서 먼저 파일 → 폴더 열기를 사용하여 supastack 폴더를 연 다음 터미널 → 새 터미널을 선택합니다. 새 터미널은 해당 폴더에서 시작됩니다. Windows에서는 터미널의 + 버튼 옆에 있는 메뉴를 사용하여 PowerShell를 선택합니다. macOS 또는 Linux 터미널에서 macOS/Linux 블록을 사용합니다.

명령 블록의 내용만 한 번에 하나씩 붙여넣고 Enter 키를 누릅니다. 주변 Markdown 백틱, PS C:\...와 같은 프롬프트 또는 예제 출력을 붙여넣지 마십시오. #으로 시작하는 줄은 설명입니다. 그들은 아무것도 실행하지 않습니다. 다음 명령을 입력하기 전에 각 설치 명령이 완료될 때까지 기다리십시오. 서버 명령은 계속 실행되며 중지할 때까지 새로운 프롬프트를 반환하지 않습니다.


## 터미널이 어떤 폴더를 사용하고 있는지 확인하세요

리포지토리 루트는 package.json, pnpm-workspace.yaml, 앱 및 패키지가 포함된 최상위 supasack 폴더를 의미합니다. 단계에 달리 명시되지 않는 한 해당 단계에서 명령을 실행하세요. 아래 명령은 현재 폴더를 인쇄합니다. 파일 목록에 package.json이 표시되어야 합니다. Windows에서는 PowerShell pwd 및 ls도 작동합니다.

목록에 apps/web 또는 apps/mobile의 내용만 표시되면 cd ../..를 입력하고 Enter를 눌러 루트로 돌아갑니다. 홈 폴더가 표시되면 cd를 입력하고 그 뒤에 공백을 입력하고 복제본의 전체 경로를 입력합니다. 공백이 포함된 경우 따옴표로 묶습니다. 일반적으로 편집기에서 프로젝트 폴더를 열고 새 터미널을 만드는 것이 더 쉽습니다.

```
pwd
ls
```


## 구성은 터미널이 아닌 파일에 들어갑니다.

AI_PROVIDER=fake와 같은 블록은 구성 텍스트입니다. 편집기에서 명명된 .env 파일을 열고 AI_PROVIDER=로 시작하는 줄을 찾아 해당 값을 바꾼 다음 Ctrl + S(macOS에서는 Command + S)를 사용하여 저장합니다. 각 설정은 KEY=value 형식으로 한 줄을 차지합니다. Markdown 백틱을 추가하지 마세요. 하나의 파일에 동일한 키의 중복 복사본을 피하십시오.

데이터베이스 마이그레이션 명령에는 루트 .env를 사용하고, Next.js 웹 서버에는 apps/web/.env.local를, Expo에는 apps/mobile/.env.local를 사용합니다. Next 및 Expo는 자체 앱 폴더 내에서 실행되며 루트 .env를 자동으로 로드하지 않습니다. 데이터베이스 연결이 변경되면 루트 .env 및 apps/web/.env.local 모두에서 DATABASE_URL를 업데이트하여 마이그레이션과 서버가 동일한 데이터베이스를 사용하도록 합니다. 나중에 참조할 수 있도록 예제 파일을 변경하지 않고 유지하세요.

이름이 점으로 시작하는 파일은 파일 관리자에서 숨겨질 수 있습니다. 편집자의 탐색기에 표시됩니다. 파일 이름이 .env.local.txt가 아닌 정확히 .env.local인지 확인하세요. 이러한 로컬 파일은 비밀번호를 포함할 수 있으며 Git에서 제외됩니다. 해당 내용을 업로드하거나 지원 메시지에 붙여넣지 마십시오.

[각 설정의 의미 찾기](https://supastack.dev/ko/docs/web/project-structure.md)


## 서버를 계속 실행하세요. 명령에 다른 터미널을 사용하십시오

작업하는 동안 개발 서버가 앱을 제공합니다. 튜토리얼에서 open localhost:3000이라고 나오면 터미널을 열어두세요. localhost는 이 컴퓨터를 의미합니다. :3000은 앱에서 사용하는 번호가 매겨진 문과 같은 포트입니다. URL를 터미널이 아닌 브라우저의 주소 표시줄에 넣으세요.

서버가 활성화된 동안 다른 명령을 실행하려면 편집기에서 터미널 → 새 터미널을 선택합니다. 새 터미널은 동일한 프로젝트에 대한 별도의 창입니다. 서버를 중지하려면 해당 터미널을 선택하고 Ctrl + C를 한 번 누릅니다. Windows에서 일괄 작업 종료를 묻는 메시지가 나타나면 Y를 입력하고 Enter 키를 누릅니다. 다시 시작하기 전에 일반 프롬프트가 나타날 때까지 기다리십시오.

웹 환경 설정을 편집한 후 아래 명령을 사용하여 웹 서버를 중지했다가 다시 시작합니다. 소스 파일을 저장하면 일반적으로 페이지가 자동으로 새로 고쳐지지만 환경이 변경되면 다시 시작해야 합니다. Expo 설정을 편집한 후 Expo를 중지한 다음 corepack pnpm --filter @supastack/mobile start --clear를 실행하여 캐시된 번들을 다시 시작하고 지웁니다.

```
corepack pnpm --filter @supastack/web dev
```


## 실패를 읽고 유용한 도움을 요청하세요

설치 중에 빨간색 오류 텍스트가 반환되면 해당 단계에서 중지하세요. 앱을 계속 실행하기보다는 첫 번째 오류를 읽어보세요. 찾을 수 없는 명령은 일반적으로 도구가 누락되었음을 의미합니다. package.json이 없다는 것은 일반적으로 잘못된 폴더를 의미합니다. ECONNREFUSED는 일반적으로 필요한 서버나 데이터베이스가 실행되고 있지 않음을 의미합니다. EADDRINUSE는 ​​다른 프로세스가 이미 해당 포트를 사용하고 있음을 의미합니다.

도움을 요청할 때 운영 체제, 가이드 URL 및 단계 번호, 입력한 정확한 명령 및 첫 번째 오류 메시지를 포함하십시오. 비밀번호, API 키, 토큰 및 데이터베이스 URL의 비밀번호 부분을 제거합니다. .env 파일을 보내지 마세요. 오류 스크린샷이 도움이 될 수 있지만 복사 가능한 텍스트가 진단하기 더 쉽습니다.

[특정 설정 실패 문제 해결](https://supastack.dev/ko/docs/web/troubleshooting.md)


## 다음

[에이전트에게 설정 맡기기](https://supastack.dev/ko/docs/web/agent-setup.md)