초보자용 GitHub repository 만들기

가장 쉬운 설정값

GitHub 오른쪽 위 + → 새 repository를 누르고 아래처럼 만듭니다.

Repository name: sample-web-site처럼 영어 소문자와 하이픈 사용
Visibility: 공개 guide/blog는 Public, 판매·관리 code는 Private
README: 새 project면 켜기. 이미 PC project를 push할 예정이면 충돌 방지를 위해 끄기
.gitignore: 정적 웹이면 None, secret이 있으면 기술에 맞게 선택
License: 판매용 private code라면 None

이름을 잘 정하는 법

띄어쓰기 대신 - 사용
한글보다 영어 repository 이름 사용
서비스 역할이 보이게 작성
version 숫자를 이름에 넣지 않기

예: sample-web-site, sample-web-site, sampledesk-docs

Private와 Public

공개 guide나 open template는 Public으로 만들어도 되지만, 웹사이트가 공개된다고 source repository까지 반드시 public일 필요는 없습니다. Cloudflare Pages는 private repository도 연결할 수 있습니다. 관리자 code, 판매 logic, license 관련 code가 있다면 Private이 안전합니다. 공개 template는 Public으로 만들 수 있지만, 사용자는 자신의 목적과 source 공개 범위를 보고 Public 또는 Private을 선택합니다.

README가 중요한 이유

README는 project의 사용 설명서입니다. 다음 네 가지는 반드시 적습니다.

이 project가 무엇인지
어떻게 실행하는지
어떻게 배포하는지
secret을 어디에 넣는지

절대 올리면 안 되는 파일

.env
*.db
*.sqlite
node_modules/
__pycache__/
private/releases/
telegram-token.txt
service-account.json

이미 올렸다면

파일만 삭제하면 끝이 아닙니다. token과 password를 즉시 폐기하고 새로 발급해야 합니다. Git history에도 남을 수 있기 때문입니다.

공식 참고: GitHub Docs — 새 repository 만들기 ↗

README를 켤지 끌지는 시작 방식에 따라 다릅니다

빈 repository를 먼저 만들고 AI가 file을 넣을 때

README 켜기가 편합니다. 첫 commit과 default branch가 생겨 connector가 branch를 찾기 쉽습니다.

PC·ZIP에 이미 있는 기존 source를 push할 때

README·.gitignore·License 끄기가 안전합니다. GitHub 공식 안내도 기존 repository를 import할 때 초기 file을 넣으면 merge conflict가 생길 수 있다고 설명합니다.

Owner: 현재 로그인한 본인 GitHub account
Repository name: [repository 이름]
Visibility: 누구나 복제할 template는 Public, 판매·관리 source는 Private 검토
절대 commit 금지: .env, token, private key, database, 고객 자료