Skip to content

callstackincubator/apex-software-factory / .agents/skills/swm-react-native-best-practices

swm-react-native-best-practices

Verified

Software Mansion's best practices for React Native and Expo on the New Architecture: Reanimated 4 animations, Gesture Handler, react-native-svg, and react-native-worklets threading. Read the sub-skill in references/ that matches the topic.

references/animations/svg-animations.md

View on GitHub
# SVG Animation Patterns

react-native-svg implements the SVG standard as a React component tree, giving you full control over every element in an SVG — including the ability to animate or dynamically change individual parts. Every SVG element becomes a native view.

---

## Animating SVG Elements with Reanimated

Use `Animated.createAnimatedComponent` to make any SVG element animatable.

Do all value conversions directly inside the `useAnimatedStyle` or `useAnimatedProps` callback. Do **not** use `SVGAdapter` — handle conversions (string formatting, color processing, unit calculations) in place within the callback:

```tsx
import Animated, {
  useSharedValue,
  useAnimatedProps,
  withRepeat,
  withTiming,
} from "react-native-reanimated";
import { Circle, Svg } from "react-native-svg";

const AnimatedCircle = Animated.createAnimatedComponent(Circle);

export default function PulsingCircle() {
  const radius = useSharedValue(30);

  radius.value = withRepeat(withTiming(50, { duration: 600 }), -1, true);

  const animatedProps = useAnimatedProps(() => ({
    r: radius.value,
  }));

  return (
    <Svg width={120} height={120}>
      <AnimatedCircle cx={60} cy={60} animatedProps={animatedProps} fill="tomato" />
    </Svg>
  );
}
```

---

## Animating SVG Path (e.g. Progress Arc)

```tsx
import Animated, { useSharedValue, useAnimatedProps, withTiming } from "react-native-reanimated";
import { Path, Svg } from "react-native-svg";

const AnimatedPath = Animated.createAnimatedComponent(Path);

export default function ProgressArc({ progress }: { progress: number }) {
  const animatedProgress = useSharedValue(0);
  animatedProgress.value = withTiming(progress, { duration: 800 });

  const animatedProps = useAnimatedProps(() => {
    const angle = animatedProgress.value * 2 * Math.PI;
    const x = 60 + 50 * Math.cos(angle - Math.PI / 2);
    const y = 60 + 50 * Math.sin(angle - Math.PI / 2);
    const largeArc = animatedProgress.value > 0.5 ? 1 : 0;
    return {
      d: `M 60 10 A 50 50 0 ${largeArc} 1 ${x} ${y}`,
    };
  });

  return (
    <Svg width={120} height={120}>
      <AnimatedPath animatedProps={animatedProps} stroke="tomato" strokeWidth={4} fill="none" />
    </Svg>
  );
}
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall