Repository navigation
Add the builder guide as a Claude plugin, rewritten for Cloud Run - #8
Merged
Merged
Conversation
The virtuals-platform plugin was written when the platform was going to be AWS (tools.virtuals.io, platform databases, Secrets Manager, an issue form) and lived in a repo that was never made. It's now in plugin/, and this repo is its marketplace, next to the templates and checker it describes. The guide matches the platform as built: Host an app in the bizops portal, GitHub secrets as the one place for settings, Google sign-in in front of every app (read the verified IAP email, no login pages), approved public apps, Cloud Storage and storage folders, finishing work before responding, and Supabase in Singapore for databases. The plugin keeps copies of the checker and templates; the Plugin in sync check fails a change that updates only one copy. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The
virtuals-platformClaude plugin is the guide Claude follows when someone builds an internal app. It was written when the platform was going to be AWS, and it describes things that don't exist:<name>.tools.virtuals.ioaddressesVirtual-Protocol/claude-plugins, which was never createdIt never left a local folder.
What this adds
plugin/: the plugin, with this repo as its marketplace (.claude-plugin/marketplace.json, marketplacevirtuals, pluginvirtuals-platform, version 1.0.0).plugin/skills/internal-app/SKILL.mdis rewritten to match the platform as built:lib/server/iap.tsis the example). Public apps need approval..env.exampleare the one place to change them. Changes made in Google Cloud are overwritten by the next deploy. Public build values go in Variables.STORAGE_BUCKET, orneeds.storage_folderfor apps that write to disk.templates/app/andactions/check/check.mjs, because a plugin can't reach files outside its folder. A new Plugin in sync check fails any change that updates only one copy.Most of the guide comes from what moving bizops and acp-ticket-cms actually needed.
Tested
claude plugin validatepasses for the marketplace and the plugin.🤖 Generated with Claude Code