# Velt Crdt Best Practices
|v2.0.0|Velt|January 2026
|IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any Velt tasks.
|IMPORTANT: VeltProvider requires the `authProvider` prop for authentication. Do NOT use the deprecated `useIdentify` hook. Pattern: `<VeltProvider apiKey={KEY} authProvider={{ user: { userId, organizationId, name, email }, retryConfig: { retryCount: 3, retryDelay: 1000 }, generateToken: async () => { /* fetch from /api/velt/token */ } }}>`. See velt-setup-best-practices for the full pattern.
|root: ./rules

## 1. Core CRDT — CRITICAL
|react/core:{core-crdt-utils-hooks.md,core-store-create-react.md}
|shared/core:{core-store-types.md,core-velt-init.md,core-install.md,core-store-lifecycle.md,core-version-save.md,core-event-subscription.md,core-store-subscribe.md,core-debug-testing.md,core-activity-action-types.md,core-message-stream.md,core-encryption.md,core-rest-api.md,core-activity-debounce.md,core-store-update.md,core-debug-storemap.md,core-webhooks.md}
|non-react/core:{core-store-create-vanilla.md}

## 2. Tiptap Integration — CRITICAL
|react/tiptap:{tiptap-nextjs-ssr.md,tiptap-setup-react.md}
|shared/tiptap:{tiptap-cursor-css.md,tiptap-disable-history.md,tiptap-install.md,tiptap-comments-integration.md,tiptap-testing.md,tiptap-initial-content.md,tiptap-editor-id.md}
|non-react/tiptap:{tiptap-setup-vanilla.md}

## 3. BlockNote Integration — HIGH
|react/blocknote:{blocknote-install.md,blocknote-testing.md,blocknote-editor-id.md,blocknote-setup-react.md}

## 4. CodeMirror Integration — HIGH
|react/codemirror:{codemirror-setup-react.md}
|shared/codemirror:{codemirror-install.md,codemirror-testing.md,codemirror-editor-id.md,codemirror-ycollab.md}
|non-react/codemirror:{codemirror-setup-vanilla.md}

## 5. ReactFlow Integration — HIGH
|react/reactflow:{reactflow-install.md,reactflow-testing.md,reactflow-handlers.md,reactflow-editor-id.md,reactflow-setup-react.md}