Generates complete Lenis smooth scroll setup code for a given framework.

Supports vanilla JS, React, Vue, and Next.js with optional GSAP ScrollTrigger integration, snap scrolling, and custom RAF loop configuration.

Args:

• framework ('vanilla' | 'react' | 'vue' | 'nextjs'): Target framework (default: 'vanilla')

• with_gsap (boolean): Include GSAP ScrollTrigger integration (default: false)

• with_snap (boolean): Include lenis/snap package (default: false)

• custom_raf (boolean): Use custom requestAnimationFrame loop (default: false)

• settings (object): Custom Lenis settings to include

Returns: Complete setup code with installation commands, imports, initialization, CSS, and comments.

Examples:

• "Set up Lenis with GSAP in React" → framework: 'react', with_gsap: true

• "Basic smooth scroll for vanilla JS" → framework: 'vanilla'

• "Next.js app with snap scrolling" → framework: 'nextjs', with_snap: true

Queries the complete Lenis API documentation — settings, methods, events, and properties.

Supports filtering by category and search term for targeted lookups.

Args:

• category ('settings' | 'properties' | 'methods' | 'events' | 'all'): Filter by API category (default: 'all')

• search (string): Optional search term to filter results

Returns: Formatted API documentation with types, defaults, and descriptions.

Examples:

• "What is the lerp setting?" → category: 'settings', search: 'lerp'

• "List all methods" → category: 'methods'

• "How do events work?" → category: 'events'

Diagnoses Lenis smooth scroll issues based on symptom descriptions.

Matches symptoms against known limitations, common pitfalls, and troubleshooting patterns from the official Lenis documentation.

Args:

• symptom (string): Description of the scroll issue

• framework (string): Framework being used, if known

• using_gsap (boolean): Whether GSAP ScrollTrigger is being used (default: false)

Returns: Diagnosis with probable causes, step-by-step fixes, and relevant code snippets.

Examples:

• "Scroll feels janky on Safari" → symptom about Safari fps cap

• "Nested modal scroll not working" → nested scroll configuration

• "ScrollTrigger not syncing" → GSAP integration issue

Generates production-ready code for common Lenis scroll patterns.

Available patterns: parallax, infinite-scroll, snap, horizontal scroll, WebGL sync, and scroll-triggered animations.

Args:

• pattern ('parallax' | 'infinite-scroll' | 'snap' | 'horizontal' | 'webgl-sync' | 'scroll-triggered'): Pattern to generate

• framework ('vanilla' | 'react' | 'vue' | 'nextjs'): Target framework (default: 'vanilla')

• with_gsap (boolean): Include GSAP for animations (default: true)

Returns: Complete code with HTML structure, CSS, JavaScript setup, and explanatory comments.

Examples:

• "Parallax effect with GSAP" → pattern: 'parallax', with_gsap: true

• "Horizontal scroll section" → pattern: 'horizontal'

• "Snap scrolling between sections" → pattern: 'snap'

Provides performance optimization recommendations for Lenis smooth scroll setups.

Analyzes the described setup and returns targeted tips for reducing jank, improving fps, and optimizing for mobile devices.

Args:

• setup_description (string): Description of current Lenis setup

• target_fps (number): Target frames per second (default: 60)

• mobile_optimized (boolean): Include mobile-specific tips (default: true)

Returns: Prioritized list of optimization recommendations with code examples.

Examples:

• "React app with 50 GSAP animations and parallax" → heavy animation tips

• "Simple landing page with smooth scroll" → lightweight optimizations

• "E-commerce site with lazy loaded images" → scroll-aware loading tips