Merge branch 'feat/tools-measure-rulers'

Tools tab (measure, rulers/guides, eyedropper, grid-snap, screenshot),
actionable inspector, E2E suite, and public-repo preparation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: philippgerger

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,48 @@
+name: Bug report
+description: Something in the extension isn't working as expected
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to file a bug! Please fill in as much as you can.
+        For security issues, do **not** use this form — see [SECURITY.md](../blob/main/SECURITY.md).
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: A clear description of the bug and what you expected instead.
+      placeholder: When I toggle the column grid on <site>, the overlay…
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: Include the page/site if the bug is site-specific.
+      placeholder: |
+        1. Open …
+        2. Press ⌘⇧Y …
+        3. Toggle …
+    validations:
+      required: true
+  - type: input
+    id: browser
+    attributes:
+      label: Browser & version
+      placeholder: Chrome 140 / Arc 1.x / Edge 140
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Extension version
+      placeholder: 0.1.0 (see chrome://extensions)
+    validations:
+      required: true
+  - type: textarea
+    id: console
+    attributes:
+      label: Console output
+      description: Any relevant errors from the page console or the extension's service worker.
+      render: shell

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/philippgerger/avemo-dev-plugin/security/advisories/new
+    about: Please report security issues privately, not as a public issue.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,23 @@
+name: Feature request
+description: Suggest an overlay, tool, or improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: What are you trying to do that the extension can't do today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: How might it look or behave? Screenshots/sketches welcome.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches or existing tools you've tried.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+<!-- Thanks for contributing! Please fill this in so reviews go smoothly. -->
+
+## Summary
+
+<!-- What does this change and why? Link any related issue: Closes #123 -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor / internal
+- [ ] Documentation
+- [ ] Build / CI
+
+## Checklist
+
+- [ ] `pnpm type-check` passes
+- [ ] `pnpm test` passes (added/updated tests where it made sense)
+- [ ] `pnpm build` succeeds
+- [ ] Verified in a real browser (if UI/overlay behavior changed)
+- [ ] Commits follow [Conventional Commits](https://www.conventionalcommits.org/)
+
+## Screenshots / notes
+
+<!-- Optional: before/after screenshots, or anything a reviewer should know. -->

.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Cancel superseded runs on the same ref.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-test:
+    name: Type-check, test & build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Type-check
+        run: pnpm type-check
+
+      - name: Unit tests
+        run: pnpm test
+
+      - name: Build extension
+        run: pnpm build:only
+
+      - name: Upload unpacked extension
+        uses: actions/upload-artifact@v4
+        with:
+          name: avemo-dev-unpacked
+          path: dist/
+          if-no-files-found: error
+
+  e2e:
+    name: End-to-end (Playwright)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Install Playwright Chromium
+        run: pnpm exec playwright install --with-deps chromium
+
+      - name: Build extension
+        run: pnpm build:only
+
+      - name: Run E2E smoke suite
+        run: pnpm e2e
+
+      - name: Upload Playwright report
+        if: ${{ !cancelled() }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+          if-no-files-found: ignore

.gitignore

@@ -4,3 +4,11 @@ dist
 *.log
 .vite
 stats.html
+
+# Playwright E2E artifacts
+test-results
+playwright-report
+.playwright
+
+# Local Claude Code session data
+.claude

CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project are documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres
+to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Public repository: MIT license, contribution guide, issue/PR templates, and a
+  continuous-integration workflow (type-check, unit tests, build).
+
+## [0.1.0]
+
+Initial development release.
+
+### Added
+- **Column grid** overlay — configurable count, gutter, margin, max-width, and
+  `stretch` / `center` alignment, with an optional responsive per-breakpoint mode.
+- **Baseline grid** and **row** overlays for verifying vertical rhythm.
+- **Element outlines** for containers, text nodes, or every element.
+- **Hover inspector** reading out box model, typography, colors, and size, with
+  pin-on-click and copy classes / CSS / color actions.
+- **Tools tab** — pixel measure, rulers with draggable per-site guides, an
+  eyedropper (with recent colors), grid-snap, and full-page screenshot capture.
+- **Floating glass panel** — draggable, minimizable, styled with the avemo OKLCH
+  token system; toggled with `⌘⇧Y` / `Ctrl+Shift+Y` or the toolbar icon.
+- **Per-site persistence** of overlay config and panel state in `chrome.storage.local`.
+- Built-in presets (Avemo 12-col, 8pt/4pt baseline, Centered 1200 · 12) plus
+  user-saved custom presets.
+- Full **Shadow DOM isolation** so page CSS and the extension's styles never mix.
+- Bundled **Inter** font, injected via an in-shadow `@font-face`.
+- **Vitest** unit suite and a **Playwright** end-to-end smoke suite that drives the
+  built extension in a real Chromium context.
+
+[Unreleased]: https://github.com/philippgerger/avemo-dev-plugin/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/philippgerger/avemo-dev-plugin/releases/tag/v0.1.0

CONTRIBUTING.md

@@ -0,0 +1,93 @@
+# Contributing to Avemo Dev
+
+Thanks for your interest in improving Avemo Dev! This document covers how to get
+a development build running, the project layout, and the conventions used here.
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) 20 or newer
+- [pnpm](https://pnpm.io/) 9 or newer (`corepack enable` will provide it)
+- A Chromium-based browser (Chrome, Edge, Brave, Arc, …) for loading the extension
+
+## Getting started
+
+```bash
+pnpm install        # install dependencies
+pnpm dev            # start Vite in watch mode with HMR
+```
+
+Then load the extension:
+
+1. Open `chrome://extensions`.
+2. Enable **Developer mode** (top-right).
+3. Click **Load unpacked** and select the generated `dist/` folder.
+
+CRXJS reloads the extension as you edit source files. For a production build,
+run `pnpm build` and load the same `dist/` folder.
+
+## Useful scripts
+
+| Command | What it does |
+| --- | --- |
+| `pnpm dev` | Vite dev server + HMR for the extension |
+| `pnpm build` | Type-check (`vue-tsc`) then produce the unpacked extension in `dist/` |
+| `pnpm type-check` | Type-check only, no build |
+| `pnpm test` | Run the Vitest unit suite once |
+| `pnpm test:watch` | Vitest in watch mode |
+| `pnpm e2e:install` | One-time: download the Chromium build Playwright drives |
+| `pnpm e2e` | Run the Playwright end-to-end suite against `dist/` (build first) |
+
+## Project structure
+
+```
+src/
+├─ background/        # MV3 service worker (toggles the panel on command/icon click)
+├─ content/           # content script: mounts the Shadow-DOM host
+│  ├─ overlay-root.ts     # creates the shadow root, injects tokens + Inter
+│  ├─ overlay-manager.ts  # watches the Pinia store, drives the plain-JS renderers
+│  └─ overlays/           # column/baseline/row grids, outlines, inspector, tools
+├─ ui/                # Vue panel + section/component tree
+├─ stores/            # Pinia store — the single config contract the UI drives
+├─ lib/               # framework-agnostic helpers (color, grid math, storage, …)
+└─ styles/            # panel.css — the avemo OKLCH token system (injected inline)
+```
+
+Key architectural notes:
+
+- **Shadow DOM isolation.** The panel and every overlay mount inside a shadow root
+  so page CSS never leaks in, and the extension's styles never affect the page.
+- **Store-driven overlays.** `src/stores/settings.ts` is the source of truth;
+  `overlay-manager.ts` watches it and calls the plain-JS renderers in
+  `src/content/overlays/`. Overlays don't import Vue.
+- **Per-domain persistence.** Config is saved per host in `chrome.storage.local`
+  and auto-restored on the next visit.
+
+## Coding conventions
+
+- **TypeScript strict mode** throughout — no `any` escape hatches without a reason.
+- Match the style, naming, and comment density of the surrounding code.
+- Keep overlay renderers framework-agnostic (no Vue imports under `content/overlays/`).
+- Prefer small, focused modules in `src/lib/` for reusable logic and add a unit test.
+
+## Before opening a pull request
+
+1. `pnpm type-check` passes.
+2. `pnpm test` passes (add/adjust tests for behavior changes).
+3. `pnpm build` succeeds.
+4. If you touched panel/overlay behavior, sanity-check it in a real browser and,
+   where practical, extend the Playwright suite in `e2e/`.
+
+### Commit messages
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+feat(inspector): add contrast ratio readout
+fix(panel): restore focus after closing a color field
+docs: clarify E2E setup
+```
+
+## Reporting bugs & requesting features
+
+Use the [issue templates](https://github.com/philippgerger/avemo-dev-plugin/issues/new/choose).
+For anything security-related, please read [SECURITY.md](./SECURITY.md) first.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Philipp Gerger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.