{"_id":"@archerinteractive/bullseye","_rev":"11-3ddce08ad00137dfccfb59a4475e75fb","name":"@archerinteractive/bullseye","dist-tags":{"latest":"0.9.0"},"versions":{"0.6.8":{"name":"@archerinteractive/bullseye","version":"0.6.8","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.8","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"7f7c130ab7e406ee861cfb9b72e976fda031bb5c","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.8.tgz","fileCount":3,"integrity":"sha512-ZE8wV92zKI3GVDdAYKyTl+VFsu/7yYwXlk4yn/OuiczhTuts4+rF9v/OPuOqU/jNmkLc0ZJeFuNEz1mNOhQUBg==","signatures":[{"sig":"MEUCIBwdFBIzVewHTY6owRx4V5nbqOiJnx4mF7/Flx+CebseAiEA4V7XCLZnBLFMn2BAyigbqyd+XC2s/j0XqYo1nKsTvwc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29151},"main":"dist/development-tools.js","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.8_1778814372934_0.39145422704829436","host":"s3://npm-registry-packages-npm-production"}},"0.6.9":{"name":"@archerinteractive/bullseye","version":"0.6.9","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.9","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"12917e751ba4af81a1d4657074ba6ea2b967aecc","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.9.tgz","fileCount":4,"integrity":"sha512-PT46d9WBw8r1W7w4rqgzzgy9Pqr45mCFXX6lkecUidq05N4msi6g/jGHPZydihg6XAo0Mxgf8l8cLqThy86ukg==","signatures":[{"sig":"MEYCIQDPLS5kV4mLWfzfxLJ0fdVQHxSZ332/SEwTixl9J7ySTgIhAIK05FWEAqmbEb6wMfEBCCnf3DdsVaBmwVIo7jFZWkL2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33730},"main":"dist/development-tools.js","gitHead":"bf8875a685a7141aa91abed83c20b7842cfd8d09","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"11.12.1","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.9_1778816818960_0.9955129419904052","host":"s3://npm-registry-packages-npm-production"}},"0.6.12":{"name":"@archerinteractive/bullseye","version":"0.6.12","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.12","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"08f6856f8b1bc0b275442b1902975083de3c8309","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.12.tgz","fileCount":4,"integrity":"sha512-6UyIepxRgMgEI48Cx1JL+6PDa/sY9rwbgW4LTkIW9AjKGiPisxACQim1AnDcUEHGm+aVcJmcA23v3L07uq92dw==","signatures":[{"sig":"MEUCIQCgc/N3273Df6n76rFDHLPD/Yb9phcf1mDXHYiC9w7XkAIgBqnFRlVDw8nLFMWLKC1ZHeIO7hXgaw7wLozr+LJZ+os=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37709},"main":"dist/development-tools.js","gitHead":"bf8875a685a7141aa91abed83c20b7842cfd8d09","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"11.12.1","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.12_1778818751052_0.9701058361249004","host":"s3://npm-registry-packages-npm-production"}},"0.6.13":{"name":"@archerinteractive/bullseye","version":"0.6.13","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.13","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"3492d8e32ce5cdf1c41faa15329a3967c7cb5d92","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.13.tgz","fileCount":4,"integrity":"sha512-qPygCFoZh3uNNok9orLRBV5JAlCJpRAXVaqbzaECwoe2CumWSAksKmXdxXmH0Qs3Q3Bs8l80fXADHTKIdX2T8A==","signatures":[{"sig":"MEUCIQDspBbpZ726JQloDp0kmTGtU/9xWXh+8sowJ6UhwBtfigIgRLXtRu9TY4QJI520wj6mw/F3aTZjFhzIMCnmxheMjfo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40943},"main":"dist/development-tools.js","gitHead":"bf8875a685a7141aa91abed83c20b7842cfd8d09","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"11.12.1","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.13_1778821898115_0.949582207995161","host":"s3://npm-registry-packages-npm-production"}},"0.6.15":{"name":"@archerinteractive/bullseye","version":"0.6.15","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.15","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"423c933492192c9c661bdc48ed9a7a26e5424396","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.15.tgz","fileCount":4,"integrity":"sha512-Nv1BfLmbeJar4CQxWWerSSg5cD+UAby+GYuq3k1yF+IMMbdMNjEE6jQ/kI9O16Sp0YloJ5V801bZ6aDrSZ/C/A==","signatures":[{"sig":"MEUCIQDy2eersUJ+bb3zvSG2G9OiBWFAszbTNMH5vzfedSN4bAIgenWTdH04Jl0oDzHeNJ1jzwle/UQOq0MSUO9sYmUOZlw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45059},"main":"dist/development-tools.js","gitHead":"a59ca9793cf2a6d58a61bde0be132bbf6a06af20","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.15_1779297735189_0.6404714228188348","host":"s3://npm-registry-packages-npm-production"}},"0.6.16":{"name":"@archerinteractive/bullseye","version":"0.6.16","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.16","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"461f0f619c3a2302b497bde730afd7d2692d0e29","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.16.tgz","fileCount":4,"integrity":"sha512-LBh9D4g7gs9sJPdrFLMbfUQpsjc4owlP4E/s9DacjQtow44jIj43Ou/nN3qcEc+QCbXSkhPh9d+Kwqn2pT5j5w==","signatures":[{"sig":"MEUCIQD+Xz+vjn9MeRPVa+Q+xd3vqLIWzM9h816T0Azt9WfuYQIgMjFqGHUuGSoPaomFUMcPFkZ96oqYMYJYHJlIoANL4rk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46009},"main":"dist/development-tools.js","gitHead":"a59ca9793cf2a6d58a61bde0be132bbf6a06af20","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.16_1780511548985_0.58978175263441","host":"s3://npm-registry-packages-npm-production"}},"0.6.17":{"name":"@archerinteractive/bullseye","version":"0.6.17","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.6.17","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"982eb7ed1b2f18bc1a390cac85efc751bfedb8d5","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.6.17.tgz","fileCount":4,"integrity":"sha512-EAC31wtkHVJxYo9tEEAw4xYO6fnyMuUDzgTbj2EAjcRcRRKgHf+ekb3VxKLlSHWqsqD6MxJFJthbYrlZ4LEG1A==","signatures":[{"sig":"MEUCIHrAuxhJZv+kON6pc7a3i6xtpYZX9vrlfVDYymAjS9tIAiEAohPhqnTW3MlxrMzoLlennu9GbEkKuH1sumTGyeHXmhU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47022},"main":"dist/development-tools.js","gitHead":"69a0fe96bed02c549f1bc59ae23c5b67cf5c47f8","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.6.17_1786464553148_0.4661179171129597","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@archerinteractive/bullseye","version":"0.7.0","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.7.0","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"2f7b74ff462cc506d4adfb1b92ff13ab77304113","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.7.0.tgz","fileCount":4,"integrity":"sha512-TAyf1VkE5vwjmBDH2b0eiL+IhIs6Vx+rt6DPc5091FBq60kus6Nos5jISqNDUnhpvM8giz8NKK1PlPH2HIy7hg==","signatures":[{"sig":"MEQCICLBZi3sbFIROZ+XE/cJM+0tqfe7na4RU2L7BtZ1xv34AiA5m1rZUlmPZ/wfy/4gbIw7VQVnGVtE/iyclpWI1xWMmQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51416},"main":"dist/development-tools.js","gitHead":"284b8b53f4179f6bdfa8d912f4446b870e6438d1","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.7.0_1788441932875_0.5671864220932208","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@archerinteractive/bullseye","version":"0.8.0","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.8.0","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"cc170e3261c72d763bfd0b3666b3cad2902be92a","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.8.0.tgz","fileCount":5,"integrity":"sha512-cQymo42hNoBLIvGU6j2SV3f5z9eaXtY/JztethovK65tsN5ucrcwAfNqTE/zGcgcTENktfk39Y8p2uYGGQkWJw==","signatures":[{"sig":"MEUCIQCyOQAx3gsVDHJB7YUZ9Fb2Ab7eX6hupTtASZRrjt7V4gIgMqPJrW9IhFkXGJpQoyHqDX2AbuLSlTcHPlMDMbYszDw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55843},"main":"dist/development-tools.js","gitHead":"d5f3a86423877c082003eeb5f3c9c9eb8bf4d290","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.8.0_1788788551985_0.5343287899787716","host":"s3://npm-registry-packages-npm-production"}},"0.8.1":{"name":"@archerinteractive/bullseye","version":"0.8.1","keywords":["dev-tool","pixel-checking","browser-sync","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","_id":"@archerinteractive/bullseye@0.8.1","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"dist":{"shasum":"aa07ee100923332fb27060d76c111e7405d25aae","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.8.1.tgz","fileCount":5,"integrity":"sha512-rTRIMWlRHYmHyZixonCYaZUL4ynaqR49D8X1k7omhcXrjCOUnUXzWJmtJV5g3MkJ5QLfHZy9dOSHBoBWkakpPQ==","signatures":[{"sig":"MEYCIQDVaM+JJQslHM85pblFX09uyJ2q1robAgHToDbVcrVZHgIhAJv80Ib/sxFFXOwDsf4fVCfls7zkq7bVAJFEAV5BYDOj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54219},"main":"dist/development-tools.js","gitHead":"991537c432a411ebca24f98b1f6e5dac453847a1","scripts":{"build":"node scripts/build.js"},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"_npmVersion":"10.9.7","description":"Localhost-only BrowserSync overlay for pixel checking against PNG comps.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"terser":"^5.39.0"},"_npmOperationalInternal":{"tmp":"tmp/bullseye_0.8.1_1789051608700_0.13954376882250208","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"@archerinteractive/bullseye","version":"0.9.0","description":"Localhost-only BrowserSync and Vite overlay for pixel checking against PNG comps.","main":"dist/development-tools.js","scripts":{"build":"node scripts/build.js","test":"node --test tests/*.test.cjs"},"keywords":["dev-tool","pixel-checking","browser-sync","vite","astro","overlay","localhost"],"author":{"name":"Archer Interactive"},"license":"MIT","publishConfig":{"access":"public"},"devDependencies":{"terser":"^5.39.0"},"_id":"@archerinteractive/bullseye@0.9.0","gitHead":"45344680725c8a601488d3a8300b0ce2a2f5391e","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-buKmQwlH1YnL1oCv9rCrSf5zVA8cyfSEE55SYBZSVbIDw0TZxHOJLEoMW6ebSzOUGiKvUXezI0y+94eyacYrlw==","shasum":"53234321f6a918c276cd786112c7a375d0a140e6","tarball":"https://registry.npmjs.org/@archerinteractive/bullseye/-/bullseye-0.9.0.tgz","fileCount":6,"unpackedSize":56224,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDd2Ql1nUGu01Q31Vux24w68D42m381KmvWU4235HcBiwIgGE918Dz+WOvOC8W8vMX5HFYzhN720EYxBUNb+RgBOMo="}]},"_npmUser":{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"},"directories":{},"maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bullseye_0.9.0_1789052457689_0.938759726210286"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-15T03:06:12.831Z","modified":"2026-09-10T15:00:57.974Z","0.6.8":"2026-05-15T03:06:13.076Z","0.6.9":"2026-05-15T03:46:59.133Z","0.6.12":"2026-05-15T04:19:11.185Z","0.6.13":"2026-05-15T05:11:38.256Z","0.6.15":"2026-05-20T17:22:15.334Z","0.6.16":"2026-06-03T18:32:29.129Z","0.6.17":"2026-08-11T16:09:13.319Z","0.7.0":"2026-09-03T13:25:33.014Z","0.8.0":"2026-09-07T13:42:32.120Z","0.8.1":"2026-09-10T14:46:48.836Z","0.9.0":"2026-09-10T15:00:57.822Z"},"author":{"name":"Archer Interactive"},"license":"MIT","keywords":["dev-tool","pixel-checking","browser-sync","vite","astro","overlay","localhost"],"description":"Localhost-only BrowserSync and Vite overlay for pixel checking against PNG comps.","maintainers":[{"name":"alexmazzucca","email":"alexmazzucca@archerinteractive.com"}],"readme":"# Bullseye\n\nA localhost-only dev tool for pixel-checking PNG design comps against a live page, plus a viewport badge that shows current breakpoint and dimensions.\n\nBundled as a single minified file (`dist/development-tools.js`) that includes both tools. Supports BrowserSync and Vite (including Astro) on localhost.\n\n---\n\n## What's included\n\n### Viewport badge\n\nA small fixed badge in the top-left corner of the browser that shows the current viewport dimensions (`1440 x 900`). If the page uses a `--kindling-breakpoint` CSS variable, the badge also shows the active breakpoint (`bp: lg | 1440 x 900`). Click the badge to dismiss it.\n\nThe viewport badge is suppressed on detected banner pages so banner previews only show Bullseye.\n\n### Bullseye overlay\n\nA draggable panel for loading PNG comp images and overlaying them on the page at adjustable opacity. Useful for checking spacing, alignment, and proportions against a live build.\n\n---\n\n## Requirements\n\n- A local BrowserSync or Vite development server (including Astro)\n- The tool only initializes on `localhost`, `127.0.0.1`, `0.0.0.0`, or `::1`\n\n---\n\n## Setup\n\nAdd the script to your project's dev HTML, after BrowserSync's own injected script:\n\n```html\n<script src=\"node_modules/@archerinteractive/bullseye/dist/development-tools.js\"></script>\n```\n\nOr reference it from your build pipeline however you handle dev-only scripts.\n\n---\n\n## Using Bullseye\n\nPress **B** on any page running through BrowserSync or Vite to show or hide the panel. Vite is detected through its injected `/@vite/client` script, including base-prefixed URLs; no BrowserSync marker is needed.\n\n### Adding comps\n\n- Click **IMPORT ALL** to load PNGs directly inside `repo/references/` at **0.5 scale**. The folder is scanned only when clicked, never automatically on page load. Click again after adding PNGs to the folder; existing reference URLs are not duplicated, and saved layers keep their positions and scale.\n- **IMPORT ALL** reads the origin-root `/references/` folder without opening a folder picker. It uses directory links or `manifest.json`, `references.json`, or `images.json` exposed by your development server. See the setup below if your server does not list directories or serves from `dist/`.\n- Click **Add new** in the panel to open a file picker\n- In browsers that support the enhanced file picker, selecting from a repo's `references` folder once lets Bullseye reopen that folder on future adds when the browser allows it\n- Drag one or more PNG files directly onto the page while the panel is open\n\n### Serving the repo's references folder\n\nFor Vite or Astro, register the included Vite plugin:\n\n```js\nimport bullseyeReferences from '@archerinteractive/bullseye/vite.js';\n\n// vite.config.js\nexport default { plugins: [bullseyeReferences()] };\n\n// Astro: add vite: { plugins: [bullseyeReferences()] } to defineConfig().\n```\n\nIt serves the Vite root's `references/` folder only during development. If the repo root differs from Vite's root, pass `bullseyeReferences({ root: '/absolute/path/to/repo' })`. Reference files are not copied into production builds or served by the production preview server. Registration uses Vite's [development server hook](https://vite.dev/guide/api-plugin.html#configureserver).\n\nImport the browser overlay from your development entry (or an Astro component's `<script>`):\n\n```js\nif (import.meta.env.DEV) {\n  import('@archerinteractive/bullseye');\n}\n```\n\nKeep the development guard so the overlay is excluded from production builds. In Kindling's visual-check integration, keep the existing `__visual_check` exclusion as well.\n\nFor BrowserSync projects without a directory listing, add the included middleware to the existing BrowserSync configuration. Pass the repo root if your config runs from another directory:\n\n```js\nconst references = require('@archerinteractive/bullseye/references-middleware');\n\nbrowserSync.init({\n  server: { baseDir: 'dist' },\n  middleware: [references(process.cwd())]\n});\n```\n\nKeep any existing middleware in that array. This serves `/references/manifest.json` and the PNG files directly from `repo/references/`, with no copying or manual manifest updates. The helper accepts localhost connections only and does not serve other file types or nested folders.\n\nAlternatively, expose the folder with directory listings, or provide `references/manifest.json` containing filenames such as `[\"desktop.png\", \"mobile.png\"]` and serve those images at `/references/`. A browser script cannot list arbitrary files on disk without the dev server exposing them.\n\n### Working with layers\n\nEach loaded comp is a layer. Only one layer is active (visible) at a time — selecting a thumbnail activates that layer and deactivates the rest.\n\n| Control | What it does |\n|---|---|\n| **Show** | Toggles the active layer on or off |\n| **Lock** | Prevents the layer from being dragged |\n| **Reset** | Restores position to X: 0, Y: 0, scale: 1, opacity: 50% |\n| **Opacity slider** | Fades the comp over the page (default 50%) |\n| **✕** | Removes the layer |\n\n### Positioning\n\n- **Drag** the comp image directly to reposition it\n- Use **X / Y fields** for exact pixel placement\n- Use **Scale** to resize (0 to 4; arrow keys step by 0.25)\n\n### Alignment\n\nSnap the active layer using the alignment buttons:\n\n| Button | Behaviour |\n|---|---|\n| **Top** | Snaps layer to Y: 0 |\n| **Left** | Snaps layer to X: 0 |\n| **Center** | Centers the layer in the viewport and locks it there — the layer stays centered through resizes until you move it or align it left/right |\n| **Right** | Snaps layer to the right edge of the viewport |\n\n### Panel behaviour\n\n- The panel starts flush to the right edge of the browser\n- Drag the panel by its outer frame to reposition it — it snaps to viewport edges when dragged close\n- Use the **menu button** to collapse or expand the panel\n- Use the **close button** or press **B** to hide it\n- If a resize would push a moved panel off-screen, it snaps back to the right edge\n\n### Persistence\n\nLayer data (images and positions) is saved to `localStorage` per page URL, so your layers are restored when you reopen the same page. The panel always starts hidden on load.\n\n---\n\n## GSAP timeline controls\n\nOn detected banner pages, Bullseye shows a banner below the comp with playback controls when it finds a usable GSAP timeline:\n\n- **Play / Pause** toggle\n- **Scrubber** to seek through the timeline\n- **Timestamp** showing the current position in minutes, seconds, and milliseconds (`MM:SS.mmm`)\n\nBanner detection uses the `ad.size` meta tag or common fixed ad dimensions. Timeline controls are not shown on non-banner websites just because GSAP is present. On banners, Bullseye checks named timelines exposed on the `window` object and uses a non-empty `gsap.globalTimeline` as a fallback.\n\n---\n\n## Publishing updates\n\n1. Edit source files in `src/`\n2. Bump the version in `package.json` and add a changelog entry in `src/bullseye.js`\n3. Run from `~/www/bullseye`:\n\n```bash\nnpm run build && npm publish\n```\n\nThe project's npm credentials are saved in its ignored `.npmrc` file.\n\n**Version conventions:** patch (`0.6.x`) for fixes and tweaks, minor (`0.x.0`) for new features, major (`x.0.0`) for breaking changes.\n\n---\n\n## Project structure\n\n```\nbullseye/\n├── src/\n│   ├── dev-badge.js      # Viewport badge IIFE\n│   └── bullseye.js       # Overlay tool IIFE\n├── dist/\n│   └── development-tools.js  # Minified build (both tools concatenated)\n├── scripts/\n│   └── build.js          # Node build script (terser)\n├── package.json\n├── LICENSE\n└── README.md\n```\n\n---\n\n## License\n\nMIT — Copyright © 2026 Archer Interactive\n","readmeFilename":"README.md"}