🛠 VibeCoding 템플릿 설치 가이드 (Windows)

이 가이드는 처음 개발을 시작하는 분도 그대로 따라 할 수 있도록 작성되었습니다.
아래 순서대로 진행하면 VibeCoding 템플릿을 Windows 환경에서 실행할 수 있습니다.

1️⃣ 사전 준비

아래 사이트에서 회원가입을 먼저 완료하세요.
GitHub 먼저 가입 후 GitHub 계정으로 Supabase에 가입하시는 것을 추천합니다.

• GitHub – https://github.com

• Supabase – https://supabase.com

회원가입 후 로그인까지 완료해두세요.

2️⃣ 필수 프로그램 설치

아래 3가지를 설치합니다.

1. Node.js (https://nodejs.org) – LTS 버전 설치

2. Git (https://git-scm.com)

3. Cursor (https://cursor.com) – 설치 후 실행 가능 여부 확인

3️⃣ PowerShell 실행 정책 변경

Windows 검색창에서 PowerShell을 우클릭 후 관리자 권한으로 실행 후 아래 명령어를 순서대로 입력하세요.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

• y 입력 후 Enter

• 아래 명령어로 변경 여부 확인:

Get-ExecutionPolicy

• RemoteSigned가 출력되면 성공 ✅

4️⃣ Node.js 버전 확인

npm -v

버전이 나오면 정상 설치된 것입니다.

5️⃣ 작업 폴더 만들기

1. 바탕화면에 vibecoding 폴더 생성(이름은 자유)

2. PowerShell에서 아래 명령어 순서대로 입력:

cd /
cd Users
cd Administrator   # 본인 계정 이름일 수도 있음
cd Desktop
cd vibecoding

6️⃣ 템플릿 가져오기

명령어를 입력해 템플릿을 다운로드합니다.(아래는 예시이고 본인이 use this template으로 만든 레포지토리의 주소로 해야함)

git clone https://github.com/N-EXIT/nexit-saas-template.git
cd nexit-saas-template

7️⃣ 패키지 설치

npm install

8️⃣ 환경 변수 설정

1. Cursor에서 nexit-saas-template 폴더를 엽니다.

2. 터미널에 아래 입력:

cp .env.example .env.local

1. .env.local 파일을 열어 Supabase API 키를 넣습니다.

9️⃣ 프로젝트 실행

npm run dev

실행 후 컨트롤 누른 상태로 http://localhost:3000 접속하면 템플릿이 열립니다

💡 설치 중 팁

• cd : 폴더 이동

• ls : 현재 폴더 목록 확인

• 계정 이름이 Administrator가 아닐 수도 있으니, cd Users 후 ls로 내 계정 폴더명을 확인하세요.

• 설치 중 오류가 나면 에러 메시지를 그대로 복사해서 커뮤니티에 질문해주세요.