How pmndrs/react-spring works
react-spring is a cross-platform, spring-physics-first animation library. A typical workflow starts when an application configures an animation with a hook, the hook creates or updates controllers, and spring values schedule and advance animation state; animated host components then apply values to rendered elements. The README also documents imperative control and duration/easing animations. The graph includes transition/presence, platform targets, parallax, and shared timing support; some subsystem links are omitted where sampled evidence does not establish the runtime connection.
Main entry points: SpringValue.ts Spring Values · Controller.ts Controller · useSprings.ts Spring Collections · createHost.ts Animated Host
Components 20
Animation APIs
- Spring Hooks
packages/core/src/hooks/useSpring.ts - Spring Collections
packages/core/src/hooks/useSprings.ts - Transitions
packages/core/src/hooks/useTransition.tsx - Presence Lists
packages/core/src/hooks/usePresence.ts - Spring Components
packages/core/src/components
Animation Engine
- Controller
packages/core/src/Controller.ts - Spring Values
packages/core/src/SpringValue.ts - Frame Values
packages/core/src/FrameValue.ts - Async Updates
packages/core/src/runAsync.ts - Prop Scheduling
packages/core/src/scheduleProps.ts - Imperative Refs
packages/core/src/SpringRef.ts
Animated Rendering
- Animated Values
packages/animated/src/AnimatedObject.ts - Animated Host
packages/animated/src/createHost.ts
Platform Targets
- Web Target
targets/web/src/animated.ts - Three Target
targets/three/src/animated.ts - Parallax
packages/parallax/src/index.tsx
Shared Utilities
- Frame Loop
packages/shared/src/FrameLoop.ts - Frame Scheduler
packages/rafz/src/index.ts - Shared Helpers
packages/shared/src/helpers.ts
Other components
- Application
Connections 19
- Application → Spring Hooks: configures
README.md - Spring Hooks → Spring Collections: delegates to
packages/core/src/hooks/useSpring.ts - Spring Collections → Controller: updates
packages/core/src/hooks/useSprings.ts - Spring Collections → Spring Values: creates values
packages/core/src/hooks/useSprings.ts - Transitions → Controller: updates
packages/core/src/hooks/useTransition.tsx - Presence Lists → Controller: creates controllers
packages/core/src/hooks/usePresence.ts - Controller → Spring Values: manages
packages/core/src/Controller.ts - Controller → Async Updates: runs sequences
packages/core/src/Controller.ts - Spring Values → Prop Scheduling: schedules props
packages/core/src/SpringValue.ts - Spring Values → Async Updates: runs async goals
packages/core/src/SpringValue.ts - Spring Values → Frame Values: extends
packages/core/src/SpringValue.ts - Spring Values → Animated Values: reads animated node
packages/core/src/SpringValue.ts - Imperative Refs → Controller: controls
packages/core/src/SpringRef.ts - Animated Host → Animated Values: observes
packages/animated/src/createHost.ts - Web Target → Animated Host: creates host
packages/animated/src/createHost.ts - Three Target → Animated Host: creates host
- Parallax → Shared Helpers: uses helpers
packages/parallax/src/index.tsx - Spring Values → Frame Loop: advances values
packages/core/src/SpringValue.ts - Application → Imperative Refs: controls imperatively
README.md