43 lines (30 loc) · 2.06 KB

name	wxt-svelte-extension
description	Provides project context for the amgiflol WXT + Svelte 5 browser extension. Use when adding or editing extension code, adding entrypoints, fixing extension bugs, or when working in src/entrypoints or wxt.config.ts.

WXT + Svelte Extension (amgiflol)

Stack

WXT, Svelte 5 (runes), UnoCSS, @lucide/svelte v1 for icons
Entrypoints in src/entrypoints/ (e.g. background.ts, content.ts)
Config in wxt.config.ts; srcDir src, outDir dist

Scripts

Command	Purpose
`pnpm dev`	Chrome dev (MV3)
`pnpm dev:firefox`	Firefox dev (MV2 in dev)
`pnpm build`	Chrome build (MV3)
`pnpm build:firefox`	Firefox build (MV3)
`pnpm build:all`	Both targets
`pnpm zip` / `pnpm zip:all`	Distribution zips

Constraints

Do not create new data in dev; it breaks seeding.
Storage keys: use a fixed prefix (e.g. amgiflol_) for all extension storage to avoid collisions with host page (see reference.md).
Extension UI in shadow DOM: isolate from host page styles (e.g. WXT ShadowRootContentScriptUiOptions) so host root font/CSS vars do not affect the UI.

Lint and format

pnpm lint (oxlint); import order and sort-imports per .oxlintrc.jsonc
pnpm fmt (oxfmt); pnpm fmt:check to check only
Tooling is kept current with oxfmt/oxlint updates; update this section when upgrading formatter or linter.

Additional context

For known issues and when to apply them (storage prefix, shadow root isolation, Firefox quirks), see reference.md.

Manifest / env

Chromium minimum_chrome_version comes only from import.meta.env.WXT_MIN_CHROME_VERSION in wxt.config.ts. Set it via mise.toml [env] (or .env locally); there is no build-time fallback string in config.