---
url: /api/plugin-reset.md
description: >-
  Generated API reference for @pikacss/plugin-reset from exported surface and
  JSDoc.
---

# Plugin Reset API reference

* Package: `@pikacss/plugin-reset`
* Generated from the exported surface and JSDoc in `packages/plugin-reset/src/index.ts`.
* Source files: `packages/plugin-reset/src/index.ts`

## Package summary

CSS reset preflight plugin.

Use [Reset plugin](/official-plugins/reset) when you need conceptual usage guidance instead of exact symbol lookup.

## Functions

### reset() {#function-reset}

Creates a PikaCSS engine plugin that injects a CSS reset stylesheet as a preflight.

**Returns:** `EnginePlugin` - An engine plugin that registers a reset preflight on the `reset` layer.

**Remarks:**

The plugin reads the `reset` option from the engine config to select a
stylesheet. If unset, it defaults to `'modern-normalize'`. The `reset`
layer's order defaults to `-1` (set only when `layers.reset` is not
already configured), which places the reset styles before utility output
unless the config overrides the layer order.

```ts
import { reset } from '@pikacss/plugin-reset'
import { defineConfig } from '@pikacss/unplugin-pikacss'

export default defineConfig({
  engine: {
    plugins: [reset()],
    reset: 'eric-meyer',
  },
})
```

## Types

### ResetStyle {#type-resetstyle}

Union of built-in CSS reset stylesheet names supported by the reset plugin.

**Type:** `"andy-bell" | "eric-meyer" | "modern-normalize" | "normalize" | "the-new-css-reset"`

**Remarks:**

Each value maps to a well-known CSS reset: Andy Bell's modern reset,
Eric Meyer's classic reset, modern-normalize, normalize.css, and
The New CSS Reset. The chosen name is passed to the `reset` engine
config option to select which stylesheet is injected as a preflight.

```ts
const style: ResetStyle = 'modern-normalize'
```

## Module augmentations

### EngineConfig (@pikacss/core) {#augmentation-engineconfig-pikacss-core}

| Property | Type | Description | Default |
|---|---|---|---|
| `reset?` | `ResetStyle` | CSS reset stylesheet to inject as a preflight. | `'modern-normalize'` |

## Next

* [Reset plugin](/official-plugins/reset)
* [Plugin Icons API reference](/api/plugin-icons)
* [API reference overview](/api/)