tailwindcss-safe-area

Tailwind CSS safe area helpers

Usage no npm install needed!

<script type="module">
  import tailwindcssSafeArea from 'https://cdn.skypack.dev/tailwindcss-safe-area';
</script>

README

tailwindcss-safe-area

Safe area inset utilities extending margin, padding, and height

Getting started

npm install --dev tailwindcss-safe-area

Then add the plugin to your tailwind.config.js file:

// tailwind.config.js
module.exports = {
    theme: {},
    plugins: [require('tailwindcss-safe-area')],
}

Usage

This plugin extends the padding and margin utilities.

Use the *-safe utilities:

<header class="pt-safe">...</header>

<main class="px-safe">
    <p>ciao</p>
</main>

<footer class="pb-safe">...</footer>

Provided utilities

Utilities Styles
m-safe, p-safe env(safe-area-inset-{top, right, bottom, left})
mx-safe, px-safe env(safe-area-inset-{right, left})
my-safe, py-safe env(safe-area-inset-{top, bottom})
mt-safe, pt-safe env(safe-area-inset-top)
mr-safe, pr-safe env(safe-area-inset-right)
mb-safe, pb-safe env(safe-area-inset-bottom)
ml-safe, pl-safe env(safe-area-inset-left)
min-h-screen-safe, h-screen-safe calc(100vh - (env(safe-area-inset-top) + env(safe-area-inset-bottom)))
-webkit-fill-available

Tip: To extend html content behind the safe area, set viewport-fit=cover

<meta
    name="viewport"
    content="width=device-width, initial-scale=1.0, viewport-fit=cover"
/>