Browserslist config for Tailwind v4

cover image

Here is a minimum browserslist config if you need to use Tailwind V4 in your project.

browserslist
chrome >= 111
edge >= 111
safari >= 16.4
ios_saf >= 16.4
firefox >= 128
and_chr >= 111
and_ff >= 128
samsung >= 21
opera >= 97

However it's specified that Tailwind v4 supports Chrome 111, Safari 16.4, and Firefox 128, we need to expand base browserlist query to include some additional browser versions in order to avoid false positives.

It is recommended to show user a message if unsupported browser is detected. Below is an example how to do this in Astro using browserslist-useragent-regexp package.

UnsupportedBrowser.astro
---
import { getUserAgentRegex } from "browserslist-useragent-regexp";
import UnsupportedBrowserClient from "./UnsupportedBrowser.client";

const supportedBrowsersRegex = getUserAgentRegex({ allowHigherVersions: true });
---

<UnsupportedBrowserClient {...{ supportedBrowsersRegex }} client:idle />
UnsupportedBrowser.client.tsx
import { useEffect, useState } from "react";

export default function UnsupportedBrowser({
  supportedBrowsersRegex,
}: {
  supportedBrowsersRegex: RegExp;
}) {
  const [isSupported, setIsSupported] = useState(true);

  useEffect(() => {
    setIsSupported(supportedBrowsersRegex.test(navigator.userAgent));
  }, []);

  return isSupported ? null : (
    <div className="order-first bg-yellow-300">
      <div className="container py-5">
        <p className="max-w-prose mx-auto">
          You are likely using an outdated or little-known browser.
          Some elements on this site may not display correctly.
        </p>
      </div>
    </div>
  );
}
send feedback

WSSE — быстрые и надежные сайты

🚀 Работает на платформе Oxty