# Velt Single Editor Mode Best Practices
|v1.0.0|Velt|March 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 details.
|root: ./rules

## 1. Core Setup — CRITICAL
|shared/core:{core-setup.md}

## 2. Editor State Management — CRITICAL
|react/state:{state-hooks.md}
|shared/state:{state-set-user-editor.md,state-editor-api.md}

## 3. Access Request Flow — HIGH
|react/access:{access-hooks.md}
|shared/access:{access-editor-side.md,access-viewer-side.md}

## 4. Element Control — HIGH
|shared/elements:{elements-sync-attributes.md,elements-container-scope.md}

## 5. Timeout Configuration — MEDIUM
|react/timeout:{timeout-hooks.md}
|shared/timeout:{timeout-config.md}

## 6. Event Handling — MEDIUM
|react/events:{events-hooks.md}
|shared/events:{events-subscribe.md}

## 7. Debugging & Testing — LOW-MEDIUM
|shared/debug:{debug-common-issues.md}