tailwindcss-device

tailwindcss-device

TailwindCSS plugin to add variants for input device detection using @media queries

Installation

pnpm

pnpm add -D tailwindcss-device

npm

npm i -D tailwindcss-device

yarn

yarn add -D tailwindcss-device

Usage

1. Add plugin to your tailwind.config.js plugins section:

const device = require("tailwindcss-device")

module.exports = {
  plugins: [
    device,
    // ...

    // or with custom prefix:
    deivce({prefix: "device"})
  ]
}

1. And then prefix utilities using available variants:

<div class="border border-black rounded-md device-touch:rounded-lg">
  <div class="hidden device-touch:block">
    Hello, I'm visible on smartphones and tables!
  </div>
  <div class="hidden device-desktop:block">
    Hello, I'm visible on computer with mouse!
  </div>
<div>

1. The result will look like this:

.hidden {
  display: none;
}

@media (pointer: coarse) {
  .device-touch\:block {
    display: block;
  }
}

@media (pointer: fine) or (pointer: none) {
  .device-desktop\:block {
    display: block;
  }
}

Available variants

Name	Target
touch	Devices with touchscreen as primary input method (e.g smartphones and tablets)
desktop	Computers with a mouse
desktop-touch	Computers with touch input device
desktop-any	Computers with or without touch input device

Useful links

• Media queries reference documentation on MDN
• Using media queries documentation on MDN
• any-pointer media feature documentation on MDN
• pointer media feature documentation on MDN

Changelog

0.3.0

Minor Changes

• 5d0d342 Thanks @octet-stream! - Drop Node 16. Minimal required version is 18 from now on.

• 5d0d342 Thanks @octet-stream! - Use tsup instead of microbundle to build project. This allows to generate proper and separate set of types for cjs and esm output.