From 2afc81be08ca2e22d4cbb1ccddd118bf612bdebc Mon Sep 17 00:00:00 2001
From: "Calum H. (IMB11)" <contact@cal.engineer>
Date: Fri, 6 Feb 2026 13:24:44 +0000
Subject: [PATCH 1/6] devex: changelog system

---
 .github/changelog/.gitkeep                    |   0
 ...ngelog-handling-across-hosting-website.yml |   3 +
 .../pages/news/changelog/[product]/[date].vue |   8 +-
 .../src/pages/news/changelog/index.vue        |  12 +-
 package.json                                  |   4 +-
 packages/assets/generated-icons.ts            |   4 +-
 packages/{utils => blog}/changelog.ts         |   2 +-
 packages/blog/index.ts                        |   1 +
 packages/blog/package.json                    |   1 +
 packages/ui/package.json                      |   1 +
 .../components/changelog/ChangelogEntry.vue   |   8 +-
 packages/ui/src/locales/en-US/index.json      |   5 +-
 packages/utils/index.ts                       |   1 -
 pnpm-lock.yaml                                |  29 ++
 scripts/bake-changelog.ts                     | 357 ++++++++++++++++++
 scripts/new-changelog.ts                      | 109 ++++++
 16 files changed, 515 insertions(+), 30 deletions(-)
 create mode 100644 .github/changelog/.gitkeep
 create mode 100644 .github/changelog/improved-changelog-handling-across-hosting-website.yml
 rename packages/{utils => blog}/changelog.ts (99%)
 create mode 100644 scripts/bake-changelog.ts
 create mode 100644 scripts/new-changelog.ts

diff --git a/.github/changelog/.gitkeep b/.github/changelog/.gitkeep
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/.github/changelog/improved-changelog-handling-across-hosting-website.yml b/.github/changelog/improved-changelog-handling-across-hosting-website.yml
new file mode 100644
index 0000000000..b18faf5d2f
--- /dev/null
+++ b/.github/changelog/improved-changelog-handling-across-hosting-website.yml
@@ -0,0 +1,3 @@
+product: platform
+type: improved
+description: Improved changelog handling across hosting, website and app.
diff --git a/apps/frontend/src/pages/news/changelog/[product]/[date].vue b/apps/frontend/src/pages/news/changelog/[product]/[date].vue
index d481f04156..7005fe0ab6 100644
--- a/apps/frontend/src/pages/news/changelog/[product]/[date].vue
+++ b/apps/frontend/src/pages/news/changelog/[product]/[date].vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { ChevronLeftIcon } from '@modrinth/assets'
+import { getChangelog } from '@modrinth/blog'
 import { ChangelogEntry, Timeline } from '@modrinth/ui'
-import { getChangelog } from '@modrinth/utils'
 
 const route = useRoute()
 
