# Cf Temp Mail Version Upgrade

> Upgrade the project version number. Use when the user asks to bump the version, upgrade the version, or prepare a new release version. Supports major, minor, and patch upgrades.

- Skill: `dreamhunter2333/cf-temp-mail-version-upgrade` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dreamhunter2333/cf-temp-mail-version-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dreamhunter2333/cf-temp-mail-version-upgrade/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dreamhunter2333 (https://skillmd.com/u/dreamhunter2333)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dreamhunter2333/cf-temp-mail-version-upgrade

---


# Version Upgrade

Upgrade the version number of the cloudflare_temp_email project.

## Files to modify

1. `frontend/package.json` — `version` field
2. `worker/package.json` — `version` field
3. `worker/src/constants.ts` — `VERSION` constant (format: `VERSION: 'v' + '1.4.0'`)
4. `pages/package.json` — `version` field
5. `vitepress-docs/package.json` — `version` field
6. `CHANGELOG.md` — add new version placeholder
7. `CHANGELOG_EN.md` — add new version placeholder (English)

## Upgrade workflow

1. Read `frontend/package.json` to get the current version.
2. Compute the new version based on the upgrade type:
   - major: 1.3.0 → 2.0.0
   - minor: 1.3.0 → 1.4.0
   - patch: 1.3.0 → 1.3.1
3. Update the `version` field in every `package.json` listed above.
4. Update the `VERSION` constant in `worker/src/constants.ts`.
5. Insert a new version placeholder at the top of `CHANGELOG.md`.
6. Insert a new version placeholder at the top of `CHANGELOG_EN.md`.
7. Rename the previous version heading in both changelogs from `## v{OLD_VERSION}(main)` to `## v{OLD_VERSION}` so only the new active development version keeps `(main)`.

## CHANGELOG format

In `CHANGELOG.md`, insert before the existing `## v{OLD_VERSION}(main)` line (i.e. right after the closing `</p>` of the language-switch link):

```markdown
## v{VERSION}(main)

### Features

### Bug Fixes

### Improvements

```

After inserting the new placeholder, update the old heading:

```diff
-## v{OLD_VERSION}(main)
+## v{OLD_VERSION}
```

`CHANGELOG_EN.md` uses the same format and must receive the same old-heading update.

## Commit message format

```
feat: upgrade version to v{VERSION}

- Update version number to {VERSION} in all package.json files
- Add v{VERSION} placeholder in CHANGELOG.md
- Move (main) marker from v{OLD_VERSION} to v{VERSION}
```