Skip to content

docs(marketplace): add Application Marketplace section - #672

Draft
IvanHunters wants to merge 2 commits into
mainfrom
docs/marketplace
Draft

docs(marketplace): add Application Marketplace section#672
IvanHunters wants to merge 2 commits into
mainfrom
docs/marketplace

Conversation

@IvanHunters

Copy link
Copy Markdown
Contributor

What

Adds a new "Application Marketplace" section under docs/next/ documenting the PackageSource-based marketplace and the cozypkg CLI:

  • Overview (_index.md): the marketplace model, key objects (PackageSource, ApplicationDefinition, Tap, OCIRepository), the community. namespace, and the trust model. Cross-links the legacy External Apps page.
  • Publishing: scaffold, validate, and push a repository as an OCI artifact, plus listing it in the community index (entry format, two-lane merge policy, mandatory cosign).
  • Connecting: discover, connect (CLI and dashboard), install, and disconnect repositories on a cluster, including private repositories.
  • cozypkg Reference: every command and flag.

Why

The marketplace is a new way to extend the application catalog with external repositories. It has no user-facing documentation yet.

Notes

  • Content lives in docs/next/ (the unreleased trunk), so it is excluded from production builds until the feature ships. It documents functionality still in review upstream (feat(marketplace): community marketplace for External-Apps repositories cozystack#3940); the pages track that work and should land alongside the release that includes it.
  • Verified with a local Hugo development build: all four pages render, internal refs and anchors resolve, no build errors.

Document the PackageSource-based marketplace: publishing a repository
(init/validate/push and the community index), connecting a repository
to a cluster (search/tap/add and the dashboard), and a full cozypkg
command reference. Lives under docs/next/ as an upcoming-release feature.

Signed-off-by: IvanHunters <xorokhotnikov@gmail.com>
@netlify

netlify Bot commented Aug 31, 2026

Copy link
Copy Markdown

Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit 0e6e82d
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/6a9592b5a0a9c7000855d351
😎 Deploy Preview https://deploy-preview-672--cozystack.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Tapped repositories keep their own declared PackageSource name instead of a
community. prefix, and a clash with a core component is rejected at tap time.
Drops the reserved-name note and the --allow-reserved-names flag, updates the
CLI examples to declared names, and describes the collision behaviour and the
label-based untap.

Signed-off-by: IvanHunters <xorokhotnikov@gmail.com>
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.

1 participant