@@ -9,13 +9,9 @@ const changelogEntry = computed(() =>
 	route.params.date
 		? getChangelog().find((x) => {
 				if (x.product === route.params.product) {
-					console.log('Found matching product!')
-
 					if (x.version && x.version === route.params.date) {
-						console.log('Found matching version!')
 						return x
 					} else if (x.date.unix() === Number(route.params.date as string)) {
-						console.log('Found matching date!')
 						return x
 					}
 				}
@@ -27,7 +23,7 @@ const changelogEntry = computed(() =>
 const isFirst = computed(() => changelogEntry.value?.date === getChangelog()[0].date)
 
 if (!changelogEntry.value) {
-	createError({ statusCode: 404, statusMessage: 'Version not found' })
+	throw createError({ statusCode: 404, statusMessage: 'Version not found' })
 }
 </script>
 
diff --git a/apps/frontend/src/pages/news/changelog/index.vue b/apps/frontend/src/pages/news/changelog/index.vue
index 8663497d90..15feffcbdc 100644
--- a/apps/frontend/src/pages/news/changelog/index.vue
+++ b/apps/frontend/src/pages/news/changelog/index.vue
@@ -1,24 +1,18 @@
 <script setup lang="ts">
+import { getChangelog, type Product } from '@modrinth/blog'
 import { ChangelogEntry } from '@modrinth/ui'
 import Timeline from '@modrinth/ui/src/components/base/Timeline.vue'
-import { getChangelog, type Product } from '@modrinth/utils'
 
 import NavTabs from '~/components/ui/NavTabs.vue'
 
 const route = useRoute()
-const router = useRouter()
 
 const filter = ref<Product | undefined>(undefined)
 const allChangelogEntries = ref(getChangelog())
 
 function updateFilter() {
 	if (route.query.filter) {
-		let value = route.query.filter
-		if (route.query.filter === 'servers') {
-			router.push({ query: { ...route.query, filter: 'hosting' } })
-			value = 'hosting'
-		}
-		filter.value = value as Product
+		filter.value = route.query.filter as Product
 	} else {
 		filter.value = undefined
 	}
@@ -44,7 +38,7 @@ const changelogEntries = computed(() =>
 				href: '',
 			},
 			{
-				label: 'Website',
+				label: 'Platform',
 				href: 'web',
 			},
 			{
diff --git a/package.json b/package.json
index 1c19c0eb5d..2edcc34c5f 100644
--- a/package.json
+++ b/package.json
@@ -26,6 +26,7 @@
 		"scripts": "node scripts/run.mjs"
 	},
 	"devDependencies": {
+		"@clack/prompts": "^1.0.0",
 		"@modrinth/tooling-config": "workspace:*",
 		"@types/node": "^20.1.0",
 		"@vue/compiler-dom": "^3.5.26",
@@ -34,7 +35,8 @@
 		"if-ci": "^3.0.0",
 		"prettier": "^3.3.2",
 		"turbo": "^2.5.4",
-		"vue": "^3.5.13"
+		"vue": "^3.5.13",
+		"yaml": "^2.8.2"
 	},
 	"packageManager": "pnpm@9.15.0",
 	"pnpm": {
diff --git a/packages/assets/generated-icons.ts b/packages/assets/generated-icons.ts
index 22569d9b31..d960a5f4da 100644
--- a/packages/assets/generated-icons.ts
+++ b/packages/assets/generated-icons.ts
@@ -3,8 +3,6 @@
 
 import type { FunctionalComponent, SVGAttributes } from 'vue'
 
-export type IconComponent = FunctionalComponent<SVGAttributes>
-
 import _AffiliateIcon from './icons/affiliate.svg?component'
 import _AlignLeftIcon from './icons/align-left.svg?component'
 import _ArchiveIcon from './icons/archive.svg?component'
@@ -327,6 +325,8 @@ import _XCircleIcon from './icons/x-circle.svg?component'
 import _ZoomInIcon from './icons/zoom-in.svg?component'
 import _ZoomOutIcon from './icons/zoom-out.svg?component'
 
+export type IconComponent = FunctionalComponent<SVGAttributes>
+
 export const AffiliateIcon = _AffiliateIcon
 export const AlignLeftIcon = _AlignLeftIcon
 export const ArchiveIcon = _ArchiveIcon
diff --git a/packages/utils/changelog.ts b/packages/blog/changelog.ts
similarity index 99%
rename from packages/utils/changelog.ts
rename to packages/blog/changelog.ts
index 373706e5f4..191e9a949b 100644
--- a/packages/utils/changelog.ts
+++ b/packages/blog/changelog.ts
@@ -1,6 +1,6 @@
 import dayjs from 'dayjs'
 
-export type Product = 'web' | 'hosting' | 'api' | 'app'
+export type Product = 'web' | 'hosting' | 'app'
 
 export type VersionEntry = {
 	date: dayjs.Dayjs
diff --git a/packages/blog/index.ts b/packages/blog/index.ts
index 33a68a4440..1b1a2a20ae 100644
--- a/packages/blog/index.ts
+++ b/packages/blog/index.ts
@@ -1 +1,2 @@
+export * from './changelog'
 export { articles } from './compiled'
diff --git a/packages/blog/package.json b/packages/blog/package.json
index 2efdd3a0b2..3beb35ff49 100644
--- a/packages/blog/package.json
+++ b/packages/blog/package.json
@@ -18,6 +18,7 @@
 	},
 	"dependencies": {
 		"@modrinth/utils": "workspace:*",
+		"dayjs": "^1.11.10",
 		"glob": "^10.2.7",
 		"gray-matter": "^4.0.3",
 		"html-minifier-terser": "^7.2.0",
diff --git a/packages/ui/package.json b/packages/ui/package.json
index 23a0d857c7..4785d67377 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -52,6 +52,7 @@
 		"@codemirror/view": "^6.22.1",
 		"@modrinth/api-client": "workspace:*",
 		"@modrinth/assets": "workspace:*",
+		"@modrinth/blog": "workspace:*",
 		"@modrinth/utils": "workspace:*",
 		"@tanstack/vue-query": "^5.90.7",
 		"@tresjs/cientos": "^4.3.0",
diff --git a/packages/ui/src/components/changelog/ChangelogEntry.vue b/packages/ui/src/components/changelog/ChangelogEntry.vue
index 82e5b9e939..9d05207d64 100644
--- a/packages/ui/src/components/changelog/ChangelogEntry.vue
+++ b/packages/ui/src/components/changelog/ChangelogEntry.vue
@@ -42,8 +42,8 @@
 </template>
 
 <script setup lang="ts">
+import type { VersionEntry } from '@modrinth/blog/changelog'
 import { renderHighlightedString } from '@modrinth/utils'
-import type { VersionEntry } from '@modrinth/utils/changelog'
 import dayjs from 'dayjs'
 import { computed, ref } from 'vue'
 
@@ -80,7 +80,7 @@ const versionName = computed(() => props.entry.version ?? longDate.value)
 const messages = defineMessages({
 	web: {
 		id: 'changelog.product.web',
-		defaultMessage: 'Website',
+		defaultMessage: 'Platform',
 	},
 	hosting: {
 		id: 'changelog.product.hosting',
@@ -90,10 +90,6 @@ const messages = defineMessages({
 		id: 'changelog.product.app',
 		defaultMessage: 'App',
 	},
-	api: {
-		id: 'changelog.product.api',
-		defaultMessage: 'API',
-	},
 	justNow: {
 		id: 'changelog.justNow',
 		defaultMessage: 'Just now',
diff --git a/packages/ui/src/locales/en-US/index.json b/packages/ui/src/locales/en-US/index.json
index 679e92eeb8..eb2b6a95f6 100644
--- a/packages/ui/src/locales/en-US/index.json
+++ b/packages/ui/src/locales/en-US/index.json
@@ -155,9 +155,6 @@
   "changelog.justNow": {
     "defaultMessage": "Just now"
   },
-  "changelog.product.api": {
-    "defaultMessage": "API"
-  },
   "changelog.product.app": {
     "defaultMessage": "App"
   },
@@ -165,7 +162,7 @@
     "defaultMessage": "Hosting"
   },
   "changelog.product.web": {
-    "defaultMessage": "Website"
+    "defaultMessage": "Platform"
   },
   "collections.label.private": {
     "defaultMessage": "Private"
diff --git a/packages/utils/index.ts b/packages/utils/index.ts
index 26df429f62..c682345b1e 100644
--- a/packages/utils/index.ts
+++ b/packages/utils/index.ts
@@ -1,5 +1,4 @@
 export * from './billing'
-export * from './changelog'
 export * from './highlightjs'
 export * from './licenses'
 export * from './parse'
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7a9c23257f..b0535a6cff 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -13,6 +13,9 @@ importers:
 
   .:
     devDependencies:
+      '@clack/prompts':
+        specifier: ^1.0.0
+        version: 1.0.0
       '@modrinth/tooling-config':
         specifier: workspace:*
         version: link:packages/tooling-config
@@ -40,6 +43,9 @@ importers:
       vue:
         specifier: ^3.5.13
         version: 3.5.26(typescript@5.9.3)
+      yaml:
+        specifier: ^2.8.2
+        version: 2.8.2
 
   apps/app:
     dependencies:
@@ -464,6 +470,9 @@ importers:
       '@modrinth/utils':
         specifier: workspace:*
         version: link:../utils
+      dayjs:
+        specifier: ^1.11.10
+        version: 1.11.19
       glob:
         specifier: ^10.2.7
         version: 10.5.0
@@ -598,6 +607,9 @@ importers:
       '@modrinth/assets':
         specifier: workspace:*
         version: link:../assets
+      '@modrinth/blog':
+        specifier: workspace:*
+        version: link:../blog
       '@modrinth/utils':
         specifier: workspace:*
         version: link:../utils
@@ -1003,9 +1015,15 @@ packages:
     resolution: {integrity: sha512-8XqW8xGn++Eqqbz3e9wKuK7mxryeRjs4LOHLxbh2lwKeSbuNR4NFifDZT4KzvjU6HMOPbiNTsWpniK5EJfTWkg==}
     engines: {node: '>=18'}
 
+  '@clack/core@1.0.0':
+    resolution: {integrity: sha512-Orf9Ltr5NeiEuVJS8Rk2XTw3IxNC2Bic3ash7GgYeA8LJ/zmSNpSQ/m5UAhe03lA6KFgklzZ5KTHs4OAMA/SAQ==}
+
   '@clack/core@1.0.0-alpha.7':
     resolution: {integrity: sha512-3vdh6Ar09D14rVxJZIm3VQJkU+ZOKKT5I5cC0cOVazy70CNyYYjiwRj9unwalhESndgxx6bGc/m6Hhs4EKF5XQ==}
 
+  '@clack/prompts@1.0.0':
+    resolution: {integrity: sha512-rWPXg9UaCFqErJVQ+MecOaWsozjaxol4yjnmYcGNipAWzdaWa2x+VJmKfGq7L0APwBohQOYdHC+9RO4qRXej+A==}
+
   '@clack/prompts@1.0.0-alpha.8':
     resolution: {integrity: sha512-YZGC4BmTKSF5OturNKEz/y4xNjYGmGk6NI785CQucJ7OEdX0qbMmL/zok+9bL6c7qE3WSYffyK5grh2RnkGNtQ==}
 
@@ -9702,11 +9720,22 @@ snapshots:
     dependencies:
       fontkit: 2.0.4
 
+  '@clack/core@1.0.0':
+    dependencies:
+      picocolors: 1.1.1
+      sisteransi: 1.0.5
+
   '@clack/core@1.0.0-alpha.7':
     dependencies:
       picocolors: 1.1.1
       sisteransi: 1.0.5
 
+  '@clack/prompts@1.0.0':
+    dependencies:
+      '@clack/core': 1.0.0
+      picocolors: 1.1.1
+      sisteransi: 1.0.5
+
   '@clack/prompts@1.0.0-alpha.8':
     dependencies:
       '@clack/core': 1.0.0-alpha.7
diff --git a/scripts/bake-changelog.ts b/scripts/bake-changelog.ts
new file mode 100644
index 0000000000..ffa205a6c3
--- /dev/null
+++ b/scripts/bake-changelog.ts
@@ -0,0 +1,357 @@
+import { execSync } from 'child_process'
+import chalk from 'chalk'
+import * as fs from 'fs'
+import * as path from 'path'
+import { parse } from 'yaml'
+
+interface ChangelogFragment {
+	product: 'platform' | 'app' | 'hosting'
+	type: 'added' | 'improved' | 'fixed' | 'security' | 'changed' | 'removed'
+	pr?: number
+	author?: string
+	description: string
+}
+
+const PRODUCT_MAP: Record<string, string> = {
+	platform: 'web',
+	app: 'app',
+	hosting: 'hosting',
+}
+
+const VALID_PRODUCTS = ['platform', 'app', 'hosting']
+const VALID_TYPES = ['added', 'improved', 'fixed', 'security', 'changed', 'removed']
+
+const TYPE_TO_HEADER: Record<string, string> = {
+	security: '## Security fixes',
+	added: '## Added',
+	improved: '## Improvements',
+	fixed: '## Improvements',
+	removed: '## Improvements',
+	changed: '## Changes',
+}
+
+const SECTION_ORDER = ['## Security fixes', '## Added', '## Improvements', '## Changes']
+
+const IMPROVEMENTS_SUB_ORDER = ['improved', 'fixed', 'removed']
+
+function parseArgs(argv: string[]): { products: string[]; version?: string } {
+	const products: string[] = []
+	let version: string | undefined
+
+	let i = 0
+	while (i < argv.length) {
+		if (argv[i] === '--product') {
+			i++
+			while (i < argv.length && !argv[i].startsWith('--')) {
+				const p = argv[i]
+				if (!VALID_PRODUCTS.includes(p)) {
+					console.error(chalk.red(`Unknown product: ${p}`))
+					console.error(`Valid products: ${VALID_PRODUCTS.join(', ')}`)
+					process.exit(1)
+				}
+				products.push(p)
+				i++
+			}
+		} else if (argv[i] === '--version') {
+			i++
+			if (i >= argv.length || argv[i].startsWith('--')) {
+				console.error(chalk.red('--version requires a value'))
+				process.exit(1)
+			}
+			version = argv[i]
+			i++
+		} else {
+			console.error(chalk.red(`Unknown argument: ${argv[i]}`))
+			process.exit(1)
+		}
+	}
+
+	if (products.length === 0) {
+		console.error(chalk.red('At least one --product is required'))
+		console.error(
+			'Usage: pnpm scripts bake-changelog -- --product <platform|app|hosting> [--version X.Y.Z]',
+		)
+		process.exit(1)
+	}
+
+	if (products.includes('app') && !version) {
+		console.error(chalk.red('--version is required when baking app changelog'))
+		process.exit(1)
+	}
+
+	if (!products.includes('app') && version) {
+		console.error(chalk.yellow('Warning: --version is only used for app product, ignoring'))
+		version = undefined
+	}
+
+	return { products, version }
+}
+
+function readFragments(
+	changelogDir: string,
+): { fragment: ChangelogFragment; filename: string }[] {
+	if (!fs.existsSync(changelogDir)) {
+		return []
+	}
+
+	const files = fs
+		.readdirSync(changelogDir)
+		.filter((f) => f.endsWith('.yml') || f.endsWith('.yaml'))
+		.sort()
+
+	const fragments: { fragment: ChangelogFragment; filename: string }[] = []
+
+	for (const filename of files) {
+		const filepath = path.join(changelogDir, filename)
+		const content = fs.readFileSync(filepath, 'utf-8')
+
+		try {
+			const parsed = parse(content) as ChangelogFragment
+
+			if (!parsed.product || !parsed.type || !parsed.description) {
+				console.error(chalk.yellow(`Warning: Skipping ${filename} — missing required fields`))
+				continue
+			}
+
+			if (!VALID_PRODUCTS.includes(parsed.product)) {
+				console.error(
+					chalk.yellow(`Warning: Skipping ${filename} — invalid product: ${parsed.product}`),
+				)
+				continue
+			}
+
+			if (!VALID_TYPES.includes(parsed.type)) {
+				console.error(
+					chalk.yellow(`Warning: Skipping ${filename} — invalid type: ${parsed.type}`),
+				)
+				continue
+			}
+
+			fragments.push({ fragment: parsed, filename })
+		} catch (err) {
+			console.error(
+				chalk.yellow(
+					`Warning: Skipping ${filename} — invalid YAML: ${(err as Error).message}`,
+				),
+			)
+		}
+	}
+
+	return fragments
+}
+
+function resolvePr(changelogDir: string, filename: string): number | undefined {
+	try {
+		const filepath = path.join(changelogDir, filename)
+		const subject = execSync(`git log --diff-filter=A --format=%s -1 -- "${filepath}"`, {
+			encoding: 'utf-8',
+		}).trim()
+
+		if (!subject) return undefined
+
+		// Squash merge: "Some change (#1234)"
+		const squashMatch = subject.match(/\(#(\d+)\)\s*$/)
+		if (squashMatch) return parseInt(squashMatch[1], 10)
+
+		// Merge commit: "Merge pull request #1234 from ..."
+		const mergeMatch = subject.match(/Merge pull request #(\d+)/)
+		if (mergeMatch) return parseInt(mergeMatch[1], 10)
+
+		return undefined
+	} catch {
+		return undefined
+	}
+}
+
+function formatLine(fragment: ChangelogFragment): string {
+	const desc = fragment.description.trim()
+	if (fragment.author && fragment.pr) {
+		return `- ${desc} ([#${fragment.pr}](https://github.com/modrinth/code/pull/${fragment.pr}) by @${fragment.author})`
+	}
+	return `- ${desc}`
+}
+
+function buildBody(fragments: ChangelogFragment[]): string {
+	const sections = new Map<string, ChangelogFragment[]>()
+
+	for (const fragment of fragments) {
+		const header = TYPE_TO_HEADER[fragment.type]
+		if (!sections.has(header)) {
+			sections.set(header, [])
+		}
+		sections.get(header)!.push(fragment)
+	}
+
+	const parts: string[] = []
+
+	for (const header of SECTION_ORDER) {
+		const sectionFragments = sections.get(header)
+		if (!sectionFragments || sectionFragments.length === 0) continue
+
+		if (header === '## Improvements') {
+			sectionFragments.sort(
+				(a, b) => IMPROVEMENTS_SUB_ORDER.indexOf(a.type) - IMPROVEMENTS_SUB_ORDER.indexOf(b.type),
+			)
+		}
+
+		const lines = sectionFragments.map(formatLine)
+		parts.push(`${header}\n${lines.join('\n')}`)
+	}
+
+	return parts.join('\n\n')
+}
+
+function getCurrentPacificISO(): string {
+	const now = new Date()
+
+	const formatter = new Intl.DateTimeFormat('en-US', {
+		timeZone: 'America/Los_Angeles',
+		year: 'numeric',
+		month: '2-digit',
+		day: '2-digit',
+		hour: '2-digit',
+		minute: '2-digit',
+		second: '2-digit',
+		hour12: false,
+	})
+
+	const parts = formatter.formatToParts(now)
+	const get = (type: string) => parts.find((p) => p.type === type)?.value ?? '00'
+
+	const year = get('year')
+	const month = get('month')
+	const day = get('day')
+	const hour = get('hour')
+	const minute = get('minute')
+	const second = get('second')
+
+	// Determine PST vs PDT by comparing UTC offset
+	const jan = new Date(now.getFullYear(), 0, 1)
+	const jul = new Date(now.getFullYear(), 6, 1)
+	const stdOffset = Math.max(jan.getTimezoneOffset(), jul.getTimezoneOffset())
+	// Create a date in Pacific time to check if DST is active
+	const pacificNow = new Date(
+		now.toLocaleString('en-US', { timeZone: 'America/Los_Angeles' }),
+	)
+	const utcNow = new Date(now.toLocaleString('en-US', { timeZone: 'UTC' }))
+	const offsetMinutes = (utcNow.getTime() - pacificNow.getTime()) / 60000
+	const isDST = offsetMinutes !== stdOffset
+
+	const offsetStr = isDST ? '-07:00' : '-08:00'
+
+	return `${year}-${month}-${day}T${hour}:${minute}:${second}${offsetStr}`
+}
+
+function generateEntry(product: string, body: string, version?: string): string {
+	const dateStr = getCurrentPacificISO()
+	const tsProduct = PRODUCT_MAP[product]
+	const versionLine = version ? `\n\t\tversion: '${version}',` : ''
+
+	return `\t{
+\t\tdate: \`${dateStr}\`,
+\t\tproduct: '${tsProduct}',${versionLine}
+\t\tbody: \`${body}\`,
+\t},`
+}
+
+function insertIntoChangelog(changelogPath: string, entryString: string): void {
+	const content = fs.readFileSync(changelogPath, 'utf-8')
+
+	const marker = 'const VERSIONS: VersionEntry[] = ['
+	const markerIndex = content.indexOf(marker)
+
+	if (markerIndex === -1) {
+		console.error(chalk.red('Could not find VERSIONS array in changelog.ts'))
+		process.exit(1)
+	}
+
+	const insertPos = content.indexOf('\n', markerIndex) + 1
+
+	const newContent = content.slice(0, insertPos) + entryString + '\n' + content.slice(insertPos)
+
+	fs.writeFileSync(changelogPath, newContent, 'utf-8')
+}
+
+function deleteFragments(changelogDir: string, filenames: string[]): void {
+	for (const filename of filenames) {
+		fs.unlinkSync(path.join(changelogDir, filename))
+	}
+}
+
+function main() {
+	const args = process.argv.slice(2)
+	const { products, version } = parseArgs(args)
+
+	const rootDir = path.resolve(__dirname, '..')
+	const changelogDir = path.join(rootDir, '.github', 'changelog')
+	const changelogPath = path.join(rootDir, 'packages', 'blog', 'changelog.ts')
+
+	const allFragments = readFragments(changelogDir)
+
+	// Resolve PR numbers from git history for fragments that don't have one
+	for (const { fragment, filename } of allFragments) {
+		if (!fragment.pr) {
+			const pr = resolvePr(changelogDir, filename)
+			if (pr) {
+				fragment.pr = pr
+			} else {
+				console.log(
+					chalk.gray(`Could not resolve PR for ${filename} — no link will be added`),
+				)
+			}
+		}
+	}
+
+	if (allFragments.length === 0) {
+		console.error(chalk.yellow('No changelog fragments found in .github/changelog/'))
+		process.exit(1)
+	}
+
+	// Process in reverse so the last product processed ends up at the top of the array
+	const productsToProcess = [...products].reverse()
+
+	for (const product of productsToProcess) {
+		const productFragments = allFragments.filter((f) => f.fragment.product === product)
+
+		if (productFragments.length === 0) {
+			console.log(chalk.yellow(`No fragments found for product: ${product}`))
+			continue
+		}
+
+		const fragments = productFragments.map((f) => f.fragment)
+		const filenames = productFragments.map((f) => f.filename)
+
+		const body = buildBody(fragments)
+
+		if (body.includes('`')) {
+			console.error(
+				chalk.yellow(
+					`Warning: Baked body for ${product} contains backticks — this may break the template literal in changelog.ts`,
+				),
+			)
+		}
+
+		const entryVersion = product === 'app' ? version : undefined
+		const entryString = generateEntry(product, body, entryVersion)
+
+		insertIntoChangelog(changelogPath, entryString)
+
+		console.log(chalk.green(`Baked ${productFragments.length} fragment(s) for ${product}`))
+
+		if (product === 'app') {
+			console.log()
+			console.log(chalk.cyan('GitHub release body:'))
+			console.log(chalk.cyan('---'))
+			console.log(body)
+			console.log(chalk.cyan('---'))
+		}
+
+		deleteFragments(changelogDir, filenames)
+		console.log(chalk.gray(`Deleted ${filenames.length} fragment file(s)`))
+	}
+
+	console.log()
+	console.log(chalk.green('Done! Review the changes in packages/blog/changelog.ts'))
+}
+
+main()
diff --git a/scripts/new-changelog.ts b/scripts/new-changelog.ts
new file mode 100644
index 0000000000..18749e9b9b
--- /dev/null
+++ b/scripts/new-changelog.ts
@@ -0,0 +1,109 @@
+import * as p from '@clack/prompts'
+import chalk from 'chalk'
+import * as fs from 'fs'
+import * as path from 'path'
+import { stringify } from 'yaml'
+
+const PRODUCTS = [
+	{ value: 'platform', label: 'Modrinth Platform' },
+	{ value: 'app', label: 'Modrinth App' },
+	{ value: 'hosting', label: 'Modrinth Hosting' },
+] as const
+
+const TYPES = [
+	{ value: 'improved', label: 'Improved', hint: 'enhancement' },
+	{ value: 'added', label: 'Added', hint: 'new feature' },
+	{ value: 'fixed', label: 'Fixed', hint: 'bug fix' },
+	{ value: 'changed', label: 'Changed', hint: 'behavioral change' },
+	{ value: 'security', label: 'Security', hint: 'security fix' },
+	{ value: 'removed', label: 'Removed', hint: 'removed feature' },
+] as const
+
+function slugify(text: string): string {
+	return text
+		.toLowerCase()
+		.replace(/[^a-z0-9]+/g, '-')
+		.replace(/^-+|-+$/g, '')
+		.slice(0, 50)
+		.replace(/-+$/, '')
+}
+
+function cancel(): never {
+	p.cancel('Cancelled.')
+	process.exit(0)
+}
+
+async function main() {
+	const rootDir = path.resolve(__dirname, '..')
+	const changelogDir = path.join(rootDir, '.github', 'changelog')
+
+	p.intro(chalk.cyan('Create Changelog Fragment'))
+
+	const product = await p.select({
+		message: 'Which product is this change for?',
+		options: PRODUCTS.map((x) => ({ value: x.value, label: x.label })),
+	})
+	if (p.isCancel(product)) cancel()
+
+	const type = await p.select({
+		message: 'What type of change is this?',
+		options: TYPES.map((x) => ({ value: x.value, label: x.label, hint: x.hint })),
+	})
+	if (p.isCancel(type)) cancel()
+
+	const authorInput = await p.text({
+		message: 'External contributor username (leave empty if Modrinth team):',
+		defaultValue: '',
+	})
+	if (p.isCancel(authorInput)) cancel()
+
+	const author = (authorInput as string).trim() || undefined
+
+	const description = await p.text({
+		message: 'Description of the change:',
+		validate: (val) => {
+			if (!val.trim()) return 'Description is required'
+			return undefined
+		},
+	})
+	if (p.isCancel(description)) cancel()
+
+	const descStr = (description as string).trim()
+
+	if (descStr.includes('`')) {
+		p.log.warn('Description contains backticks — these may cause issues in the baked changelog.')
+	}
+
+	const fragment: Record<string, unknown> = {
+		product: product as string,
+		type: type as string,
+	}
+	if (author) {
+		fragment.author = author
+	}
+	fragment.description = descStr
+
+	const yamlContent = stringify(fragment, { lineWidth: 80 })
+
+	const slug = slugify(descStr)
+	const filename = `${slug}.yml`
+	const filepath = path.join(changelogDir, filename)
+
+	fs.mkdirSync(changelogDir, { recursive: true })
+
+	if (fs.existsSync(filepath)) {
+		const overwrite = await p.confirm({
+			message: `Fragment ${filename} already exists. Overwrite?`,
+		})
+		if (p.isCancel(overwrite) || !overwrite) cancel()
+	}
+
+	fs.writeFileSync(filepath, yamlContent, 'utf-8')
+
+	p.outro(`Created ${chalk.green(`.github/changelog/${filename}`)}`)
+}
+
+main().catch((err) => {
+	console.error(chalk.red('Error:'), err.message)
+	process.exit(1)
+})

From 1dd965aab6610fdfbeb81922bbab6b16962f2d14 Mon Sep 17 00:00:00 2001
From: "Calum H. (IMB11)" <contact@cal.engineer>
Date: Fri, 6 Feb 2026 13:36:29 +0000
Subject: [PATCH 2/6] feat: changelog CIs

---
 ...ngelog-handling-across-hosting-website.yml |   3 -
 .github/workflows/changelog-check.yml         |  69 ++++++++++
 .github/workflows/theseus-release.yml         |  36 ++++++
 scripts/bake-changelog.ts                     |  60 ++++++++-
 scripts/new-changelog.ts                      | 122 +++++++++---------
 5 files changed, 222 insertions(+), 68 deletions(-)
 delete mode 100644 .github/changelog/improved-changelog-handling-across-hosting-website.yml
 create mode 100644 .github/workflows/changelog-check.yml

diff --git a/.github/changelog/improved-changelog-handling-across-hosting-website.yml b/.github/changelog/improved-changelog-handling-across-hosting-website.yml
deleted file mode 100644
index b18faf5d2f..0000000000
--- a/.github/changelog/improved-changelog-handling-across-hosting-website.yml
+++ /dev/null
@@ -1,3 +0,0 @@
-product: platform
-type: improved
-description: Improved changelog handling across hosting, website and app.
diff --git a/.github/workflows/changelog-check.yml b/.github/workflows/changelog-check.yml
new file mode 100644
index 0000000000..52f42b9a58
--- /dev/null
+++ b/.github/workflows/changelog-check.yml
@@ -0,0 +1,69 @@
+name: Changelog Check
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  check:
+    name: Check for changelog
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📥 Check out code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 🔍 Check for changelog fragments
+        id: changelog
+        run: |
+          CHANGED_FILES=$(git diff --name-only --diff-filter=A origin/${{ github.event.pull_request.base.ref }}...HEAD -- '.github/changelog/*.yml')
+          if [ -z "$CHANGED_FILES" ]; then
+            echo "found=false" >> $GITHUB_OUTPUT
+          else
+            echo "found=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: 💬 Post or minimize changelog comment
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.CROWDIN_GH_TOKEN }}
+          script: |
+            const marker = '<!-- changelog-check -->';
+            const body = `${marker}\nThis pull request does not have a changelog! It's recommended to use \`pnpm scripts new-changelog\` to write one.`;
+            const hasChangelog = '${{ steps.changelog.outputs.found }}' === 'true';
+
+            // Find existing bot comments with our marker
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+
+            const botComments = comments.filter(c => c.body.includes(marker));
+
+            if (!hasChangelog) {
+              // Only post if we haven't already
+              if (botComments.length === 0) {
+                await github.rest.issues.createComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.issue.number,
+                  body,
+                });
+              }
+            } else {
+              // Minimize all existing bot comments
+              for (const comment of botComments) {
+                await github.graphql(`
+                  mutation($id: ID!) {
+                    minimizeComment(input: { subjectId: $id, classifier: OUTDATED }) {
+                      minimizedComment {
+                        isMinimized
+                      }
+                    }
+                  }
+                `, { id: comment.node_id });
+              }
+            }
diff --git a/.github/workflows/theseus-release.yml b/.github/workflows/theseus-release.yml
index 6cd2be01f6..3bfeaee911 100644
--- a/.github/workflows/theseus-release.yml
+++ b/.github/workflows/theseus-release.yml
@@ -24,6 +24,33 @@ jobs:
       LAUNCHER_FILES_BUCKET_BASE_URL: https://launcher-files.modrinth.com
 
     steps:
+      - name: 📥 Check out code
+        uses: actions/checkout@v4
+
+      - name: 🧰 Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: 🧰 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: 🧰 Install root dependencies
+        run: pnpm install -w
+
+      - name: 📝 Extract changelog body
+        id: changelog
+        env:
+          VERSION_TAG: ${{ inputs.version-tag }}
+        run: |
+          BODY=$(pnpm scripts bake-changelog -- --product app --version "${VERSION_TAG#v}" --extract)
+          {
+            echo "body<<CHANGELOG_EOF"
+            echo "$BODY"
+            echo "CHANGELOG_EOF"
+          } >> "$GITHUB_OUTPUT"
+
       - name: 📥 Download Modrinth App artifacts
         uses: dawidd6/action-download-artifact@v11
         with:
@@ -116,3 +143,12 @@ jobs:
           done
 
           aws s3 cp updates.json "s3://${AWS_BUCKET}"
+
+      - name: 🏷️ Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION_TAG: ${{ inputs.version-tag }}
+        run: |
+          gh release create "$VERSION_TAG" \
+            --title "Modrinth App ${VERSION_TAG#v}" \
+            --notes "${{ steps.changelog.outputs.body }}"
diff --git a/scripts/bake-changelog.ts b/scripts/bake-changelog.ts
index ffa205a6c3..350befe2b3 100644
--- a/scripts/bake-changelog.ts
+++ b/scripts/bake-changelog.ts
@@ -34,12 +34,21 @@ const SECTION_ORDER = ['## Security fixes', '## Added', '## Improvements', '## C
 
 const IMPROVEMENTS_SUB_ORDER = ['improved', 'fixed', 'removed']
 
-function parseArgs(argv: string[]): { products: string[]; version?: string } {
+function parseArgs(argv: string[]): {
+	products: string[]
+	version?: string
+	extract?: boolean
+} {
 	const products: string[] = []
 	let version: string | undefined
+	let extract = false
 
 	let i = 0
 	while (i < argv.length) {
+		if (argv[i] === '--') {
+			i++
+			continue
+		}
 		if (argv[i] === '--product') {
 			i++
 			while (i < argv.length && !argv[i].startsWith('--')) {
@@ -60,6 +69,9 @@ function parseArgs(argv: string[]): { products: string[]; version?: string } {
 			}
 			version = argv[i]
 			i++
+		} else if (argv[i] === '--extract') {
+			extract = true
+			i++
 		} else {
 			console.error(chalk.red(`Unknown argument: ${argv[i]}`))
 			process.exit(1)
@@ -69,11 +81,16 @@ function parseArgs(argv: string[]): { products: string[]; version?: string } {
 	if (products.length === 0) {
 		console.error(chalk.red('At least one --product is required'))
 		console.error(
-			'Usage: pnpm scripts bake-changelog -- --product <platform|app|hosting> [--version X.Y.Z]',
+			'Usage: pnpm scripts bake-changelog -- --product <platform|app|hosting> [--version X.Y.Z] [--extract]',
 		)
 		process.exit(1)
 	}
 
+	if (extract && products.length !== 1) {
+		console.error(chalk.red('--extract requires exactly one --product'))
+		process.exit(1)
+	}
+
 	if (products.includes('app') && !version) {
 		console.error(chalk.red('--version is required when baking app changelog'))
 		process.exit(1)
@@ -84,7 +101,7 @@ function parseArgs(argv: string[]): { products: string[]; version?: string } {
 		version = undefined
 	}
 
-	return { products, version }
+	return { products, version, extract }
 }
 
 function readFragments(
@@ -278,14 +295,49 @@ function deleteFragments(changelogDir: string, filenames: string[]): void {
 	}
 }
 
+function extractFromChangelog(changelogPath: string, product: string, version?: string): void {
+	const content = fs.readFileSync(changelogPath, 'utf-8')
+	const tsProduct = PRODUCT_MAP[product]
+
+	// Match entries in the VERSIONS array by finding the product and optional version
+	// The entries look like:
+	//   product: 'app',
+	//   version: '0.10.28',
+	//   body: `...`,
+	const entryRegex = version
+		? new RegExp(
+				`product:\\s*'${tsProduct}',\\s*\\n\\s*version:\\s*'${version.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}',\\s*\\n\\s*body:\\s*\`([\\s\\S]*?)\`,`,
+			)
+		: new RegExp(`product:\\s*'${tsProduct}',\\s*\\n\\s*body:\\s*\`([\\s\\S]*?)\`,`)
+
+	const match = content.match(entryRegex)
+
+	if (!match) {
+		console.error(
+			chalk.red(
+				`Could not find a ${tsProduct}${version ? ` v${version}` : ''} entry in changelog.ts`,
+			),
+		)
+		process.exit(1)
+	}
+
+	// Output just the body to stdout
+	process.stdout.write(match[1])
+}
+
 function main() {
 	const args = process.argv.slice(2)
-	const { products, version } = parseArgs(args)
+	const { products, version, extract } = parseArgs(args)
 
 	const rootDir = path.resolve(__dirname, '..')
 	const changelogDir = path.join(rootDir, '.github', 'changelog')
 	const changelogPath = path.join(rootDir, 'packages', 'blog', 'changelog.ts')
 
+	if (extract) {
+		extractFromChangelog(changelogPath, products[0], version)
+		return
+	}
+
 	const allFragments = readFragments(changelogDir)
 
 	// Resolve PR numbers from git history for fragments that don't have one
diff --git a/scripts/new-changelog.ts b/scripts/new-changelog.ts
index 18749e9b9b..58a717075d 100644
--- a/scripts/new-changelog.ts
+++ b/scripts/new-changelog.ts
@@ -1,5 +1,6 @@
 import * as p from '@clack/prompts'
 import chalk from 'chalk'
+import * as crypto from 'crypto'
 import * as fs from 'fs'
 import * as path from 'path'
 import { stringify } from 'yaml'
@@ -19,13 +20,8 @@ const TYPES = [
 	{ value: 'removed', label: 'Removed', hint: 'removed feature' },
 ] as const
 
-function slugify(text: string): string {
-	return text
-		.toLowerCase()
-		.replace(/[^a-z0-9]+/g, '-')
-		.replace(/^-+|-+$/g, '')
-		.slice(0, 50)
-		.replace(/-+$/, '')
+function hashContent(text: string): string {
+	return crypto.createHash('sha256').update(text).digest('hex').slice(0, 12)
 }
 
 function cancel(): never {
@@ -39,68 +35,72 @@ async function main() {
 
 	p.intro(chalk.cyan('Create Changelog Fragment'))
 
-	const product = await p.select({
-		message: 'Which product is this change for?',
-		options: PRODUCTS.map((x) => ({ value: x.value, label: x.label })),
-	})
-	if (p.isCancel(product)) cancel()
-
-	const type = await p.select({
-		message: 'What type of change is this?',
-		options: TYPES.map((x) => ({ value: x.value, label: x.label, hint: x.hint })),
-	})
-	if (p.isCancel(type)) cancel()
-
-	const authorInput = await p.text({
-		message: 'External contributor username (leave empty if Modrinth team):',
-		defaultValue: '',
-	})
-	if (p.isCancel(authorInput)) cancel()
-
-	const author = (authorInput as string).trim() || undefined
-
-	const description = await p.text({
-		message: 'Description of the change:',
-		validate: (val) => {
-			if (!val.trim()) return 'Description is required'
-			return undefined
-		},
-	})
-	if (p.isCancel(description)) cancel()
-
-	const descStr = (description as string).trim()
-
-	if (descStr.includes('`')) {
-		p.log.warn('Description contains backticks — these may cause issues in the baked changelog.')
-	}
+	const createdFiles: string[] = []
 
-	const fragment: Record<string, unknown> = {
-		product: product as string,
-		type: type as string,
-	}
-	if (author) {
-		fragment.author = author
-	}
-	fragment.description = descStr
+	while (true) {
+		const product = await p.select({
+			message: 'Which product is this change for?',
+			options: PRODUCTS.map((x) => ({ value: x.value, label: x.label })),
+		})
+		if (p.isCancel(product)) cancel()
 
-	const yamlContent = stringify(fragment, { lineWidth: 80 })
+		const type = await p.select({
+			message: 'What type of change is this?',
+			options: TYPES.map((x) => ({ value: x.value, label: x.label, hint: x.hint })),
+		})
+		if (p.isCancel(type)) cancel()
 
-	const slug = slugify(descStr)
-	const filename = `${slug}.yml`
-	const filepath = path.join(changelogDir, filename)
+		const authorInput = await p.text({
+			message: 'External contributor username (leave empty if Modrinth team):',
+			defaultValue: '',
+		})
+		if (p.isCancel(authorInput)) cancel()
 
-	fs.mkdirSync(changelogDir, { recursive: true })
+		const author = (authorInput as string).trim() || undefined
 
-	if (fs.existsSync(filepath)) {
-		const overwrite = await p.confirm({
-			message: `Fragment ${filename} already exists. Overwrite?`,
+		const description = await p.text({
+			message: 'Description of the change:',
+			validate: (val) => {
+				if (!val.trim()) return 'Description is required'
+				return undefined
+			},
 		})
-		if (p.isCancel(overwrite) || !overwrite) cancel()
-	}
+		if (p.isCancel(description)) cancel()
+
+		const descStr = (description as string).trim()
 
-	fs.writeFileSync(filepath, yamlContent, 'utf-8')
+		if (descStr.includes('`')) {
+			p.log.warn('Description contains backticks — these may cause issues in the baked changelog.')
+		}
+
+		const fragment: Record<string, unknown> = {
+			product: product as string,
+			type: type as string,
+		}
+		if (author) {
+			fragment.author = author
+		}
+		fragment.description = descStr
+
+		const yamlContent = stringify(fragment, { lineWidth: 80 })
+
+		const hash = hashContent(yamlContent)
+		const filename = `${hash}.yml`
+		const filepath = path.join(changelogDir, filename)
+
+		fs.mkdirSync(changelogDir, { recursive: true })
+		fs.writeFileSync(filepath, yamlContent, 'utf-8')
+		createdFiles.push(filename)
+
+		p.log.success(`Created ${chalk.green(`.github/changelog/${filename}`)}`)
+
+		const another = await p.confirm({
+			message: 'Add another changelog entry?',
+		})
+		if (p.isCancel(another) || !another) break
+	}
 
-	p.outro(`Created ${chalk.green(`.github/changelog/${filename}`)}`)
+	p.outro(`Created ${createdFiles.length} fragment(s)`)
 }
 
 main().catch((err) => {

From 9046978117a2e5725da392d81e07c39a1eb7f386 Mon Sep 17 00:00:00 2001
From: "Calum H. (IMB11)" <contact@cal.engineer>
Date: Fri, 6 Feb 2026 13:45:13 +0000
Subject: [PATCH 3/6] feat: web alias for platform + hosting

---
 scripts/bake-changelog.ts | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/scripts/bake-changelog.ts b/scripts/bake-changelog.ts
index 350befe2b3..cd20f0a5f6 100644
--- a/scripts/bake-changelog.ts
+++ b/scripts/bake-changelog.ts
@@ -19,6 +19,9 @@ const PRODUCT_MAP: Record<string, string> = {
 }
 
 const VALID_PRODUCTS = ['platform', 'app', 'hosting']
+const PRODUCT_ALIASES: Record<string, string[]> = {
+	web: ['platform', 'hosting'],
+}
 const VALID_TYPES = ['added', 'improved', 'fixed', 'security', 'changed', 'removed']
 
 const TYPE_TO_HEADER: Record<string, string> = {
@@ -53,12 +56,19 @@ function parseArgs(argv: string[]): {
 			i++
 			while (i < argv.length && !argv[i].startsWith('--')) {
 				const p = argv[i]
-				if (!VALID_PRODUCTS.includes(p)) {
+				if (PRODUCT_ALIASES[p]) {
+					for (const alias of PRODUCT_ALIASES[p]) {
+						if (!products.includes(alias)) products.push(alias)
+					}
+				} else if (VALID_PRODUCTS.includes(p)) {
+					if (!products.includes(p)) products.push(p)
+				} else {
 					console.error(chalk.red(`Unknown product: ${p}`))
-					console.error(`Valid products: ${VALID_PRODUCTS.join(', ')}`)
+					console.error(
+						`Valid products: ${VALID_PRODUCTS.join(', ')} (aliases: ${Object.keys(PRODUCT_ALIASES).join(', ')})`,
+					)
 					process.exit(1)
 				}
-				products.push(p)
 				i++
 			}
 		} else if (argv[i] === '--version') {
@@ -81,7 +91,7 @@ function parseArgs(argv: string[]): {
 	if (products.length === 0) {
 		console.error(chalk.red('At least one --product is required'))
 		console.error(
-			'Usage: pnpm scripts bake-changelog -- --product <platform|app|hosting> [--version X.Y.Z] [--extract]',
+			'Usage: pnpm scripts bake-changelog -- --product <platform|app|hosting|web> [--version X.Y.Z] [--extract]',
 		)
 		process.exit(1)
 	}

From 593c773fe1af5e705c6519167e04e4cb3204bc2f Mon Sep 17 00:00:00 2001
From: "Calum H. (IMB11)" <contact@cal.engineer>
Date: Fri, 6 Feb 2026 13:50:42 +0000
Subject: [PATCH 4/6] feat: upload binaries to gh release

---
 .github/workflows/theseus-release.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/theseus-release.yml b/.github/workflows/theseus-release.yml
index 3bfeaee911..3b5fac6c28 100644
--- a/.github/workflows/theseus-release.yml
+++ b/.github/workflows/theseus-release.yml
@@ -149,6 +149,13 @@ jobs:
           GH_TOKEN: ${{ github.token }}
           VERSION_TAG: ${{ inputs.version-tag }}
         run: |
+          VERSION="${VERSION_TAG#v}"
+
           gh release create "$VERSION_TAG" \
-            --title "Modrinth App ${VERSION_TAG#v}" \
-            --notes "${{ steps.changelog.outputs.body }}"
+            --title "Modrinth App ${VERSION}" \
+            --notes "${{ steps.changelog.outputs.body }}" \
+            "${WINDOWS_X64_BUNDLE_ARTIFACT_NAME}/release/bundle/nsis/Modrinth App_${VERSION}_x64-setup.exe" \
+            "${MACOS_UNIVERSAL_BUNDLE_ARTIFACT_NAME}/universal-apple-darwin/release/bundle/dmg/Modrinth App_${VERSION}_universal.dmg" \
+            "${LINUX_X64_BUNDLE_ARTIFACT_NAME}/release/bundle/appimage/Modrinth App_${VERSION}_amd64.AppImage" \
+            "${LINUX_X64_BUNDLE_ARTIFACT_NAME}/release/bundle/deb/Modrinth App_${VERSION}_amd64.deb" \
+            "${LINUX_X64_BUNDLE_ARTIFACT_NAME}/release/bundle/rpm/Modrinth App-${VERSION}-1.x86_64.rpm"

From f902ed505eb76da8ccca81b4ae40a654cc1fca2f Mon Sep 17 00:00:00 2001
From: "Calum H. (IMB11)" <contact@cal.engineer>
Date: Fri, 6 Feb 2026 13:53:57 +0000
Subject: [PATCH 5/6] feat: improve copy text

---
 .github/workflows/changelog-check.yml | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/changelog-check.yml b/.github/workflows/changelog-check.yml
index 52f42b9a58..23f487a2dd 100644
--- a/.github/workflows/changelog-check.yml
+++ b/.github/workflows/changelog-check.yml
@@ -31,7 +31,7 @@ jobs:
           github-token: ${{ secrets.CROWDIN_GH_TOKEN }}
           script: |
             const marker = '<!-- changelog-check -->';
-            const body = `${marker}\nThis pull request does not have a changelog! It's recommended to use \`pnpm scripts new-changelog\` to write one.`;
+            const body = `${marker}\n> [!NOTE]\n> No changelog fragment was found for this pull request. If this PR includes user-facing changes, run \`pnpm scripts new-changelog\` to create one.`;
             const hasChangelog = '${{ steps.changelog.outputs.found }}' === 'true';
 
             // Find existing bot comments with our marker
@@ -44,8 +44,14 @@ jobs:
             const botComments = comments.filter(c => c.body.includes(marker));
 
             if (!hasChangelog) {
-              // Only post if we haven't already
-              if (botComments.length === 0) {
+              if (botComments.length > 0) {
+                await github.rest.issues.updateComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  comment_id: botComments[0].id,
+                  body,
+                });
+              } else {
                 await github.rest.issues.createComment({
                   owner: context.repo.owner,
                   repo: context.repo.repo,

From a5381b3d0256b16bebd30bd04a4f2caea1165104 Mon Sep 17 00:00:00 2001
From: "Calum H. (IMB11)" <contact@cal.engineer>
Date: Sat, 7 Feb 2026 21:13:19 +0000
Subject: [PATCH 6/6] fix: release workflow

---
 .github/workflows/theseus-release.yml | 29 +++++++++------------------
 1 file changed, 9 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/theseus-release.yml b/.github/workflows/theseus-release.yml
index 3b5fac6c28..30ce59cc52 100644
--- a/.github/workflows/theseus-release.yml
+++ b/.github/workflows/theseus-release.yml
@@ -1,23 +1,19 @@
 name: Modrinth App release
 on:
-  workflow_dispatch:
-    inputs:
-      version-tag:
-        description: Version tag to release to the wide public
-        type: string
-        required: true
-      release-notes:
-        description: Release notes to include in the Tauri version manifest
-        default: A new release of the Modrinth App is available!
-        type: string
-        required: true
+  workflow_run:
+    workflows: ['Modrinth App build']
+    types: [completed]
 
 jobs:
   release:
     name: Release Modrinth App
+    if: >-
+      github.event.workflow_run.conclusion == 'success' &&
+      startsWith(github.event.workflow_run.head_branch, 'v')
     runs-on: ubuntu-latest
 
     env:
+      VERSION_TAG: ${{ github.event.workflow_run.head_branch }}
       LINUX_X64_BUNDLE_ARTIFACT_NAME: App bundle (x86_64-unknown-linux-gnu)
       WINDOWS_X64_BUNDLE_ARTIFACT_NAME: App bundle (x86_64-pc-windows-msvc)
       MACOS_UNIVERSAL_BUNDLE_ARTIFACT_NAME: App bundle (universal-apple-darwin)
@@ -41,8 +37,6 @@ jobs:
 
       - name: 📝 Extract changelog body
         id: changelog
-        env:
-          VERSION_TAG: ${{ inputs.version-tag }}
         run: |
           BODY=$(pnpm scripts bake-changelog -- --product app --version "${VERSION_TAG#v}" --extract)
           {
@@ -57,18 +51,15 @@ jobs:
           workflow: theseus-build.yml
           workflow_conclusion: success
           event: push
-          branch: ${{ inputs.version-tag }}
+          branch: ${{ env.VERSION_TAG }}
           use_unzip: true
 
       - name: 🛠️ Generate version manifest
-        env:
-          VERSION_TAG: ${{ inputs.version-tag }}
-          RELEASE_NOTES: ${{ inputs.release-notes }}
         run: |
           # Reference: https://tauri.app/plugin/updater/#server-support
           jq -nc \
             --arg versionTag "${VERSION_TAG#v}" \
-            --arg releaseNotes "$RELEASE_NOTES" \
+            --arg releaseNotes "${{ steps.changelog.outputs.body }}" \
             --rawfile macOsAarch64UpdateArtifactSignature "${MACOS_UNIVERSAL_BUNDLE_ARTIFACT_NAME}/universal-apple-darwin/release/bundle/macos/Modrinth App.app.tar.gz.sig" \
             --rawfile macOsX64UpdateArtifactSignature "${MACOS_UNIVERSAL_BUNDLE_ARTIFACT_NAME}/universal-apple-darwin/release/bundle/macos/Modrinth App.app.tar.gz.sig" \
             --rawfile linuxX64UpdateArtifactSignature "${LINUX_X64_BUNDLE_ARTIFACT_NAME}/release/bundle/appimage/Modrinth App_${VERSION_TAG#v}_amd64.AppImage.tar.gz.sig" \
@@ -110,7 +101,6 @@ jobs:
 
       - name: 📤 Upload release artifacts
         env:
-          VERSION_TAG: ${{ inputs.version-tag }}
           AWS_ACCESS_KEY_ID: ${{ secrets.LAUNCHER_FILES_BUCKET_ACCESS_KEY_ID }}
           AWS_SECRET_ACCESS_KEY: ${{ secrets.LAUNCHER_FILES_BUCKET_SECRET_ACCESS_KEY }}
           AWS_BUCKET: ${{ secrets.LAUNCHER_FILES_BUCKET_NAME }}
@@ -147,7 +137,6 @@ jobs:
       - name: 🏷️ Create GitHub release
         env:
           GH_TOKEN: ${{ github.token }}
-          VERSION_TAG: ${{ inputs.version-tag }}
         run: |
           VERSION="${VERSION_TAG#v}"