obsidian-upgrade-migration

# Obsidian Upgrade Migration ## Current State !`npm list 2>/dev/null | head -20` !`cat manifest.json 2>/dev/null || echo 'No manifest.json in cwd'` ## Overview Upgrade an Obsidian plugin between versions: migrate persisted settings with version checks, replace deprecated API calls, update `manifest.json` `minAppVersion`, and test across Obsidian releases. ## Prerequisites - Existing Obsidian plugin with source code - Current `manifest.json` and `versions.json` - Access to [Obsidian changelog](https://obsidian.md/changelog) and [breaking changes docs](https://docs.obsidian.md/Plugins/Releasing/Breaking+changes) - Node.js 18+ with npm or pnpm ## Instructions ### Step 1: Audit Current Version Compatibility Check what your plugin currently targets and what the user's Obsidian version requires: ```bash # Current plugin target echo "=== manifest.json ===" cat manifest.json | python3 -c " import json, sys m = json.load(sys.stdin) print(f\"Plugin: {m['id']} v{m['version']}\") print(f\"minAppVersion: {m['minAppVersion']}\") " # Current obsidian type definitions echo "=== obsidian package version ===" npm ls obsidian 2>/dev/null || echo "Not found in node_modules" # Check versions.json for version history echo "=== versions.json ===" cat versions.json 2>/dev/null | python3 -m json.tool || echo "No versions.json" ``` ### Step 2: Update the Obsidian Type Definitions ```bash # Update to latest obsidian types npm install obsidian@latest --save-dev # Check what changed npm diff ...