AddThisFeature

Browser Support Matrix

State which browsers the app supports and prove it, instead of assuming.

moderate Testing & QA

What it adds

A documented list of supported browsers and versions, the fallbacks for unsupported ones, and automation aligned to that list.

What your agent is told to do

5
  1. 1

    Derive the supported list from who actually uses the app and what the business has committed to, using real usage data and any contractual or regulatory requirement, rather than copying a default list from somewhere else.

  2. 2

    For each capability the app depends on, write down what happens when it is missing — the feature degrades, the feature is hidden, or the user is told the browser is unsupported — and make sure something is defined for every case.

  3. 3

    Make the automation run against the browsers the policy names. A stated support commitment that no test exercises is an unverified claim.

  4. 4

    Detect an unsupported browser and say so plainly at the point of entry, naming what will not work, rather than letting the user discover it through a blank screen halfway through a flow.

  5. 5

    Review the list on a fixed schedule against current usage, and remove a browser only after usage has fallen below the agreed threshold. Viewport sizes and zoom levels are the Responsive QA Matrix's concern, not this one's.

Edge cases it handles

7
  • A support list chosen from habit rather than from usage data will spend effort on browsers nobody uses while breaking for a version a large customer is standardised on, so the decision has to be evidenced.
  • Every unsupported capability needs a defined fallback path — silently doing nothing leaves the user with a control that appears to work and does not, which is worse than an honest refusal.
  • Automation that runs in one engine while the policy claims three means two of those claims are untested, and the gap only surfaces as a customer report.
  • Support lists go stale quietly; without a scheduled review the app carries workarounds for browsers with no remaining users and misses versions that have since become common.
  • Version ranges expressed as latest only are meaningless for locked-down corporate estates and for users who do not update, so the policy must state a minimum version rather than a moving target.
  • Embedded and in-app browsers inside social and messaging apps behave differently from their standalone counterparts and must be listed explicitly if any inbound traffic arrives through them.
  • Feature detection is the correct basis for a fallback; user-agent sniffing misidentifies new versions and locks out browsers that would have worked.

Definition of done

8
  • The supported browser and version list is written down and traceable to usage data or a stated requirement.
  • Each capability the app depends on has a documented fallback or an explicit unsupported message.
  • Automated tests run against every browser the policy claims to support.
  • An unsupported browser is detected and told what will not work before the user begins a flow.
  • Fallback decisions are made by feature detection, not by parsing the user agent.
  • The list carries a review date and a documented threshold for dropping a browser.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.