Getting started

Supported Tauri Version

This plugin requires Tauri 2.0 or later.

Install

Install the Rust crate by adding the following to your Cargo.toml file:

src-tauri/Cargo.toml

[dependencies]
tauri-plugin-pinia = "3"

Install the JavaScript package with your preferred package manager:

npm

npm install @tauri-store/pinia

pnpm

pnpm add @tauri-store/pinia

deno

deno add npm:@tauri-store/pinia

bun

bun add @tauri-store/pinia

yarn

yarn add @tauri-store/pinia

Usage

1. Enable the required permissions in your capabilities file:

src-tauri/capabilities/pinia.json

{
  "identifier": "pinia",
  "windows": ["*"],
  "permissions": ["pinia:default", "core:event:default"]
}

2. Register the plugin with Tauri:

src-tauri/src/lib.rs

tauri::Builder::default()
  .plugin(tauri_plugin_pinia::init())
  .run(tauri::generate_context!())
  .expect("error while running tauri application");

3. Enable the plugin for Pinia:

src/index.ts

import { createApp } from 'vue';
import { createPinia } from 'pinia';
import { createPlugin } from '@tauri-store/pinia';

const app = createApp(App);

const pinia = createPinia();
pinia.use(createPlugin());

app.use(pinia);
app.mount('#app');

TIP

createPlugin is also exported as TauriPluginPinia.

4. Define your Pinia store:

src/stores/counter.ts

import { ref } from 'vue';
import { defineStore } from 'pinia';

export const useStore = defineStore('counter', () => {
  const counter = ref(0);
  return { counter };
});

5. Start it:

const store = useStore();
await store.$tauri.start();

TIP

Stores won't be saved nor synchronized until you call the start method.

Nuxt

If you are using Nuxt, you can create a Nuxt plugin to enable it for Pinia:

plugins/pinia.ts

import type { Pinia } from 'pinia';
import { TauriPluginPinia } from '@tauri-store/pinia';

// See: https://pinia.vuejs.org/core-concepts/plugins.html#Nuxt-js
export default defineNuxtPlugin(({ $pinia }) => {
  ($pinia as Pinia).use(TauriPluginPinia());
});