The Complete Production SOP: How to Deploy and Run Framer Motion Spring Physics & Micro-Interactions in Autonomous AI Agents

---
name: "framer-motion-micro-interactions"
description: "Build natural, responsive UI micro-interactions and gestures with Framer Motion."
metadata:
  author: "Framer"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "create framer motion button"
  - "use animatepresence exit animation"
  - "configure spring physics framer"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Framer Motion Spring Physics & Micro-Interactions

Implements declarative React motion components: whileHover, whileTap, drag constraints, spring physics (damping, stiffness, mass), and AnimatePresence exit animations.

## Execution SOP & Rules
1. Use motion.div rather than standard div elements for animated interactive wrappers.
2. Configure spring transitions: transition={{ type: 'spring', stiffness: 400, damping: 25 }}.
3. Always supply unique, stable key props to elements wrapped in <AnimatePresence>.
4. Animate only GPU-accelerated CSS properties: transform (x, y, scale, rotate) and opacity.

{
  "dependencies": {
    "framer-motion": "^11.18.0",
    "react": "^19.0.0",
    "react-dom": "^19.0.0"
  }
}

"use client";

import { motion } from "framer-motion";
import React from "react";

interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
  children: React.ReactNode;
}

export const InteractiveButton: React.FC<ButtonProps> = ({ children, onClick, ...props }) => {
  return (
    <motion.button
      whileHover={{ scale: 1.03 }}
      whileTap={{ scale: 0.97 }}
      transition={{ type: "spring", stiffness: 400, damping: 25 }}
      className="px-4 py-2 bg-indigo-600 text-white rounded-lg shadow-md focus:outline-none focus:ring-2 focus:ring-indigo-400"
      onClick={onClick}
      {...props}
    >
      {children}
    </motion.button>
  );
};

#!/usr/bin/env bash
set -euo pipefail
pnpm tsc --noEmit
pnpm build