Setting the file. One moment.
Subchapter 5.3
references/advanced-ssr.mdMarkdown2 KBView on GitHub
Pinia works with SSR when stores are called at the top of setup, getters, or actions.
Using Nuxt? See the Nuxt integration instead.
<script setup>
// ✅ Works - pinia knows the app context in setup
const main = useMainStore()
</script>Pass the pinia instance explicitly:
const pinia = createPinia()
const app = createApp(App)
app.use(router)
app.use(pinia)
router.beforeEach((to) => {
// ✅ Pass pinia for correct SSR context
const main = useMainStore(pinia)
if (to.meta.requiresAuth && !main.isLoggedIn) {
return '/login'
}
})Access pinia via this.$pinia:
export default {
serverPrefetch() {
const store = useStore(this.$pinia)
return store.fetchData()
},
}Works normally:
<script setup>
const store = useStore()
onServerPrefetch(async () => {
await store.fetchData()
})
</script>Serialize state on server and hydrate on client.
Use devalue (opens in a new tab) for XSS-safe serialization:
import devalue from 'devalue'
import { createPinia } from 'pinia'
const pinia = createPinia()
const app = createApp(App)
app.use(router)
app.use(pinia)
// After rendering, state is available
const serializedState = devalue(pinia.state.value)
// Inject into HTML as global variableHydrate before any useStore() call:
const pinia = createPinia()
const app = createApp(App)
app.use(pinia)
// Hydrate from serialized state (e.g., from window.__pinia)
if (typeof window !== 'undefined') {
pinia.state.value = JSON.parse(window.__pinia)
}pinia instance when using stores outside components in SSRuseStore()devalue or similar for safe serialization