Astro Integration

The UnoCSS integration for Astro: @unocss/astro. Check the example.

Installation

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

// astro.config.ts
import {defineConfig} from 'astro/config';
import UnoCSS from 'unocss/astro';

export default defineConfig({
  integrations: [UnoCSS()]
});

Create a uno.config.ts file:

// uno.config.ts
import {defineConfig} from 'unocss';

export default defineConfig({
  // ...UnoCSS options
});

Style Reset

By default, browser style reset will not be injected. To enable it, install the @unocss/reset package:

pnpm

pnpm add -D @unocss/reset

yarn

yarn add -D @unocss/reset

npm

npm install -D @unocss/reset

And update your astro.config.ts:

// astro.config.ts
import {defineConfig} from 'astro/config';
import UnoCSS from 'unocss/astro';

export default defineConfig({
  integrations: [
    UnoCSS({
      injectReset: true // or a path to the reset file
    })
  ]
});

Usage without presets

This plugin does not come with any default presets.

pnpm

pnpm add -D @unocss/astro

yarn

yarn add -D @unocss/astro

npm

npm install -D @unocss/astro

// astro.config.mjs
import UnoCSS from '@unocss/astro';

export default {
  integrations: [UnoCSS()]
};

For more details, please refer to the Vite plugin.

INFO

If you are building a meta framework on top of UnoCSS, see this file for an example on how to bind the default presets.

Notes

client:only components must be placed in components folder or added to UnoCSS's content config in order to be processed.

Contributors

why

Changelog

Last edited 2 minutes ago

View full history

da5df4d-feat: update