Vize

ssr/no-hydration-mismatch

Disallow non-deterministic values that cause hydration mismatch.

Default severity Presets Automatic fix Options
warning happy-path, nuxt, ecosystem, opinionated No None

Applies to: Vue SFC templates and blocks, with script context where the rule requires it.

Bad

The template evaluates Math.random() during rendering, so the server and client can produce different text for the same paragraph.

<template>
  <p>{{ Math.random() }}</p>
</template>

Good

The paragraph renders the stable seed state instead of a fresh random result. In this Nuxt-style example, useState supplies the shared state and the initializer is the constant "stable".

<script setup lang="ts">
const seed = useState("seed", () => "stable");
</script>

<template>
  <p>{{ seed }}</p>
</template>

Configuration (Vite+)

import { defineConfig } from "@vizejs/vite-plugin/vite-plus";

export default defineConfig({}).withVue({
  linter: {
    "preset": "incremental",
    "rules": {
      "ssr/no-hydration-mismatch": "warn"
    }
  },
});

Then run vp run lint.