Chrome Web Store Submission

Use this guide to prepare the public Chrome Web Store listing for Window Resize Manager. Keep it aligned with public/manifest.json, docs/privacy-policy.md, docs/chrome-web-store-privacy.md, docs/chrome-web-store-review.md, docs/usage-analytics-events.md, and the current external release ZIP.

Current Readiness

Already present:

Chrome Manifest V3 extension metadata and icons;
public privacy policy draft: docs/privacy-policy.md;
GitHub Pages is enabled for main:/docs;
configured privacy policy URL: https://gevorg-glechyan.github.io/window-size-extension/privacy-policy/;
Chrome Web Store privacy worksheet: docs/chrome-web-store-privacy.md;
Chrome review notes and permission justifications: docs/chrome-web-store-review.md;
public support page draft: docs/support.md;
configured support URL: https://gevorg-glechyan.github.io/window-size-extension/support/;
usage analytics event inventory: docs/usage-analytics-events.md;
canonical changelog: CHANGELOG.md;
16, 32, 48, and 128 px icons in public/icons/;
release packaging and validation scripts in package.json.

Still missing before final submission:

publish this docs update to main and confirm the privacy/support URLs open successfully;
final Chrome Web Store category, language, and region/distribution selections in the Developer Dashboard;
final uploaded ZIP confirmation for artifacts/window-resize-manager-chromium-<version>.zip;
production screenshots captured from the external build;
promotional images in the dimensions requested by the Chrome Web Store dashboard;
final confirmation that the dashboard privacy answers match docs/chrome-web-store-privacy.md;
public Chrome Web Store listing URL after approval.

Single Purpose

Use this single-purpose statement in Chrome Web Store review fields:

Window Resize Manager lets users read current Chrome window and viewport dimensions, then resize the current normal Chrome browser window from a toolbar popup using built-in presets, locally saved custom presets, or manually entered dimensions.

Extension Description

Short description:

Resize Chrome windows and check frame or viewport dimensions from a local toolbar popup.

Detailed description:

Window Resize Manager helps developers, designers, QA testers, and screenshot workflows resize Chrome browser windows without leaving the toolbar.

Core features:
- Resize the current Chrome window with built-in Phone, Tablet, Laptop, Desktop, and Social/Screenshot presets.
- Enter a custom width and height, then rotate the size when orientation changes.
- Save, edit, delete, and reuse custom presets locally.
- Refill the custom size form from up to three recent custom dimensions.
- Switch between outer window sizing and visible viewport sizing.
- Read the current window frame size and viewport size from the popup.
- Restore maximized windows to normal size when applying a resize.

Privacy and storage:
- Presets, recent custom dimensions, and settings stay in Chrome extension storage on your device.
- Both Chrome build variants send explicit cookieless usage analytics to PostHog EU Cloud with a `build_variant` event property.
- The extension does not request host permissions and does not read page content, selected text, full URLs, cookies, website storage, form data, or browsing history.
- Analytics events do not include page content, tab titles, preset names, exact dimensions, raw error messages, cookies, or stable personal identifiers.
- Viewport mode uses a user-triggered one-shot numeric measurement of the active tab only when Chrome allows it.

Window Resize Manager is built for Chrome Manifest V3 and uses a normal extension toolbar popup.

Recommended category: Developer Tools. Productivity is also defensible if the listing is positioned for a broader workflow audience, but Developer Tools better matches responsive QA, design, and screenshot workflows.

Screenshot Checklist

Capture screenshots from the production external build loaded from dist/chromium/external. Suggested coverage:

current frame and viewport readout with the toolbar popup open;
custom size controls, rotate action, and recent custom dimensions;
saved custom presets with edit/delete controls visible;
built-in preset groups;
viewport resize mode selected;
a clear local error state for restricted or unavailable resize behavior if the dashboard asks for additional support visuals.

Do not use the internal build for public screenshots.

Chrome Submission Instructions

Confirm the repository state is clean enough for release.
```
git status --short
```

Confirm the version in package.json, package-lock.json, and public/manifest.json matches the release being uploaded.

node -p "require('./package.json').version"
node -p "require('./package-lock.json').version"
node -p "require('./public/manifest.json').version"

Run the release gate.
```
npm run check:release
```
This runs lint, typecheck, unit tests, privacy validation, external and internal Chromium packaging, and package validation.
Upload the Chromium external ZIP.
```
artifacts/window-resize-manager-chromium-<version>.zip
```
Do not upload the -internal.zip package to the public Chrome Web Store.
In the Store listing tab, paste the short and detailed descriptions from this guide.
Add screenshots and promotional images captured from the external build.

Set the public support and privacy URLs after they are published.

Privacy policy: https://gevorg-glechyan.github.io/window-size-extension/privacy-policy/
Support: https://gevorg-glechyan.github.io/window-size-extension/support/

Complete the privacy questionnaire from docs/chrome-web-store-privacy.md.

Key answers:
- remote code: no;
- Chrome extension permissions: windows, storage, activeTab, scripting;
- host access: none;
- data collection: explicit cookieless extension usage analytics only;
- data use: analytics are used only to improve extension behavior, reliability, and feature adoption.
Use the permission justifications from docs/chrome-web-store-privacy.md and docs/chrome-web-store-review.md.
Before submitting for review, preview the listing and confirm:
- the privacy policy and support URLs open successfully;
- the uploaded package is the external Chromium ZIP for the intended version;
- the dashboard does not show host access prompts;
- the dashboard permission prompts match the expected manifest permissions;
- screenshots are legible in the dashboard preview;
- no internal-only branding appears in public listing copy or screenshots.
Submit for review.
After approval, add the public Chrome Web Store URL to the README, support page, and docs index.