Release Overview
Deno follows a regular release cadence with multiple releases per month, including both major feature releases and patch releases for bug fixes.Release Channels
Stable Releases
Production-ready releases with thoroughly tested features. These are the recommended versions for general use.
Canary Releases
Cutting-edge builds from the main branch. Updated frequently with the latest changes but may contain bugs.
Versioning Scheme
Deno uses semantic versioning with the formatMAJOR.MINOR.PATCH:
- MAJOR version (2.x.x) - Breaking changes
- MINOR version (2.7.x) - New features, backward compatible
- PATCH version (2.7.1) - Bug fixes and minor improvements
Version History
Recent major releases:- Deno 2.7.x (Current) - Latest features and improvements
- Deno 2.6.x - TypeScript 5.9.2, V8 14.0.0, permissions in config
- Deno 2.5.x - Deno bundle API, HTML entrypoint support
- Deno 2.4.x - Windows on ARM, JSR support
Release Frequency
Typical Release Schedule
- Minor releases (2.x.0): Every 2-4 weeks with new features
- Patch releases (2.x.y): Weekly or as needed for critical fixes
- Canary builds: Daily from the main branch
Recent Release Cadence
Example from recent history:What Goes Into a Release
Feature Releases (Minor Versions)
Minor releases typically include:New Features
New Features
- New CLI commands (e.g.,
deno create,deno audit) - New APIs and functionality
- New flags and options
- Runtime capabilities
Enhancements
Enhancements
- Improvements to existing features
- Performance optimizations
- Better error messages
- Enhanced compatibility
Bug Fixes
Bug Fixes
- Critical bug fixes
- Node.js compatibility fixes
- Extension improvements
- Edge case handling
Dependency Updates
Dependency Updates
- V8 engine updates
- TypeScript version bumps
- Third-party library updates
Patch Releases
Patch releases focus on:- Critical bug fixes that affect stability or security
- Regression fixes from recent releases
- Minor compatibility improvements
- Documentation updates
Example: Deno 2.7.0 Release
The 2.7.0 release included: Major Features:deno createcommand for scaffolding projectsdeno auditwith--ignoreflag for filtering advisories--check-jsflag for type-checking JavaScript- Brotli support in compression streams
- Stabilized Temporal API
- npm overrides support
- Better install caching
- Enhanced LSP features
- Over 50 bug fixes across extensions
- Node.js compatibility improvements
- Performance optimizations
Downloading Releases
Official Release Page
Binary releases can be downloaded from:- Pre-built binaries for all supported platforms
- Source code archives
- Release notes with changelogs
- Installation instructions
Installation Methods
- Shell (Mac/Linux)
- PowerShell (Windows)
- Homebrew (Mac)
- Chocolatey (Windows)
Installing Specific Versions
To install a specific version:Upgrading Deno
Use the built-in upgrade command:Release Notes Format
Each release includes detailed notes inReleases.md with the following structure:
Version Header
Change Categories
Changes are categorized by type:- feat - New features
- fix - Bug fixes
- perf - Performance improvements
- chore - Maintenance and internal changes
Change Format
Each change follows this format:(cli)- CLI-related changes(ext/node)- Node.js compatibility layer(ext/fetch)- Fetch API implementation(lsp)- Language server protocol(compile)- Deno compile command
Release Communication
Blog Posts
Major releases (minor versions) typically include:- Detailed blog post at
http://deno.com/blog/ - Feature highlights and examples
- Migration guides for breaking changes
- Performance benchmarks
http://deno.com/blog/v2.7
Announcements
Releases are announced on:Twitter/X
@deno_land announces all releases
Bluesky
deno.land for social updates
Discord
Discord server announcements channel
YouTube
@deno_land for video updates
Platform Support
Each release includes binaries for:Supported Platforms
- macOS - x64 (Intel), ARM64 (Apple Silicon)
- Linux - x64, ARM64
- Windows - x64, ARM64 (as of 2.6.8+)
Binary Naming Convention
Release Quality Assurance
Testing Before Release
Before a release is published, the code goes through:Breaking Changes
Breaking changes are clearly marked in release notes:- API changes
- Removed deprecated features
- Default behavior changes
- Migration guides in documentation
Contributing to Releases
How Your Changes Get Released
Release Timeline
From merge to release:- Merge to main - Your PR is merged
- Canary builds - Available immediately in daily canary
- Next stable - Included in next minor/patch release (typically within 1-2 weeks)
- Release notes - Listed in
Releases.md