1---2name: pinia-23description: 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.4metadata:5 author: Anthony Fu6 version: "2026.9.25"7 source: https://skillmd.com/skills/pleaseai/pinia-28 upstream: Generated from https://github.com/vuejs/pinia, scripts located at https://github.com/antfu/skills9---1011# Pinia1213Pinia 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.1415> The skill is based on Pinia v4.0.3, generated at 2026-09-25.1617## Core References1819| Topic | Description | Reference |20|-------|-------------|-----------|21| Stores | Defining stores, state, getters, actions, storeToRefs, subscriptions | [core-stores](references/core-stores.md) |2223## Features2425### Extensibility2627| Topic | Description | Reference |28|-------|-------------|-----------|29| Plugins | Extend stores with custom properties, state, and behavior | [features-plugins](references/features-plugins.md) |3031### Composability3233| Topic | Description | Reference |34|-------|-------------|-----------|35| Composables | Using Vue composables within stores (VueUse, etc.) | [features-composables](references/features-composables.md) |36| Composing Stores | Store-to-store communication, avoiding circular dependencies | [features-composing-stores](references/features-composing-stores.md) |3738## Best Practices3940| Topic | Description | Reference |41|-------|-------------|-----------|42| Testing | Unit testing with @pinia/testing, mocking, stubbing | [best-practices-testing](references/best-practices-testing.md) |43| Outside Components | Using stores in navigation guards, plugins, middlewares | [best-practices-outside-component](references/best-practices-outside-component.md) |4445## Advanced4647| Topic | Description | Reference |48|-------|-------------|-----------|49| SSR | Server-side rendering, state hydration | [advanced-ssr](references/advanced-ssr.md) |50| Nuxt | Nuxt integration, auto-imports, SSR best practices | [advanced-nuxt](references/advanced-nuxt.md) |51| HMR | Hot module replacement for development | [advanced-hmr](references/advanced-hmr.md) |5253## Key Recommendations5455- **Prefer Setup Stores** for complex logic, composables, and watchers56- **Use `storeToRefs()`** when destructuring state/getters to preserve reactivity57- **Actions can be destructured directly** - they're bound to the store58- **Call stores inside functions** not at module scope, especially for SSR59- **Add HMR support** to each store for better development experience60- **Use `@pinia/testing`** for component tests with mocked stores