@motion.page/sdk 0.1.3 → 1.0.0

package/README.md

@@ -4,7 +4,7 @@ A high-performance animation SDK with a declarative API. Scroll-triggered animat
 
 [![npm version](https://img.shields.io/npm/v/@motion.page/sdk)](https://www.npmjs.com/package/@motion.page/sdk)
 [![Bundle Size](https://img.shields.io/bundlephobia/minzip/@motion.page/sdk)](https://bundlephobia.com/package/@motion.page/sdk)
-[![License](https://img.shields.io/badge/license-FSL--1.1--Apache--2.0-blue)](./LICENSE)
+[![License](https://img.shields.io/badge/license-FSL--1.1--Apache--2.0-blue)](#license)
 
 ---
 
@@ -12,6 +12,7 @@ A high-performance animation SDK with a declarative API. Scroll-triggered animat
 
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [AI Agent Support](#ai-agent-support)
 - [Core Concept](#core-concept)
 - [Implicit Values](#implicit-values)
 - [API Reference](#api-reference)
@@ -42,8 +43,6 @@ yarn add @motion.page/sdk
 pnpm add @motion.page/sdk
 ```
 
-📖 Full documentation and interactive examples: [motion.page](https://motion.page)
-
 > **⚠️ Browser-only:** This SDK requires a browser environment (`document`, `window`). In SSR frameworks (Next.js, Nuxt, Astro), wrap SDK calls in `useEffect`, `onMounted`, or client-side scripts.
 
 For direct browser use without a bundler, see [Browser Build](#browser-build).
@@ -137,6 +136,24 @@ Motion('audio-fade', state, {
 
 ---
 
+## AI Agent Support
+
+This package includes built-in support for AI coding assistants.
+
+**`llms.txt` included** — An `llms.txt` file (per the [llmstxt.org](https://llmstxt.org) standard) ships with the package and is automatically discoverable by AI assistants when `@motion.page/sdk` is installed in `node_modules`. It provides a structured index of the entire SDK API so agents can answer questions and generate correct code without hallucinating APIs.
+
+**Full skill plugin** — For comprehensive AI-assisted development — complete API reference, 50+ examples, and GSAP / Framer Motion migration guides — install the official plugin:
+
+```bash
+# Universal (40+ agents)
+npx skills add motion-page/claude-plugin
+
+# Claude Code
+/install-plugin npm:@motion.page/claude-plugin
+```
+
+---
+
 ## Core Concept
 
 Every animation in the SDK is a **named timeline**. The name is the first argument to `Motion()` and acts as a registry key — calling `Motion('same-name')` always returns the same `Timeline` instance.
@@ -1193,34 +1210,16 @@ import { Types } from '@motion.page/sdk';
 
 ---
 
-## AI Agent Support
-
-This package includes built-in support for AI coding assistants.
-
-**`llms.txt` included** — An `llms.txt` file (per the [llmstxt.org](https://llmstxt.org) standard) ships with the package and is automatically discoverable by AI assistants when `@motion.page/sdk` is installed in `node_modules`. It provides a structured index of the entire SDK API so agents can answer questions and generate correct code without hallucinating APIs.
-
-**Full skill plugin** — For comprehensive AI-assisted development — complete API reference, 50+ examples, and GSAP / Framer Motion migration guides — install the official plugin:
-
-```bash
-# Universal (40+ agents)
-npx skills add motion-page/claude-plugin
-
-# Claude Code
-/install-plugin npm:@motion.page/claude-plugin
-```
-
----
-
 ## Browser Build
 
-### Browser Build (IIFE)
-
 An IIFE build script is included but not part of the default build output. To generate a browser bundle:
 
 ```bash
 bun run packages/sdk/scripts/build-iife.ts
 ```
 
+> **Note:** This script is available in the [source repository](https://motion.page) only. It is not included in the npm package.
+
 This creates a self-contained script that exposes `window.Motion` and `window.MotionTimeline`:
 
 ```html
@@ -1252,12 +1251,12 @@ Modern evergreen browsers:
 
 ## License
 
-**FSL-1.1-Apache-2.0** — [Functional Source License, Version 1.1, Apache 2.0 Future License](./LICENSE)
+**FSL-1.1-Apache-2.0** — [Functional Source License, Version 1.1, Apache 2.0 Future License](#license)
 
-**TL;DR:** Free for everyone. Use it in your websites, apps, SaaS products, client projects — commercial or not. No restrictions.
+**TL;DR:** Free for everyone. Use it in your websites, apps, SaaS products, client projects — commercial or not. One restriction: you can't use it to build a competing animation builder tool.
 
 **The one exception:** You cannot use this SDK to build a product that competes with Motion.page (e.g., a no-code animation builder, visual animation editor, or similar tool). If you're building something like that, [contact us](mailto:hello@motion.page) for an enterprise license.
 
 After 2 years from each release, the code converts to the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license with no restrictions at all.
 
-See [LICENSE](./LICENSE) for the full legal text.
+See [LICENSE](#license) for the full legal text.