PageRivet User Guide

PageRivet 사용 가이드

다운로드와 프로젝트 시작부터 편집, 미리보기, 검증, 내보내기와 MCP 기반 AI 협업까지 작업 순서에 따라 안내합니다.

01 · Getting Started

다운로드 및 실행

PageRivet은 Windows x64에서 실행되는 포터블 데스크톱 애플리케이션입니다. 설치 과정 없이 공식 패키지를 내려받아 시작할 수 있습니다.

1

다운로드

다운로드를 눌러 PageRivet 패키지를 내려받습니다.

2

파일 준비

다운로드한 ZIP 파일을 작업하기 편한 위치에 풀어둡니다.

3

실행

PageRivet 실행 파일을 열고 시작 화면이 표시되는지 확인합니다.

02 · Project

프로젝트 시작

새 정적 웹 프로젝트를 만들거나 기존 HTML, CSS, JavaScript 프로젝트를 열어 작업할 수 있습니다.

새 프로젝트

  1. 상단의 "프로젝트" 버튼을 누른 뒤 "새 프로젝트"를 선택합니다.
  2. 프로젝트를 저장할 위치를 선택하고 이름을 설정합니다. 지정한 위치에 프로젝트 이름의 폴더가 생성됩니다.
  3. 생성된 기본 파일을 확인하고 작업을 시작합니다.

기존 프로젝트

  1. 상단의 "프로젝트" 버튼을 누른 뒤 "프로젝트 열기"를 선택합니다.
  2. 웹 소스가 있는 프로젝트 폴더를 선택합니다.
  3. 파일 목록과 미리보기 페이지를 확인합니다.
파일 관리페이지, 스타일, 스크립트와 관리 리소스는 프로젝트 상대 경로를 기준으로 관리합니다. 작업 전 현재 선택한 파일을 확인하세요.
03 · Editing

코드 편집과 적용

PageRivet은 에디터에서 수정 중인 내용과 프로젝트에 적용된 상태를 구분합니다. 변경 범위를 확인하고 검증을 거쳐 정상 상태를 반영합니다.

  1. 파일 선택프로젝트 목록에서 편집할 HTML, CSS 또는 JavaScript 파일을 선택합니다.
  2. 코드 편집필요한 내용을 편집기에서 수정하고 파일의 변경 범위를 함께 확인합니다.
  3. 변경 상태 확인아직 적용되지 않은 편집 내용이 있는지 확인합니다.
  4. 검증 및 적용HTML, CSS, JavaScript 검증 결과를 확인하고 유효한 변경을 프로젝트에 적용합니다.
  5. 결과 확인미리보기와 오류·콘솔 영역에서 적용 결과를 확인합니다.
미적용 편집 내용

에디터에 입력한 내용과 실제 프로젝트 상태가 다를 수 있습니다. 파일을 전환하거나 AI 작업을 시작하기 전에 미적용 변경 여부를 확인하세요.

04 · Preview

웹 페이지 미리보기

프로젝트에 존재하는 HTML 페이지를 미리보기에 표시하고, 적용된 결과를 기준으로 화면과 동작을 확인합니다.

  • 미리볼 HTML 페이지를 선택합니다.
  • 코드를 적용한 뒤 미리보기를 새로고침합니다.
  • CSS 디자인과 JavaScript 동작을 확인합니다.
  • 오류가 있으면 콘솔 정보와 관련 파일을 함께 확인합니다.
표시 기준미리보기는 현재 활성 프로젝트에 존재하며 프로젝트에 적용된 HTML 페이지를 기준으로 표시됩니다.
05 · Validation

검증과 오류 확인

변경사항을 적용하기 전에 정적 구문 문제를 확인하고, 실행 중 발생한 문제는 미리보기 오류와 콘솔 정보에서 구분해 확인합니다.

코드 검증

  • HTML 구조 확인
  • CSS 구문 오류 확인
  • JavaScript 구문 오류 확인
  • 파일·줄·열 기준 문제 위치 확인

실행 진단

  • JavaScript 실행 예외 확인
  • 브라우저 콘솔 메시지 확인
  • 관련 파일 수정 후 다시 적용
  • 미리보기에서 결과 재확인
여러 파일 변경서로 관련된 파일은 하나의 변경 단위로 검토하고, 전체 검증 결과를 확인한 뒤 적용하세요.
06 · MCP & AI

MCP와 AI 클라이언트 연결

PageRivet의 로컬 MCP 서버를 사용하면 지원되는 AI 클라이언트가 활성 프로젝트를 읽고 분석하며, 현재 승인 정책과 검증 절차에 따라 허용된 변경을 요청할 수 있습니다.

  1. 프로젝트 준비AI와 작업할 프로젝트를 PageRivet에서 열고 활성 상태를 확인합니다.
  2. MCP 서버 실행상단의 "설정" 버튼을 누른 뒤 "MCP 설정"을 선택합니다.
  3. AI 클라이언트 연결사용자 PC에 설치된 AI 클라이언트 목록을 확인하고, 사용할 클라이언트의 [연결] 버튼을 눌러 PageRivet과 연결합니다.
  4. AI 클라이언트와 연결 확인AI클라이언트와 연결을 확인합니다. "PageRivet MCP 핸드셰이크 확인해줘"
  5. 자연어로 요청원하는 웹 작업과 대상 페이지를 구체적으로 설명합니다.
  6. 변경 검토제안된 변경 범위와 검증 결과를 확인하고, 현재 승인 정책에 따라 적용합니다.
요청 예시

“현재 페이지의 모바일 메뉴가 깨지는 원인을 확인하고, 기존 디자인을 유지하면서 수정해줘.”

07 · Export

프로젝트 내보내기

출력 형식과 위치를 지정해 프로젝트를 배포하거나 전달할 수 있는 결과물로 내보냅니다.

  1. 내보내기 열기상단의 "프로젝트" 버튼을 누른 뒤 "내보내기"를 선택하거나, 상단 메뉴의 "내보내기" 버튼을 누릅니다.
  2. 프리셋 선택내보내기 프리셋을 선택합니다. 기본 프리셋은 "General Web"이며, 필요하면 다른 프리셋으로 변경할 수 있습니다.
  3. 출력 형식 선택프로젝트에 필요한 출력 형식을 선택합니다.
  4. 내보내기 실행출력 위치를 지정한 뒤 "내보내기" 버튼을 누릅니다. 선택한 폴더 아래에 프로젝트 이름의 폴더가 생성되고 내보내기가 완료됩니다.
검증 오류

검증 오류가 있는 작업은 자동 적용 정책에서도 실행되지 않습니다. 오류를 해결한 뒤 다시 요청하세요.

08 · Troubleshooting

자주 확인할 문제

미리보기가 바뀌지 않아요

편집 내용이 프로젝트에 적용됐는지 확인하고 현재 페이지를 새로고침하세요.

코드 적용이 실패해요

오류 목록에서 파일과 줄 위치를 확인하고 관련 코드를 수정한 뒤 다시 적용하세요.

AI가 프로젝트를 읽지 못해요

활성 프로젝트, MCP 서버 상태와 AI 클라이언트 연결 설정을 확인하세요.

JavaScript가 동작하지 않아요

구문 검증뿐 아니라 실행 오류와 브라우저 콘솔 메시지도 함께 확인하세요.

09 · Support

지원 및 문의

가이드로 해결되지 않는 문의 사항이나 건의 사항은 Discord 또는 이메일로 남겨 주세요. Discord를 이용하면 더 빠르게 지원받을 수 있습니다.