Skip to content

Add versions.json - one step closer to community plugins availability#54

Draft
growlf wants to merge 2 commits into
mtymek:mainfrom
growlf:feature/add-versions-json
Draft

Add versions.json - one step closer to community plugins availability#54
growlf wants to merge 2 commits into
mtymek:mainfrom
growlf:feature/add-versions-json

Conversation

@growlf
Copy link
Copy Markdown

@growlf growlf commented May 4, 2026

Summary

Adds versions.json file required for Obsidian Community Plugins submission. This is a critical step towards making the plugin available to all Obsidian users.

WHY THIS IS NEEDED

PROBLEM: The Obsidian Community Plugins system requires a versions.json file to:

  • Map plugin versions to minimum Obsidian app versions
  • Serve compatible plugin versions to users with older Obsidian installations
  • Validate plugin submissions to obsidianmd/obsidian-releases

CURRENT STATE: Without this file, the plugin cannot be submitted to the community plugins list, regardless of having releases or proper manifest.

Changes Made

Added versions.json

{
  "0.2.1": "1.4.0",
  "0.2.0": "1.4.0", 
  "0.1.0": "1.4.0",
  "0.0.1": "1.4.0"
}

HOW THIS HELPS:

  • ✅ Enables submission to obsidianmd/obsidian-releases
  • ✅ Allows Obsidian to find compatible versions for users with older app versions
  • ✅ Required validation check for community plugin approval
  • ✅ Maps all existing releases (v0.0.1 through v0.2.1) to Obsidian 1.4.0+

Comments Added to Code

The file includes detailed comments explaining:

  • Why this file is needed (community plugins requirement)
  • How it helps users with different Obsidian versions
  • The format and purpose of version mappings

Next Steps for Community Submission

Requirement Status
manifest.json ✅ Exists
GitHub Releases with assets ✅ v0.2.1+ (but marked pre-release)
versions.json Added in this PR
Unmark releases as pre-release ⚠️ Still needed
PR to obsidianmd/obsidian-releases ⚠️ Pending

Related

Testing

  • File is valid JSON
  • All existing release versions are mapped
  • Minimum Obsidian version matches manifest.json (minAppVersion: 1.4.0)

Note: This PR is from growlf/opencode-obsidian fork.

growlf added 2 commits May 4, 2026 12:42
- Maps plugin versions to minimum Obsidian versions
- Required for community plugin submission
- Step towards mtymek#53 (community plugins availability)
- Explains the purpose: required for Obsidian Community Plugins submission
- Documents how it helps: maps plugin versions to Obsidian versions
- Shows why it's needed: enables plugin to appear in Community Plugins browser
- Required for obsidianmd/obsidian-releases PR submission
@mtymek
Copy link
Copy Markdown
Owner

mtymek commented May 7, 2026

Cool, thanks for this contribution!

I would appreciate automating this - can you update the package.json and scripts/sync-manifest-version.ts accordingly?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants