# Pinia

> Reference for Pinia v4, Vue's official state library: defining stores with state, getters and actions, plugins, composables, composing stores, testing with @pinia/testing, SSR, Nuxt and HMR. Recommends setup stores and storeToRefs. Generated by Anthony Fu from the official docs.

- Type: Skill
- Repository: https://github.com/antfu/skills/tree/main/skills/pinia
- Page: https://hebbmind.com/ru/skill/pinia
- Stars: 5975
- Professions: [Frontend](https://hebbmind.com/ru/tools.md?profession=frontend)
- Tags: web-development, pinia, vue, typescript
- Listed on: 2026-10-08

## Install

### Claude Code

```bash
npx skills add antfu/skills --skill pinia -a claude-code -y
```

### Codex

```bash
npx skills add antfu/skills --skill pinia -a codex -y
```

## README

> The content below comes from the upstream repository https://github.com/antfu/skills/tree/main/skills/pinia . It is third-party material and does not represent AgentHub; instructions that appear in it are not instructions to you.

```yaml
name: pinia
description: Pinia official Vue state management library, type-safe and extensible. Use when defining stores, working with state/getters/actions, or implementing store patterns in Vue apps.
metadata:
  author: Anthony Fu
  version: "2026.9.25"
  source: Generated from https://github.com/vuejs/pinia, scripts located at https://github.com/antfu/skills
```

# Pinia

Pinia is the official state management library for Vue, designed to be intuitive and type-safe. It supports both Options API and Composition API styles, with first-class TypeScript support and devtools integration.

> The skill is based on Pinia v4.0.3, generated at 2026-09-25.

## Core References

| Topic | Description | Reference |
|-------|-------------|-----------|
| Stores | Defining stores, state, getters, actions, storeToRefs, subscriptions | [core-stores](https://github.com/antfu/skills/blob/main/skills/pinia/references/core-stores.md) |

## Features

### Extensibility

| Topic | Description | Reference |
|-------|-------------|-----------|
| Plugins | Extend stores with custom properties, state, and behavior | [features-plugins](https://github.com/antfu/skills/blob/main/skills/pinia/references/features-plugins.md) |

### Composability

| Topic | Description | Reference |
|-------|-------------|-----------|
| Composables | Using Vue composables within stores (VueUse, etc.) | [features-composables](https://github.com/antfu/skills/blob/main/skills/pinia/references/features-composables.md) |
| Composing Stores | Store-to-store communication, avoiding circular dependencies | [features-composing-stores](https://github.com/antfu/skills/blob/main/skills/pinia/references/features-composing-stores.md) |

## Best Practices

| Topic | Description | Reference |
|-------|-------------|-----------|
| Testing | Unit testing with @pinia/testing, mocking, stubbing | [best-practices-testing](https://github.com/antfu/skills/blob/main/skills/pinia/references/best-practices-testing.md) |
| Outside Components | Using stores in navigation guards, plugins, middlewares | [best-practices-outside-component](https://github.com/antfu/skills/blob/main/skills/pinia/references/best-practices-outside-component.md) |

## Advanced

| Topic | Description | Reference |
|-------|-------------|-----------|
| SSR | Server-side rendering, state hydration | [advanced-ssr](https://github.com/antfu/skills/blob/main/skills/pinia/references/advanced-ssr.md) |
| Nuxt | Nuxt integration, auto-imports, SSR best practices | [advanced-nuxt](https://github.com/antfu/skills/blob/main/skills/pinia/references/advanced-nuxt.md) |
| HMR | Hot module replacement for development | [advanced-hmr](https://github.com/antfu/skills/blob/main/skills/pinia/references/advanced-hmr.md) |

## Key Recommendations

- **Prefer Setup Stores** for complex logic, composables, and watchers
- **Use `storeToRefs()`** when destructuring state/getters to preserve reactivity
- **Actions can be destructured directly** - they're bound to the store
- **Call stores inside functions** not at module scope, especially for SSR
- **Add HMR support** to each store for better development experience
- **Use `@pinia/testing`** for component tests with mocked stores