Skip to content
Projects

Mrbaeksang/my-site-template

View on GitHub

Mrbaeksang/my-site-template has 95 GitHub stars and 76 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 20:08 UTC. Last push 2026-11-06.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

코딩 몰라도 화면에서 바로 고쳐 만드는 포트폴리오 웹사이트 템플릿 (Next.js 16)

Web & Apps

README.md

Original

my-site-template

코딩을 몰라도 화면에서 바로 글과 사진을 고쳐 내 포트폴리오 사이트를 만드는 Next.js 템플릿입니다.

데모 보기 · 강의 영상

Deploy with Vercel

포트폴리오 템플릿 첫 화면

할 수 있는 것

  • 내 PC에서 Ctrl + E로 편집 모드를 켜고 글, 사진, 영상, 배경, 메뉴를 수정
  • 저장 버튼으로 변경 내용을 content/site.json에 반영
  • 소개, 프로젝트, 연락처 섹션과 연락처 QR 코드 제공
  • 다크 모드와 모바일 화면 지원
  • 링크 공유 미리보기, robots.txt, sitemap.xml 자동 생성

시작하기

준비물: GitHub 계정, Vercel 계정, Node.js 20.9 이상, Git

1. 내 저장소 만들고 배포하기

위의 Deploy with Vercel 버튼을 누르고 안내를 따릅니다. 내 GitHub에 저장소가 만들어지고 사이트가 배포됩니다.

2. 내 PC에서 내용 고치기

내-계정과 내-저장소를 실제 이름으로 바꿔 터미널에서 실행합니다.

git clone https://github.com/내-계정/내-저장소.git
cd 내-저장소
npm install
npm run dev
  1. 브라우저에서 http://localhost:3000 을 엽니다.
  2. Ctrl + E(Mac도 동일)를 눌러 편집 모드를 켭니다.
  3. 바꿀 항목에 마우스를 올려 수정합니다.
  4. 오른쪽 아래의 저장 버튼을 눌러 content/site.json에 반영합니다.

업로드 제한은 이미지 5MB, 영상 20MB입니다.

3. 사이트에 반영하기

git add .
git commit -m "내 정보로 수정"
git push

push하면 Vercel이 자동으로 다시 배포합니다.

자주 묻는 질문

배포된 사이트에서는 왜 편집이 안 되나요? 편집은 내 PC의 npm run dev에서만 동작합니다. 방문자가 사이트를 바꿀 수 없도록 배포 환경에서는 저장 기능이 꺼져 있습니다.

내 도메인을 연결했는데 공유 미리보기 주소가 달라요. Vercel 환경 변수에 NEXT_PUBLIC_SITE_URL=https://내-도메인을 추가하고 다시 배포하세요. 지정하지 않으면 Vercel 프로덕션 주소를 사용합니다.

색을 바꾸고 싶어요. app/globals.css의 @theme과 :root 값을 수정하세요.

이전에 이 템플릿을 받았어요. 업데이트해야 하나요? 네. 이전 버전의 Next.js 15.2.4에는 보안 권고가 있고, 편집 API 보호도 추가됐습니다. 이 저장소의 변경 사항을 반영하거나 next를 최신 버전으로 올리세요. 이전 버전은 내용을 컴포넌트 파일에 저장했으므로, 변경 사항을 반영하면 내 내용을 편집 화면에서 다시 입력하거나 content/site.json으로 옮겨야 합니다.

AI 도구로 고치고 싶어요. 구조와 주의 사항을 AGENTS.md에 정리해 두었습니다.

기술 스택

Next.js 16, React 19, TypeScript, Tailwind CSS 4, Motion, Lucide, React Icons, next-themes, qrcode.react

개발

npm run lint       # ESLint
npm run typecheck  # 타입 검사
npm test           # 테스트
npm run build      # 프로덕션 빌드

버그와 제안은 이슈로 남겨 주세요.

라이선스

MIT

만든 사람

백상현 · Sanghyeon Baek (@Mrbaeksang)