fix(editor): set immediatelyRender:false on Tiptap useEditor — Next 15 + React 19 SSR hydration error blocked petition pipeline editor render

e46e6f9763ba7ffbfcb3006123c4fbaefd39eb64 · 2026-05-20 09:55:28 -0700 · Steve Abrams

Files touched

M components/editor/RichTextEditorClient.tsx

Diff

commit e46e6f9763ba7ffbfcb3006123c4fbaefd39eb64
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Wed May 20 09:55:28 2026 -0700

    fix(editor): set immediatelyRender:false on Tiptap useEditor — Next 15 + React 19 SSR hydration error blocked petition pipeline editor render
---
 components/editor/RichTextEditorClient.tsx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/editor/RichTextEditorClient.tsx b/components/editor/RichTextEditorClient.tsx
index dcac6f6..7d8b971 100644
--- a/components/editor/RichTextEditorClient.tsx
+++ b/components/editor/RichTextEditorClient.tsx
@@ -91,6 +91,9 @@ export default function RichTextEditorClient({
   placeholder = 'Start writing your email...',
 }: RichTextEditorClientProps) {
   const editor = useEditor({
+    // Tiptap v2+ in Next.js App Router: avoid SSR hydration mismatch by
+    // initializing only on the client. Required since Next 15 + React 19.
+    immediatelyRender: false,
     extensions: [
       StarterKit,
       Link.configure({ openOnClick: false, HTMLAttributes: { rel: 'noopener noreferrer' } }),

← 4f1d74b fix(pipeline/reorder): cast org_id param as ::uuid not ::tex · back to Norma · docs: modal training one-pager for SDCC staff (companion to fb319b1 →