How do I install the Framer Upgrade Migration skill?

Run npx skillmds@latest add gabrielmoreira/framer-upgrade-migration in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Framer Upgrade Migration safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Framer Upgrade Migration?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Framer Upgrade Migration free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Framer Upgrade Migration?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Framer Upgrade Migration by gabrielmoreira

Name: Framer Upgrade Migration
Rating: 4.666666666666667 (3 reviews)
Author: gabrielmoreira

Framer Upgrade Migration

Analyze, plan, and execute Framer SDK upgrades with breaking change detection. Use when upgrading Framer SDK versions, detecting deprecations, or migrating to new API versions. Trigger with phrases like "upgrade framer", "framer migration", "framer breaking changes", "update framer SDK", "analyze framer version".

gabrielmoreira Updated Sep 9, 2026 17 repo stars

File contents

Framer Upgrade & Migration

Prerequisites

Current release information, an inventory of site components, domains, integrations, and redirects, plus a staging site and rollback owner.

Output

Record versions/components reviewed, staging and canary outcome, redirect/integration checks, approver, and rollback state without copying visitor or credential data.

Error Handling

Stop promotion on routing, publishing, access, integration, or privacy mismatches; restore the prior version and review opaque failures before retrying.

Examples

Migrate a fictional staging page, compare published routes and a synthetic form flow, and roll back when a redirect or integration fails.

Overview

Guide for upgrading Framer plugin SDK, Server API, and migrating between Framer platform versions. Check the Framer Developer Changelog for breaking changes before upgrading.

Instructions

Step 1: Check Current Versions

npm list framer-plugin framer-api framer
npm view framer-plugin version
npm view framer-api version

Step 2: Review Changelog

Visit https://www.framer.com/developers/changelog for breaking changes.

Key migrations:

Plugin API 3.x: Introduced Managed Collections, Code File APIs
Server API beta: WebSocket-based programmatic access
Code Components v2: Updated property control types

Step 3: Upgrade Plugin SDK

git checkout -b upgrade/framer-plugin
npm install framer-plugin@latest
npm run build  # Check for type errors
npm test       # Run tests

Step 4: Common Migration Patterns

// Plugin API 2.x → 3.x: Collection APIs changed
// BEFORE: framer.createCollection(...)
// AFTER: framer.createManagedCollection(...)

// Code components: ControlType changes
// BEFORE: ControlType.FusedNumber
// AFTER: ControlType.Number (with min/max/step)

// Overrides: import path
// BEFORE: import { Override } from 'framer'
// AFTER: import { Override } from 'framer' (unchanged, but check type shape)

Step 5: Rollback

# Pin to previous version
npm install framer-plugin@3.x.x --save-exact

Resources

Next Steps

For CI integration, see framer-ci-integration.

---name: framer-upgrade-migrationdescription: Analyze, plan, and execute Framer SDK upgrades with breaking change detection. Use when upgrading Framer SDK versions, detecting deprecations, or migrating to new API versions. Trigger with phrases like "upgrade framer", "framer migration", "framer breaking changes", "update framer SDK", "analyze framer version".license: MIT---# Framer Upgrade & Migration ## Prerequisites Current release information, an inventory of site components, domains, integrations, and redirects, plus a staging site and rollback owner. ## Output Record versions/components reviewed, staging and canary outcome, redirect/integration checks, approver, and rollback state without copying visitor or credential data. ## Error Handling Stop promotion on routing, publishing, access, integration, or privacy mismatches; restore the prior version and review opaque failures before retrying. ## Examples Migrate a fictional staging page, compare published routes and a synthetic form flow, and roll back when a redirect or integration fails. ## Overview Guide for upgrading Framer plugin SDK, Server API, and migrating between Framer platform versions. Check the Framer Developer Changelog for breaking changes before upgrading. ## Instructions ### Step 1: Check Current Versions ```bash npm list framer-plugin framer-api framer npm view framer-plugin version npm view framer-api version ``` ### Step 2: Review Changelog Visit https://www.framer.com/developers/changelog for breaking changes. Key migrations: - **Plugin API 3.x**: Introduced Managed Collections, Code File APIs - **Server API beta**: WebSocket-based programmatic access - **Code Components v2**: Updated property control types ### Step 3: Upgrade Plugin SDK ```bash git checkout -b upgrade/framer-plugin npm install framer-plugin@latest npm run build # Check for type errors npm test # Run tests ``` ### Step 4: Common Migration Patterns ```typescript // Plugin API 2.x → 3.x: Collection APIs changed // BEFORE: framer.createCollection(...) // AFTER: framer.createManagedCollection(...) // Code components: ControlType changes // BEFORE: ControlType.FusedNumber // AFTER: ControlType.Number (with min/max/step) // Overrides: import path // BEFORE: import { Override } from 'framer' // AFTER: import { Override } from 'framer' (unchanged, but check type shape) ``` ### Step 5: Rollback ```bash # Pin to previous version npm install framer-plugin@3.x.x --save-exact ``` ## Resources - [Framer Changelog](https://www.framer.com/developers/changelog) - [Framer Upgrading Guide](https://www.framer.com/developers/upgrading) ## Next Steps For CI integration, see `framer-ci-integration`.

Frequently asked questions