spline-interactive

Integrate Spline 3D scenes into React and Next.js applications with event handling.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/ayofemiade/cleva --skill spline-interactive-ayofemiade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spline-interactive
Source: https://github.com/ayofemiade/cleva/tree/main/.claude/skills/spline-interactive
Command: npx skills add https://github.com/ayofemiade/cleva --skill spline-interactive-ayofemiade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @splinetool/react-spline, @splinetool/runtime, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Building interactive 3D web experiences typically requires deep Three.js knowledge and extensive code. This Skill guides you through embedding designer-created Spline 3D scenes into React and Next.js apps, wiring up object interactions, triggering animations programmatically, and optimizing performance. ## Core Features & Use Cases - React/Next.js Integration: Embed Spline scenes using @splinetool/react-spline with SSR support, lazy loading, and responsive layouts. - Event Handling & Object Control: Respond to clicks and hovers on 3D objects, modify position/rotation/scale/material color, and trigger Spline animations via emitEvent. - Project & Component Generators: Scripts scaffold complete Vite or Next.js Spline projects and generate reusable component wrappers (basic, interactive, animated, controlled, responsive, lazy). - Use Case: Build a product configurator where users click a 3D product to change its color and rotate it, with scroll-triggered animations via GSAP ScrollTrigger. ## Quick Start Use the spline-interactive skill to create a React component that embeds my Spline scene and handles click events on 3D objects.

Frequently Asked Questions about spline-interactive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed a Spline 3D scene in a React app?▼

Install @splinetool/react-spline and @splinetool/runtime, then render the Spline component with your published scene URL from the Spline export dialog. The component fills its parent container and handles loading automatically.

Spline vs Three.js for web 3D experiences?▼

Spline suits designers and teams who prefer a visual editor with state-based animations and no-code interactions. Three.js fits developers needing maximum programmatic control, custom shaders, or complex game logic.

Does Spline work with Next.js server-side rendering?▼

Yes, import from @splinetool/react-spline/next for SSR support with placeholder images during server rendering. Alternatively, use next/dynamic with ssr: false to avoid hydration mismatches.

How do I trigger Spline animations from React code?▼

Save the Application instance from the onLoad callback, then call emitEvent with an event type like mouseHover and the object name. Use emitEventReverse to play the animation backward.

Why are my Spline click events not firing?▼

Use the onSplineMouseDown prop rather than standard onMouseDown, and verify the object has events configured in the Spline editor's Events panel. Object names in code must match the editor exactly, including case.

How do I fix slow Spline scenes on mobile devices?▼

Create a separate mobile scene in the Spline editor with fewer polygons, smaller textures, and no shadows or reflections. Load the appropriate scene based on screen width and keep renderOnDemand enabled.