# Nested Animated Components: Reusing Motion Inside Larger Designs

> Nested animated components are reusable pieces, such as a button, an icon or a character, placed inside a larger animated design. Each child owns its own states and exposes a few inputs; the parent sets those inputs rather than reaching inside. This keeps designs reusable, lets one fix update every instance, and stops complex scenes from turning into one tangled timeline.

Updated November 2026. Source: https://www.exodeui.com/learn/nested-animated-components/

## Key takeaways

- Define once, place many instances, override a few inputs
- Expose a small set of inputs and events per component
- Data flows down, events flow up
- Keep nesting to two or three levels and profile instance-heavy scenes

## Why nest at all

Without nesting, a dashboard with eight animated toggles contains eight copies of the toggle animation. Change the easing and you change it eight times. Components fix this the same way they do in Figma or React: define once, place many instances, override a few properties per instance.

## Give each component a small interface

Decide what the outside world is allowed to change. A good animated component exposes a handful of inputs and events, and keeps everything else private.

- Inputs: on/off, value, variant, colour, label text
- Events: pressed, completed, value changed
- Private: timelines, internal states, easing details

## Parent and child communication

Let data flow down and events flow up. The parent sets a child's inputs; the child reports events, and the parent decides what happens next. Avoid children changing each other directly, which creates hidden dependencies that are hard to debug once there are several levels.

## Keep nesting shallow

Two or three levels is usually enough: a screen contains cards, cards contain buttons and icons. Deeper nesting makes it hard to find where a state is set and can affect performance when every level runs its own state machine. Profile scenes with many instances on a mid-range phone.

## Building this in ExodeUI

ExodeUI, which we make, is built around this model: components with their own state machines, a small set of inputs and events, nested inside larger scenes. Everything lives in one open .exode JSON file, so developers can review it and AI coding tools can edit it through the ExodeUI MCP server.

## Frequently asked questions

### What are nested artboards?

An artboard or component placed inside another, so the inner design can be reused and controlled from the outer one.

### How does a parent control a nested animation?

By setting the child's exposed inputs. The child keeps its own states and reports events back.

### Do nested animations hurt performance?

They can when there are many instances, each running logic every frame. Test on real devices and pause off-screen instances.

### Is this the same as Figma components?

The idea is the same. The difference is that animated components also carry states and motion, not only appearance.

## Related

- [One animation asset for a design system](https://www.exodeui.com/learn/one-animation-asset-design-system/)
- [State machine UI](https://www.exodeui.com/learn/state-machine-ui/)
- [Best design system motion tools](https://www.exodeui.com/best-design-system-motion-tools/)
- [Micro-interaction library](https://www.exodeui.com/learn/micro-interaction-library/)
