Skip to content

feat: 크롬 확장 MVP (우클릭 메뉴·툴바 아이콘으로 동네 도서관에서 찾기) - #91

Merged
afrontend merged 1 commit into
masterfrom
feat/chrome-extension
Nov 13, 2026
Merged

afrontend merged 1 commit into
masterfrom
feat/chrome-extension

Conversation

@afrontend

Copy link
Copy Markdown
Owner

요약

성장 로드맵 1단계(유입 경로)의 마지막 항목입니다. 웹에서 본 책 제목을 드래그해 우클릭 메뉴나 툴바 아이콘으로 /?title=…&ref=ext 를 새 탭으로 엽니다. 도서관은 넣지 않으므로 사이트가 내 도서관에서 찾고(#84), GA 에서는 entry_ref=ext 로 구분됩니다(#82, #87).

변경

  • extension/manifest.json: Manifest V3. 권한은 contextMenus, activeTab, scripting 만.
  • extension/background.js: 우클릭 메뉴 📚 동네 도서관에서 "…" 찾기, 툴바 아이콘(누를 때만 선택 텍스트를 읽고, 선택이 없거나 chrome:// 같은 페이지면 사이트만 엶). 새 탭은 현재 탭 바로 옆에 엽니다.
  • extension/searchUrl.js: 검색 주소 만들기 (공백 정리, 100자 제한). 테스트를 vitest.config.node.ts 에 포함.
  • extension/icons/: 사이트 로고의 책 더미를 잘라 만든 16·32·48·128px.
  • extension/README.md 와 README 에 설치 방법(압축해제된 확장 프로그램 로드).
  • 옵션 페이지·페이지 자동 읽기·스토어 등록은 이번 범위가 아닙니다.

Test Plan

  • npm run typecheck 통과, npm test 32 + 232개 통과 (새 테스트 4개), npm run build 통과
  • 수동 확인 (머지 전 가능, 배포와 무관):
    1. chrome://extensions → 개발자 모드 → 압축해제된 확장 프로그램 로드 → extension/
    2. 아무 사이트에서 제목 드래그 → 우클릭 메뉴 → 새 탭에서 내 도서관 검색
    3. 제목 드래그 → 툴바 아이콘 → 같은 결과. 선택 없이 누르면 사이트만 열림
    4. GA 실시간 보고서에 page_view·search, 하루 뒤 entry_ref=ext

웹에서 본 책 제목을 드래그해 /?title=…&ref=ext 를 새 탭으로 연다. 도서관은 넣지 않아
사이트가 내 도서관에서 찾고, GA 에서는 entry_ref=ext 로 구분된다.

- extension/: Manifest V3, 빌드 없는 순수 JS
- 우클릭 메뉴(contextMenus)와 툴바 아이콘(activeTab·scripting, 누를 때만 선택 텍스트 읽기)
- 검색 주소 만들기를 searchUrl.js 로 분리하고 node 테스트에 포함
- 아이콘은 사이트 로고의 책 더미를 잘라 16·32·48·128px 로 만듦
- 설치 방법(압축해제된 확장 프로그램 로드)은 extension/README.md
@afrontend
afrontend merged commit b6e008c into master Nov 13, 2026
1 check passed
@afrontend
afrontend deleted the feat/chrome-extension branch November 13, 2026 15:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant