Skip to content

Request: add documentation for how to delete a package from a changesets monorepo #1416

New issue
New issue
Closed
Closed
Request: add documentation for how to delete a package from a changesets monorepo#1416
Labels
docs

Description

@handeyeco
handeyeco
opened on Jul 15, 2024

Affected Packages

Hello 👋

@khanacademy/perseus-error

Problem

We moved @khanacademy/perseus-error into @khanacademy/perseus-core: Khan/perseus#1411

We searched for awhile, but didn't see any official documentation on deleting a package from changesets and changesets --help also didn't provide any clues. We ended up YOLO-ing it even though we got an error:

https://github.com/Khan/perseus/actions/runs/9941814947/job/27461831835

$ /home/runner/work/perseus/perseus/node_modules/.bin/changeset status --verbose --output changeset-status.json
🦋  error Error: Could not find package information for @khanacademy/perseus-error
🦋  error     at /home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:279:15
🦋  error     at Array.forEach (<anonymous>)
🦋  error     at /home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:271:44
🦋  error     at Array.forEach (<anonymous>)
🦋  error     at flattenReleases (/home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:266:14)
🦋  error     at Object.assembleReleasePlan [as default] (/home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:496:18)
🦋  error     at Object.getReleasePlan [as default] (/home/runner/work/perseus/perseus/node_modules/@changesets/get-release-plan/dist/get-release-plan.cjs.dev.js:71:49)
🦋  error     at async getStatus (/home/runner/work/perseus/perseus/node_modules/@changesets/cli/dist/cli.cjs.dev.js:1080:23)
🦋  error     at async run$2 (/home/runner/work/perseus/perseus/node_modules/@changesets/cli/dist/cli.cjs.dev.js:1355:11)
error Command failed with exit code 1.

Now we're getting release errors:

https://github.com/Khan/perseus/actions/runs/9942133564/job/27462868278

🦋  error Error: Could not find package information for @khanacademy/perseus-error
🦋  error     at /home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:279:15
🦋  error     at Array.forEach (<anonymous>)
🦋  error     at /home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:271:44
🦋  error     at Array.forEach (<anonymous>)
🦋  error     at flattenReleases (/home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:266:14)
🦋  error     at Object.assembleReleasePlan [as default] (/home/runner/work/perseus/perseus/node_modules/@changesets/assemble-release-plan/dist/assemble-release-plan.cjs.dev.js:496:18)
🦋  error     at version (/home/runner/work/perseus/perseus/node_modules/@changesets/cli/dist/cli.cjs.dev.js:599:60)
🦋  error     at async run$2 (/home/runner/work/perseus/perseus/node_modules/@changesets/cli/dist/cli.cjs.dev.js:1337:11)

Proposed solution

Any help resolving this issue would be appreciated, but I think ultimately the request is for documentation on how to properly delete a package from changesets.

Activity

  1. handeyeco commented on Jul 15, 2024

    @handeyeco
    handeyeco
    on Jul 15, 2024
    Author

    Okay, the problem seemed to be that there were changes in a changeset file before deleting the package. That's because work in the first PR made me realize I could delete the package in the second PR. To fix it, I filed another PR to remove perseus-error from the original changset file.

    PRs:

    Steps to repro:

            "@changesets/changelog-github": "^0.4.8",
        "@changesets/cli": "^2.22.0",
    1. Have a changesets monorepo
    2. Make a change to a package and go through the changesets flow so that there's a changeset file with that package
    3. Delete the package
    4. Go through the release process, note there's an error
    5. Delete the reference to the deleted package in the changesets file
    6. Go through the release process, note there's not an error

    Possible resolutions:

    • Document how to delete a package in a changesets monorepo
    • Add a helper that deletes a package and cleans up possible causes for errors
  2. bluwy
    added
    docs
    on Nov 18, 2025
  3. bluwy
    added a commit that references this issue on Jun 30, 2026

    Add simple section for deleting package

    1269884

  4. bluwy commented on Jun 30, 2026

    @bluwy
    bluwy
    on Jun 30, 2026
    Member

    This is documented on the site at 1269884 now

  5. bluwy
    closed this as completedon Jun 30, 2026
  6. soleuniverse101
    added a commit that references this issue on Jul 29, 2026

    Add new docs site (changesets#1979)

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    docs

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions