Initialize a new Mantine minor or major release: creates a git branch, sets up the changelog MDX page, updates mdx-meta-data.ts, mdx-nav-data.ts, and versions.ts, and commits. Use when the user wants to start a new release (e.g., "new release 9.1.0", "/new-mantine-release 9.1.0", "initialize 9.2.0 release").
Set up everything needed to start a new release. The user provides the version (e.g., 9.1.0).
Given version X.Y.0:
X.Y (e.g., 9.1)X-Y-0 (e.g., 9-1-0)910, 7170 for 7.17.0)date field of the first entry in allVersions in packages/@mantinex/mantine-meta/src/versions.ts — used as the placeholder dategit checkout -b X.Y
git config branch.X.Y.remote gitlab
git config branch.X.Y.merge refs/heads/X.Y
This creates branch X.Y and configures it to track the gitlab remote (not origin).
Read packages/@mantinex/mantine-meta/src/versions.ts and extract the date from the first entry in allVersions (e.g., 'May 26, 2026'). This is the placeholder date for the new release.
Create apps/mantine.dev/src/pages/changelog/X-Y-0.mdx:
import { Layout } from '@/layout';
import { MDX_DATA } from '@/mdx';
export default Layout(MDX_DATA.ChangelogKEYDIGITS);
## Support Mantine development
You can now sponsor Mantine development with [OpenCollective](https://opencollective.com/mantinedev).
All funds are used to improve Mantine and create new features and components.
<SponsorButton />
Replace KEYDIGITS with the key digits (e.g., Changelog910).
Edit apps/mantine.dev/src/mdx/data/mdx-meta-data.ts. Insert a new changelog entry after the last existing Changelog* entry and before PreviousChangelogs.
Format (note ordinal suffix on date day: "1st", "2nd", "3rd", "4th"…"26th"):
ChangelogKEYDIGITS: {
title: 'Version vX.Y.0',
slug: '/changelog/X-Y-0',
release: 'https://github.com/mantinedev/mantine/releases/tag/X.Y.0',
date: 'MONTH DAYth, YEAR',
searchTags: 'X-Y-0, KEYDIGITS',
},
Use the previous release date (with ordinal suffix on the day number) as the placeholder.
Edit apps/mantine.dev/src/mdx/mdx-nav-data.ts. In the GETTING_STARTED_PAGES_GROUP, find the Changelog category and insert MDX_DATA.ChangelogKEYDIGITS as the first page in the pages array (before the existing first changelog entry, e.g., MDX_DATA.Changelog900).
Edit packages/@mantinex/mantine-meta/src/versions.ts. Insert a new entry at the top of the allVersions array.
{
version: 'X.Y.0',
date: 'PREVIOUS_RELEASE_DATE',
github: 'https://github.com/mantinedev/mantine/releases/tag/X.Y.0',
link: 'https://mantine.dev/changelog/X-Y-0',
patches: [],
},
[mantine.dev] Initialize X.Y.0 release changelog