검색이 안 될 때

검색이 동작하지 않는 경우

개발 서버에서 검색이 안 됨

pnpm dev 개발 서버에서는 Pagefind 검색 인덱스가 생성되지 않아 검색이 완전하게 동작하지 않을 수 있습니다.
이는 정상적인 동작입니다.

해결 방법

Pagefind 검색 인덱스는 pnpm build 실행 시 dist/pagefind/ 경로에 자동 생성됩니다.
검색 기능은 다음 환경에서 확인하세요.

pnpm build
pnpm preview

pnpm preview 실행 후 브라우저에서 사이트를 열고 ⌘K(또는 Ctrl+K)를 눌러 검색창을 활성화하세요.

---

배포 환경에서 검색이 안 됨

staging 또는 production 환경에서 검색이 동작하지 않는다면 아래를 확인하세요.

1. 빌드 성공 여부: 배포 전 pnpm build가 성공적으로 완료되었는지 확인합니다.
2. pagefind 디렉토리 존재 여부: dist/pagefind/ 디렉토리가 배포 결과물에 포함되어 있는지 확인합니다.
3. CloudFront 캐시: 배포 후 CloudFront 캐시 무효화가 실행되었는지 확인합니다.

---

추가 문의

위 방법으로 해결되지 않는다면 GitHub Issues 또는 PR을 통해 문의하세요.