hjemmesidekongen/expo-upgrading
plugins/smedjen/skills/expo-upgrading/SKILL.md
Expo SDK version migration — upgrade workflow, breaking changes, native module compatibility, and rollback strategy.
development
Updated Apr 5, 2026
$ install --global
skillsauthnpx skillsauth add hjemmesidekongen/ai expo-upgradingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 5:28 PM22.6s2 files scanned
SKILL.md
- name:
- expo-upgrading
- description:
- >
- user_invocable:
- false
- interactive:
- false
- model_tier:
- senior
- depends_on:
- []
- reads:
- []
- writes:
- []
- type:
- data_validation
- - name:
- rollback_documented
- verify:
- Rollback steps are noted before starting — git ref or branch to revert to
- fail_action:
- Document rollback path before proceeding — mid-upgrade failures are disruptive
- on_fail:
- Upgrade has unresolved risks — do not merge until all checks pass
- on_pass:
- Upgrade path is clean
- origin:
- smedjen
- inspired_by:
- expo-skills-main
- ported_date:
- 2026-03-10
- iteration:
- 1
- changes:
- Adapted from expo skill catalog for smedjen knowledge base
expo-upgrading
Expo SDK upgrades are predictable but require discipline. Primary failure modes: native module incompatibility, broken config plugins, untested platform behavior. All three are avoidable with a structured pre-upgrade audit.
Upgrade Workflow
npx expo install expo@<version> --fix — updates the SDK and aligns all bundled package versions. Never manually bump expo-* packages individually; version mismatches cause subtle runtime failures. Then run npx expo-doctor to surface remaining issues. For bare workflow, regenerate native directories: npx expo prebuild --clean.
Pre-Upgrade Checklist
- Clean working tree; create branch
upgrade/sdk-<version> - Note current SHA for rollback
- Read the SDK changelog at expo.fyi/changelog
- Audit every native module against SDK compatibility matrix
- Confirm Expo Go supports target SDK if used in dev
Breaking Changes
Each SDK ships with a new React Native version — check both changelogs. Common categories: permission API surface changes (expo-camera, expo-location), Metro config shape changes, babel-preset-expo updates, expo-router API changes. Migration guide at docs.expo.dev/workflow/upgrading-expo-sdk-walkthrough/.
Native Module Compatibility
expo-* modules are guaranteed compatible — install via npx expo install, never npm install expo-*@latest. For third-party modules: check the module's GitHub releases against the target RN version. If incompatible: wait for a release, pin the old SDK, or find an alternative.
Config Plugins Verification
Run npx expo prebuild --clean and confirm it completes without errors. --clean fully regenerates ios/ and android/ — stale native files from a partial upgrade are a common hidden failure source. Common issues: deprecated plugin options, plugin ordering conflicts, expo-modules-core API changes in custom plugins.
Testing Post-Upgrade
Physical device required — simulator misses camera, some location APIs, and push notifications. Test: permission flows, deep links, keyboard avoidance, OTA bundle receipt on old native binary (if using EAS Update).
Rollback
Pre-upgrade: note the current git SHA. Mid-upgrade: git checkout main && git branch -D upgrade/sdk-<version>. Post-merge: git revert -m 1 <merge-sha>. EAS: republish last-good bundle to the production channel with eas update.
Prebuild and Native Directory Management
Managed workflow: never edit ios/ or android/ directly. All customization via config plugins — this keeps the project prebuild-safe across upgrades. Write custom config plugins rather than dropping to bare workflow. See references/process.md for the full upgrade command sequence, version-specific notes, common pitfalls, and anti-patterns.
Related Skills
hjemmesidekongen/brand-strategy
development
VerifiedTrustedCommunity
Creates a brand from scratch through market research and interactive sparring. Runs competitive research via Perplexity, then guides the user through positioning, audience, voice, values, and content pillars. Produces the full brand guideline set at .ai/brand/{name}/. Use when building a new brand, defining brand strategy for a product, or when /våbenskjold:create is invoked.
SKILL.mdUpdated Apr 5, 2026
hjemmesidekongen/brand-loader
testing
VerifiedTrustedCommunity
Loads brand guidelines from .ai/brand/{name}/ and makes them available to the current context. Progressive disclosure: L1 confirms brand exists, L2 loads summary, L3 loads specific files on demand. Use when a downstream skill or user needs brand context, or when /våbenskjold:apply is invoked.
SKILL.mdUpdated Apr 5, 2026
hjemmesidekongen/brand-evolve
documentation
VerifiedTrustedCommunity
Guided reinvention of an existing brand guideline. Loads current brand from .ai/brand/{name}/, identifies what to keep vs change, and walks the user through targeted evolution. Preserves brand equity while updating positioning, voice, or values. Use when refreshing a brand or when /våbenskjold:evolve is invoked.
SKILL.mdUpdated Apr 5, 2026
hjemmesidekongen/brand-audit
development
VerifiedTrustedCommunity
Codifies an existing brand from materials, samples, and references. Analyzes provided content to extract voice patterns, values, and positioning. Produces the same guideline format as brand-strategy. Use when a brand already exists but isn't documented, or when /våbenskjold:audit is invoked.
SKILL.mdUpdated Apr 5, 2026