PageRivet User Guide

PageRivet 사용 가이드

프로젝트를 시작하고 코드를 편집하는 방법부터 미리보기, 검증, 복구, 내보내기와 MCP 기반 AI 협업까지 작업 순서에 따라 안내합니다.

01 · Getting Started

다운로드 및 실행

PageRivet은 Windows에서 실행되는 포터블 데스크톱 애플리케이션입니다. 설치 과정 없이 다운로드한 패키지를 준비해 실행할 수 있습니다.

1

다운로드

GitHub Releases에서 내려받거나, 이 다운로드 버튼을 눌러 최신 PageRivet 패키지를 다운로드합니다.

2

파일 준비

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

3

실행

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

02 · Project

프로젝트 시작

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

새 프로젝트

  1. 새 프로젝트 만들기를 선택합니다.
  2. 프로젝트 이름과 저장할 위치를 지정합니다.
  3. 생성된 기본 파일을 확인하고 작업을 시작합니다.

기존 프로젝트

  1. 기존 프로젝트 열기를 선택합니다.
  2. HTML, CSS, JavaScript 파일이 있는 프로젝트를 선택합니다.
  3. 파일 목록과 미리보기 페이지를 확인합니다.
파일 관리여러 HTML, CSS, JavaScript 파일을 생성하고 이름을 변경하거나 삭제할 수 있습니다. 작업 전 현재 선택한 파일을 확인하세요.
03 · Editor

코드 편집과 적용

PageRivet은 편집 중인 코드와 프로젝트에 적용된 상태를 구분합니다. 코드를 입력하는 즉시 적용하지 않고 검증을 거쳐 정상 상태를 반영합니다.

  1. 파일 선택프로젝트 목록에서 편집할 HTML, CSS 또는 JavaScript 파일을 선택합니다.
  2. 코드 편집구문 강조, 줄 번호, 검색과 줄 이동 기능을 이용해 코드를 수정합니다.
  3. 변경 상태 확인저장되지 않았거나 아직 적용되지 않은 변경이 있는지 확인합니다.
  4. 적용 및 검증변경을 적용하면 PageRivet이 코드를 검증하고 정상적인 변경을 프로젝트에 반영합니다.
  5. 결과 확인미리보기와 오류·콘솔 영역에서 적용 결과를 확인합니다.
적용되지 않은 편집 내용

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

04 · Preview

웹 페이지 미리보기

WebView2 기반 미리보기에서 적용된 프로젝트 결과를 확인합니다.

  • 미리볼 HTML 페이지를 선택합니다.
  • 코드를 적용한 뒤 미리보기가 갱신되는지 확인합니다.
  • CSS 디자인과 JavaScript 동작을 확인합니다.
  • 더 넓게 확인하려면 미리보기를 최대화하고 필요할 때 복원합니다.
기준 상태미리보기는 에디터에 입력만 한 내용이 아니라 프로젝트에 적용된 코드를 기준으로 표시됩니다.
05 · Validation

검증과 오류 확인

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

코드 검증

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

실행 진단

  • JavaScript 실행 예외 확인
  • 브라우저 콘솔 메시지 확인
  • 관련 파일을 수정한 뒤 다시 적용
  • 미리보기에서 결과 재확인
여러 파일 변경관련된 여러 파일은 하나의 변경 단위로 적용됩니다. 일부 파일만 변경된 불완전한 상태가 남지 않도록 검증 결과를 확인하세요.
06 · History

히스토리와 복구

변경 기록을 확인하고 이전 상태로 돌아갈 수 있습니다. 복원해도 기존 기록은 삭제되지 않으며, 복원 결과 역시 새로운 변경으로 기록됩니다.

  • Undo와 Redo로 최근 편집 흐름을 이동합니다.
  • 히스토리에서 저장된 변경 시점을 확인합니다.
  • 필요한 과거 상태를 선택해 현재 프로젝트에 복원합니다.
  • 복원 후 미리보기와 검증 결과를 다시 확인합니다.
복원 전 확인

현재 에디터에 아직 적용되지 않은 변경이 있다면 먼저 내용을 확인하세요. 복원 대상과 현재 상태를 비교한 뒤 진행하는 것이 안전합니다.

07 · External Changes

외부 파일 변경 처리

PageRivet 외부의 편집기나 AI 도구가 프로젝트 파일을 변경한 경우에도 변경을 감지하고 검증 흐름 안에서 관리할 수 있습니다.

  1. 변경 감지프로젝트 파일이 외부에서 수정되었는지 확인합니다.
  2. 재검증변경된 HTML, CSS, JavaScript를 다시 검증합니다.
  3. 상태 반영정상적인 변경을 프로젝트 상태에 반영합니다.
  4. 기록 확인반영된 외부 변경이 히스토리에 기록됐는지 확인합니다.
08 · Export

프로젝트 내보내기

PageRivet 프로젝트는 일반적인 HTML, CSS, JavaScript 파일로 유지됩니다. 목적에 맞는 방식으로 내보내 다른 도구나 배포 환경에서도 사용할 수 있습니다.

1

프로젝트 폴더

정적 웹 프로젝트의 파일 구조를 폴더 형태로 내보냅니다.

2

ZIP

프로젝트 전체를 하나의 압축 파일로 내보냅니다.

3

코드 복사

필요한 코드를 복사해 다른 편집기나 서비스에서 사용합니다.

09 · MCP & AI

MCP와 AI 클라이언트 연결

PageRivet의 로컬 MCP 서버를 사용하면 지원되는 AI 클라이언트가 활성 프로젝트를 읽고 분석하며, 검증과 승인 과정을 거쳐 변경을 적용할 수 있습니다.

  1. 프로젝트 준비AI와 작업할 프로젝트를 PageRivet에서 열고 활성 상태를 확인합니다.
  2. MCP 서버 실행PageRivet에서 로컬 MCP 서버를 실행합니다.
  3. AI 클라이언트 연결사용 중인 MCP 지원 AI 클라이언트에 PageRivet 연결을 설정합니다.
  4. 자연어로 요청원하는 작업과 대상 페이지를 구체적으로 설명합니다.
  5. 변경 검토AI가 제안한 변경 범위, 검증 결과와 승인 요청을 확인합니다.
요청 예시

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

10 · Troubleshooting

자주 확인할 문제

미리보기가 바뀌지 않아요

편집 내용이 프로젝트에 적용됐는지 확인하고 검증 오류가 없는지 살펴보세요.

코드 적용이 실패해요

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

외부 변경이 보이지 않아요

외부 변경 감지 상태와 현재 에디터의 미적용 변경 여부를 함께 확인하세요.

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

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

이전 상태로 돌아가고 싶어요

히스토리에서 원하는 시점을 선택하고 현재 상태와 비교한 뒤 복원하세요.

JavaScript가 동작하지 않아요

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

11 · Support

지원 및 문의

가이드로 해결되지 않는 문제는 아래 채널에서 프로젝트 정보와 재현 절차를 함께 알려주세요.