1인 개발: kimura512.dev 첫 공개 직전까지 점검한 실전 체크리스트

히어로 이미지

핵심 결론

kimura512.dev를 처음 공개했을 때 가장 많은 시간을 쏟은 것은 기능 구현이 아니라 '제3자가 안심하고 읽을 수 있는 상태'를 만드는 작업이었습니다. 로컬에서 아무리 잘 돌아가도 운영자가 누구인지, 어디로 문의해야 하는지, 개인정보를 어떻게 다루는지 불명확한 사이트는 포트폴리오로서 신뢰를 주기 어렵습니다. 첫 공개 전 About, Privacy, Contact 도선과 최소한의 블로그 글을 한 마일스톤에 묶어 처리했습니다.

1. 리포지토리와 빌드 규칙

로컬 환경은 pnpm으로 의존성을 엄격히 고정하고, 운영 배포는 pnpm run build 후 wrangler deploy를 실행하는 파이프라인을 유지합니다. API 키는 Cloudflare Workers의 암호화된 시크릿에만 보관하며 리포지토리에는 .env 파일을 일절 포함하지 않습니다. 배포 시 혼선을 방지하기 위해 "빌드가 통과하지 않는 커밋은 운영에 올리지 않는다"는 원칙을 세웠으며, 푸시 전 빌드 테스트는 라우팅과 타입 불일치를 사전 차단하는 필수 습관이 되었습니다.

2. 배포 전 시각적 점검 목록

배포 전에는 브라우저에서 직접 핵심 요소를 확인합니다. 메인 페이지에 'Coming Soon' 상태의 미완성 링크가 방치되어 있지 않은지, 다국어 프리픽스 URL이 404를 반환하지 않는지, 소셜 공유용 메타태그가 정상 노출되는지, 문의 폼이 실제로 정상 수신되는지를 점검합니다. 체크리스트를 문서로 명문화해 두면 릴리스 시의 실수를 크게 줄일 수 있습니다.

3. 콘텐츠의 최소 기준선

프로젝트 카드만 나열된 사이트는 단순 작업물 목록에 그치기 쉽습니다. 기술 선정 배경과 시행착오를 담은 실전 글을 사전에 준비하여, 인사말만 덩그러니 남은 빈약한 공개를 피했습니다. 발행 기준은 "내가 읽어도 문제 해결에 도움이 되는가"로 잡았습니다. 첫 오픈 시점에 읽을 만한 깊이 있는 글이 존재하면 향후 협업이나 외부 제안이 들어왔을 때 든든한 신뢰의 근거가 됩니다.

4. 배포 직후 네트워크 검증

운영 도메인 배포 직후에는 블로그 목록, 개별 글, 개인정보처리방침 페이지가 정상적으로 HTTP 200 응답을 반환하는지 확인합니다. 검색 콘솔 등록은 이후에 진행하더라도, 실수로 남겨진 noindex 태그는 즉시 바로잡아야 합니다. 브라우저 캐시로 인해 구버전이 보이는 현상을 막기 위해 시크릿 창에서 소스 코드를 직접 검증하는 루틴을 유지합니다.

5. 도메인 통일과 문의 창구

모든 외부 문의 창구는 info@kimura512.dev로 일원화하고, 문의 폼의 전송 대상과 소개 페이지 및 푸터의 안내 문구를 일치시켰습니다. 페이지마다 표기된 이메일이 다르면 이용자뿐 아니라 운영자 본인도 혼선을 겪습니다. 매 릴리스마다 테스트 메일을 직접 전송하여 수신을 확인한 뒤 배포 완료 판정을 내립니다.

6. 전역 내비게이션 동선 설계

모든 하위 페이지 푸터에서 블로그, 소개, 개인정보처리방침, 문의 페이지로 1클릭 내에 도달할 수 있도록 동선을 정리했습니다. 미완성 프로젝트 카드는 과감히 메인에서 제외하여, 사이트를 처음 방문한 사람이 혼란 없이 신뢰할 수 있는 정보에 집중하도록 구성했습니다.

7. 로컬과 운영 환경의 차이 검증

로컬 개발 환경의 핫 리로드는 운영 환경 고유의 라우팅 동작 차이를 가리기 쉽습니다. 언어별 경로 리다이렉트와 Workers API 엔드포인트를 통한 문의 메일 발송 흐름은 실제 프로덕션 빌드 배포 후 반드시 재검증합니다.

8. 포트폴리오와 블로그의 역할 분담

메인 페이지는 완성된 프로덕트를 간결하게 보여주고, 상세한 기술적 여정과 의사결정 기록은 블로그에 위임했습니다. 릴리스 직후 일주일간은 신규 기능 추가를 멈추고 오탈자 교정, 외부 링크 유효성 검증, 정책 문서 정합성 맞추기에만 집중했습니다. 출시된 자산의 신뢰도를 단단히 다지는 것이 기능 나열보다 앞서야 합니다.

요약

첫 출시는 완벽함보다는 '외부에 설명 가능한 정돈된 상태'를 갖추는 것으로 충분합니다. 인프라, 정책 문서, 깊이 있는 글을 같은 주기에 정비해 두면 사이트의 장기적인 신뢰가 안정적으로 확보됩니다.

자주 묻는 질문

Q. 가장 빠르게 완성도 있는 사이트를 공개하려면?
소개, 개인정보처리방침, 문의 창구, 기술 글 2편, 미완성 프로젝트 카드 정리를 단일 마일스톤으로 묶어 처리하십시오. 이 기반이 마련되면 이후 운영이 매우 수월해집니다.

Q. 정식 도메인 연결 전 테스트는 몇 번 거쳤는가?
프리뷰 Workers에서 3회 배포 테스트를 거쳤고, 메인 도메인 연결 후 전체 경로 검증을 2회 진행했습니다. 프리뷰 환경을 적극 활용하면 운영 사고를 미연에 방지할 수 있습니다.