🪴/ changesets

or: how to version and document a project's changelog

Nov 02, 2026 – Caleb Jasik

after using atlassian changesets for versioning at astro, i've fallen in love.

in my own time, i've mostly used it on

https://npmx.dev/package/@jasikpark/astro-svg-loader

it's a good workflow:

new changes are .changeset/*.md files, with frontmatter like:

---
"@jasikpark/astro-svg-loader": minor
---




Update to allow Astro v3 as a valid peer dep

on PR merge, a Github Action picks it up and rolls it up into a "Release PR", it autocalculates the next package version, collates the changes into a new addition to the CHANGELOG.md wherever you've configured it, and importantly just appends rather than requiring prior changelog formats to be consistent with it. Makes for easy migration from whatever bespoke system you had before.

A beauty of the individual changeset files in a folder approach is that w/ the autogenerated random filenames, you'll never get a file conflict, unlike manually editing CHANGELOG.md on every PR that needs to add changes.

Most times, a project only wants same-language devtools though, so luckily there's been work to port the concept to other languages:

KnopeAutomate tedious developer tasks

Knope is a great tool for Rust crates, it generally replicates the full workflow and turn-key approach that changesets offers, and adds on conventional commit support as well!

monorel: changesets-style releases for Go monoreposA release tool for single-module and multi-module Go repos. Per-PR intent via .changeset files, native Go tag conventions, always-open release PR.

In my survey of Golang options, I found monorel, which seems like a solid project from my glance at the docs and yapping with ChatGPT about it in the car, though it seems a bit green with the only users of it being monorel itself + a logging library for Golang by the same author.

LMK if you've had thoughts about how to automate/improve release tracking / publishing!

Comment on this post on bluesky

Posts from blogs I follow

On Accountability

In 2024, I attended ICST in Toronto. I went to attend the first "Artificial Intelligence in Software Testing" workshop (AIST), where I gave a tutorial on a potential competition and participated in a panel (which, turned into a roundtable discussion) about...

via Addison CrumpJuly 13, 2026

Touching Grass Isn’t Enough: The Furry Fandom’s Issues Are Structural

The problems with the furry fandom today are not as simple as,“Furries need to touch grass!” Unfortunately, whatever you’re seeing that makes you want to say such a thing is probably a structural problem with multiple compounding factors. I will elaborate....

via Dhole MomentsOctober 2, 2026

[essays] jj init

Jujutsu (`jj`) is a new version control system from a software developer at Google. I have been using it full time for 6 months. Here’s why you should switch, too.

via Essays — Sympolymathesy, by Chris KrychoFebruary 2, 2024

Generated byastro-openring

Subscribe