# Release Notes - v{X.Y.Z}

**Release Date**: {YYYY-MM-DD}
**Type**: Major | Minor | Patch

---

## 🎉 Highlights

{2-3 sentence summary of this release}

## ✨ New Features

### {Feature Name} (PRD-XXX)

{Description of the feature and its value}

**How to use**:
```{language}
{Code example}
```

**Learn more**: [Documentation link]

---

### {Another Feature} (PRD-YYY)

{Description}

---

## 🐛 Bug Fixes

- **{Bug description}** (#{issue}) - Fixed {what was broken}
- **{Another bug}** (#{issue}) - Resolved {issue description}

## 🔄 Changes

### Changed
- **{Changed feature}** - {What changed and why}
- **{API change}** - {Breaking change description}

### Deprecated
- **{Deprecated feature}** - Deprecated in favor of {replacement}. Will be removed in v{X.Y.Z}.

### Removed
- **{Removed feature}** - {Why it was removed}

## 🔒 Security

- **{Security fix}** - Fixed {vulnerability type} (CVE-YYYY-XXXXX)
- Severity: {Critical/High/Medium}

## 📈 Performance

- **{Performance improvement}** - {XX}% faster {operation}
- **Bundle size**: {XX KB} → {YY KB} ({-Z KB / -N%})

## 🔧 Technical Improvements

- Updated {dependency} from v{X} to v{Y}
- Refactored {component} for better {quality attribute}
- Improved {test coverage} from {XX}% to {YY}%

## 📚 Documentation

- Added {documentation type}
- Updated {existing doc} with {improvement}

## ⚙️ Breaking Changes

{If any, describe here with migration guide}

### Migration Guide

**Before (v{X.Y-1}.Z)**:
```{language}
{Old code}
```

**After (v{X.Y}.Z)**:
```{language}
{New code}
```

**Migration steps**:
1. {Step 1}
2. {Step 2}

## 🙏 Contributors

Thanks to all contributors for this release!

- @{contributor1} - {Feature/Fix}
- @{contributor2} - {Feature/Fix}

## 📦 Installation

### npm
```bash
npm install {package}@{X.Y.Z}
```

### yarn
```bash
yarn add {package}@{X.Y.Z}
```

## 🔗 Resources

- [Full Changelog](https://github.com/{org}/{repo}/compare/v{X.Y-1}.Z...v{X.Y}.Z)
- [Documentation](https://docs.example.com)
- [Migration Guide](https://docs.example.com/migration/v{X.Y})

## 🐛 Known Issues

{If any known issues, list them here}

- {Issue description} - Workaround: {workaround}

## 📅 What's Next

{Teaser for next release}

- {Upcoming feature 1}
- {Upcoming feature 2}

See the [roadmap](https://github.com/{org}/{repo}/projects/1) for details.

---

**Questions?** [Open an issue](https://github.com/{org}/{repo}/issues/new) or join our [discussions](https://github.com/{org}/{repo}/discussions).