Skip to content

docs: document npm publishing and CONTRIBUTING update - #486

Merged
gedu merged 9 commits into
callstack:mainfrom
gedu:docs/npm-publishing-guide
Oct 6, 2026
Merged

gedu merged 9 commits into
callstack:mainfrom
gedu:docs/npm-publishing-guide

Conversation

@gedu

@gedu gedu commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents how packages get to npm, and makes the contributing docs easier for both people and agents to follow.

I wrote the publishing part while doing the first publish of @callstack/create-react-native-brownfield (#480), so every step in it is one we actually ran.

What changed

  • Publishing to npm (CONTRIBUTING.md): the regular changesets flow, and a step-by-step for a new package. It also covers the gotchas we hit.
    • .claude/skills/publish-new-npm-package: a maintainer skill that walks an agent through the first publish.
  • Scripts (CONTRIBUTING.md): the section listed some scripts as root scripts that live in workspaces.
  • Verifying a change (CONTRIBUTING.md): a table of what to run before a PR depending on what you touched.
  • AGENTS.md: a short entry point for coding agents.

Copilot AI balanced review requested due to automatic review settings October 6, 2026 08:25
@gedu gedu self-assigned this Oct 6, 2026
@gedu
gedu requested a review from hurali97 October 6, 2026 08:28

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The skill can pack and publish a package before producing its required build artifacts.

Review effort: Balanced
Findings: 1 Medium severity · 2 Low severity

Open (3)
What changed in this PR

Documents repository verification, npm publishing, and agent workflows.

Changes:

  • Adds verification and script guidance.
  • Documents npm publishing and trusted publishers.
  • Adds agent instructions and a first-publish skill.
File Description
CONTRIBUTING.md Expands verification, publishing, and script documentation.
AGENTS.md Adds an agent-oriented repository entry point.
.claude/​skills/​publish-new-npm-package/​SKILL.md Guides first-time npm publishing.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .claude/skills/publish-new-npm-package/SKILL.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
@gedu
gedu merged commit 6294d5a into callstack:main Oct 6, 2026
13 checks passed
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.

3 participants