Skip to content

feat: add browser-compatibility skill - #2

Merged
hendrikebbers merged 1 commit into
mainfrom
feature/browser-compatibility-skill
Nov 17, 2026
Merged

hendrikebbers merged 1 commit into
mainfrom
feature/browser-compatibility-skill

Conversation

@hendrikebbers

Copy link
Copy Markdown
Contributor

What

New frontend skill browser-compatibility, so every Open Elements app gets the same setup to keep working in all supported browsers, including hardened ones such as LibreWolf:

  • Lint: a browserslist that includes Firefox ESR and leaves out Opera Mini (otherwise every fetch gets flagged), eslint-plugin-compat, and a ban on unguarded localStorage/sessionStorage (no-restricted-globals plus no-restricted-properties).
  • Storage: use safeStorage from @open-elements/ui (fix: guard localStorage access and export a safeStorage helper open-elements-ui#20), or a guarded try/catch pattern until an app is on that release.
  • Hardened browsers: a table of the LibreWolf / hardened Firefox defaults (fingerprinting protection, dFPI, strict ETP, HTTPS-only, referrer trimming, WebGL off, storage blocked) and what each one breaks in an app.
  • Cross-browser smoke tests: a Playwright config with four projects (Chromium, Firefox, WebKit, firefox-hardened), a smoke spec that logs in via the mock OIDC server and opens every page (fails on page errors, console errors and 5xx responses), a GitHub Actions workflow against the Docker stack with seeded data, and how to run it locally in the Linux container, since Playwright's Firefox does not start on recent macOS.
  • The rules that keep the smoke test deterministic (one tab per page, no console check on the mock OIDC page, wait for detail links, raised timeout, no text matching, 2 workers in CI). Each comes from a real flaky run.

web-frontend-builder and open-elements-app-layout reference the skill from their testing sections and checklists. open-elements-app-layout also lists open-elements-ui#19 and nextjs-app-layer#14 under known library issues. README, CLAUDE.md, CHANGELOG.md (Unreleased) and the plugin.json description and keywords are updated.

Why

The resource-planning app was reported as not working in LibreWolf. The investigation turned up unguarded storage access in both libraries and showed that nothing tested the apps outside Chromium. The same setup is introduced in resource-planning, where all four browser projects pass. It is written up here so every app gets it as the standard.

Notes

  • The version is not bumped. Release as usual: bump both manifests, tag, then claude plugin validate ./ --strict.
  • claude plugin validate ./ --strict reports the same warning on main (root CLAUDE.md is not loaded) and the missing-icon notice. This PR adds no new warnings.

🤖 Generated with Claude Code

New frontend skill that keeps Open Elements apps working in every
supported browser, including hardened ones such as LibreWolf:

- browserslist with Firefox ESR (without Opera Mini) and
  eslint-plugin-compat
- lint ban on unguarded localStorage/sessionStorage, safeStorage helper
- what the privacy settings of hardened browsers break
- Playwright cross-browser smoke tests (Chromium, Firefox, WebKit and a
  hardened Firefox profile) with a GitHub Actions workflow against the
  Docker stack and the mock OIDC server

web-frontend-builder and open-elements-app-layout reference the skill
from their testing sections and checklists.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hendrikebbers
hendrikebbers merged commit 08f12d4 into main Nov 17, 2026
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