디자인만으로 사이트를 공개하는 통합 실전

디자인만 있는 상태에서 GitHub Pages까지 만듭니다

이 교안은 앞에서 배운 설계, 도구, 배포를 하나로 잇습니다. 디자인 시안만 있는 상태에서 시작해 메인페이지를 만들고, 마지막에는 GitHub Pages 주소로 사이트를 공개합니다.

대상: 앞 교안을 마친 학습자준비물: 디자인 시안결과물: 공개된 웹사이트
전체 여정부터 보기

먼저 이해하기

전체 여정을 한눈에 봅니다

이 교안은 새 개념보다 순서를 잇는 데 집중합니다. 각 단계의 자세한 방법은 앞 교안에 있으므로, 여기서는 무엇을 어떤 순서로 하는지와 마지막 배포를 다룹니다.

  1. 1
    설계

    디자인을 분석표·PRD·규칙 문서로 정리합니다.

    설계 교안 보기
  2. 2
    도구 연결

    AI 코딩 도구를 설치하고 Figma MCP를 연결합니다.

    도구 교안 보기
  3. 3
    제작

    설계 문서와 디자인으로 메인페이지를 섹션 단위로 만듭니다.

  4. 4
    검수

    디자인과 대조하고 반응형·인터랙션·접근성을 확인합니다.

  5. 5
    배포

    GitHub에 올리고 GitHub Pages로 사이트를 공개합니다.

    GitHub 교안 보기

앞 교안을 먼저 확인합니다

1단계

준비물을 확인합니다

  • 구현할 화면이 있는 Figma 디자인과 프레임 링크
  • 사용할 AI 코딩 도구 하나(설치·로그인 완료)
  • GitHub 계정과 빈 저장소를 만들 준비
  • 프로젝트를 담을 빈 폴더
바닐라로 만듭니다

이 실전은 프레임워크 없이 HTML, CSS, JavaScript로 만듭니다. GitHub Pages는 이렇게 만든 정적 파일을 그대로 공개하기에 알맞습니다.

2단계

설계 문서를 준비합니다

디자인을 분석표로 정리하고, PRD와 규칙 문서를 만듭니다. 자세한 작성법은 설계 교안에 있습니다.

설계 교안에서 문서 만들기
이 단계 완료 확인
  • 디자인 분석표에 색·폰트·간격·상태를 적었습니다.
  • PRD에 화면·완료 조건·제외 범위가 있습니다.
  • 사용할 도구에 맞는 규칙 파일을 폴더에 두었습니다.

3단계

도구를 연결합니다

도구 하나를 골라 Figma MCP를 연결합니다. 도구별 연결 방법은 도구 교안에 있습니다.

도구 교안에서 Figma MCP 연결
이 단계 완료 확인
  • 도구에서 Figma MCP가 연결됨으로 표시됩니다.
  • Figma에서 만들 프레임의 링크를 복사했습니다.

4단계

메인페이지를 섹션 단위로 만듭니다

한 번에 전체를 요청하지 않고, 공통 구조부터 시작해 섹션을 하나씩 이어서 만듭니다.

  1. 1
    공통 구조 먼저

    header, nav, main, footer 같은 공통 뼈대와 디자인 토큰을 먼저 만듭니다.

  2. 2
    히어로 섹션

    가장 위 첫 화면부터 만들고 디자인과 대조합니다.

  3. 3
    본문 섹션

    그다음 섹션을 하나씩 이어서 만듭니다. 한 번에 전체를 요청하지 않습니다.

  4. 4
    인터랙션

    구조가 끝난 뒤 디자인에 있는 움직임만 더합니다.

  5. 5
    반응형 마무리

    360px, 768px, 1280px에서 무너지는 곳을 고칩니다.

도구에 전달할 요청문

도구 교안과 같은 요청문을 사용합니다. 설계 문서를 먼저 읽게 한 뒤 Figma 링크와 함께 화면을 요청합니다. 요청문 전문은 도구 교안에 정리되어 있습니다.

도구 교안에서 작업 요청문 보기

5단계

디자인에 있는 움직임을 더합니다

구조가 끝난 뒤 인터랙션을 넣습니다. 디자인에 실제로 있는 동작만 만들고, 복잡한 모션은 라이브러리를 골라 요청문에 적습니다. 어떤 라이브러리를 언제 쓰는지는 도구 교안의 선택표에 정리되어 있습니다.

도구 교안에서 인터랙션 라이브러리 선택표 보기

6단계

배포 전에 검수합니다

배포하면 주소로 공개되므로, 올리기 전에 브라우저에서 직접 확인합니다. 디자인 일치·반응형·인터랙션·접근성·콘솔을 도구 교안의 검수 항목대로 점검합니다.

도구 교안에서 검수 항목 보기

7단계

GitHub Pages로 사이트를 공개합니다

검수를 마쳤으면 마지막으로 사이트를 공개합니다. 만든 정적 파일을 GitHub에 올리고 저장소 설정에서 Pages를 켜면 누구나 볼 수 있는 github.io 주소가 생깁니다.

저장소 만들기와 push, Pages 설정, 상대경로·.nojekyll 같은 배포 주의사항은 GitHub 교안에 정리되어 있습니다. 그 순서를 그대로 따라 하면 됩니다.

GitHub 교안에서 Pages 배포하기
공개 전 마지막 확인

배포하면 주소로 누구나 볼 수 있습니다. 상대경로로 이미지·CSS·JS가 정상 표시되는지 검수 단계에서 확인한 뒤 올립니다.

완성

디자인이 공개된 사이트가 되었습니다

여기까지 마치면 디자인 시안 하나에서 시작해 공개된 웹사이트까지 완성한 것입니다.

통합 실전 완료 확인
  • 설계 문서를 만들고 도구에 전달했습니다.
  • 메인페이지를 섹션 단위로 만들고 디자인과 대조했습니다.
  • 디자인에 있는 인터랙션만 넣었습니다.
  • 360px, 768px, 1280px에서 가로 스크롤 없이 보입니다.
  • GitHub에 push하고 GitHub Pages 주소에서 사이트가 열립니다.
  • 이미지·CSS·JS가 상대경로로 정상 표시됩니다.

축하합니다

이제 다른 디자인으로 혼자 반복해 봅니다

같은 순서를 새 디자인에 적용하면, 설계부터 배포까지 스스로 사이트를 만들 수 있습니다.

디자인만 있는 상태에서 GitHub Pages까지 바이브메이킹 통합 실전 | 복붙랩