Biome release notes, breaking changes, and upgrade notes.
One toolchain for your web project: format, lint, and more StackPulse turns upstream changelogs into scannable summaries with risky changes, deprecations, migration notes, and source links.
Biome 2.6.8 adds numerous nursery lint rules for JavaScript, TypeScript, Vue, YAML, and tests. The rules flag potentially confusing or erroneous patterns, including deprecated APIs and syntax, unsafe or misleading expressions, and invalid framework or data-format usage.
affected
Biome users can enable or encounter these nursery lint rules when checking JavaScript, TypeScript, Vue, YAML, and test code.
action
Review the new nursery rules and enable those relevant to your project.
release_signals
+Added JavaScript and TypeScript nursery rules for deprecated Buffer constructors, confusing array splice calls, dynamic require/import paths, late event.currentTarget access, misused spreads, and triple-slash references.
+Added Vue nursery rules for async computed properties, defineModel defaults, deprecated filters and v-is directives, and exports in script setup blocks.
+Added YAML nursery rules for empty map keys, empty map values, and empty sequence entries.
+Added the test-domain useCalledWith rule to flag assertions that do not verify call arguments.
migration_steps2 steps
01For deprecated Buffer() or new Buffer() usage, use Buffer.from(), Buffer.alloc(), or Buffer.allocUnsafe() instead.
02For Vue's deprecated v-is directive, use the is attribute with a vue: prefix instead.
Biome 2.6.7 adds numerous nursery lint rules for JavaScript, TypeScript, CSS, Vue, Svelte, and project imports. The rules flag potentially erroneous patterns, redundant code, and inconsistent naming; the release notes describe no breaking changes or security fixes.
affected
Biome users who enable nursery lint rules may receive new diagnostics for patterns in JavaScript, TypeScript, CSS, Vue, Svelte, and project imports.
action
Review the new nursery rules and enable those relevant to your project; configure noExcessiveSelectorComplexity options if you want it to report selectors.
release_signals
+Added nursery lint rules for async Promise.finally callbacks, duplicate and redundant TypeScript type constituents, and potentially stale async updates.
+Added rules for invalid GET/HEAD fetch bodies, single-argument new Array calls, useless spread syntax and spread fallbacks, and redundant TypeScript parameter-property assignments.
@biomejs/biome@2.6.6highfeatureNov 6, 2026
Biome CLI v2.6.6
Biome 2.6.6 adds numerous nursery lint rules for detecting likely runtime errors, ineffective or redundant code, and framework-specific issues. It also fixes incorrect rule configuration for groups with more than 256 rules and improves JavaScript and CSS linting performance.
affected
Biome users gain additional opt-in nursery diagnostics and faster linting; projects configuring rule groups with more than 256 rules also benefit from a configuration bug fix.
release_signals
+Added nursery rules including noArrayMethodsOnArguments, noConstantComparisons, noErasingOperation, noNegatedArrayPredicate, noNumberArgumentOutOfRange, noSharedBranchCode, noSubtractionComparison, noSvelteIgnoredUnsubscribe, and noUninvokedArrayCallback.
+Added the Next.js nursery rule useNextScriptForGoogleAnalytics, recommending @next/third-parties/google components for Google Analytics and Google Tag Manager scripts.
@biomejs/biome@2.6.5highfeatureNov 4, 2026
Biome CLI v2.6.5
Biome 2.6.5 adds numerous nursery lint rules for JavaScript, Sass, CSS, Playwright, and Svelte to identify likely logic errors, ineffective selectors, and performance issues. The provided release notes end partway through the Svelte rule description, so the full set of changes may not be represented.
affected
Biome users, particularly those enabling nursery lint rules, can detect additional potential mistakes and inefficiencies in JavaScript, Sass, CSS, Playwright, and Svelte code.
action
Review the new nursery rules and enable those relevant to your project.
release_signals
+Added nursery rule `noArrayForEach` to report eligible `forEach()` calls that can use `for...of`.
+Added nursery rules for unsafe or misleading JavaScript patterns, including `noAwaitInPromiseMethods`, `noChainedComparison`, `noDynamicDelete`, `noLateEventControl`, `noMapSpread`, `noMismatchedMapKey`, `noMissingThrow`, `noObjectLiteralComparison`, and `noSinglePromiseInPromiseMethods`.
Biome 2.6.4 adds a set of nursery lint rules for JavaScript and Vue, covering potentially confusing or erroneous patterns such as `null` usage, array method return values, recursion, and Vue API misuse. The provided release notes end mid-entry, so additional changes may not be represented here.
affected
Biome users enabling nursery lint rules, particularly projects using Vue, can detect additional JavaScript and Vue pitfalls.
action
Review the new nursery rules and enable those relevant to your project; address findings where appropriate.
release_signals
!Added lint rules that flag deprecated Vue APIs and constructs, including `$set`/`$delete`, `Vue.set`/`Vue.delete`, the `RouterLink` `tag` prop, and the `<template scope>` attribute.
@biomejs/biome@2.6.3highfeatureOct 24, 2026
Biome CLI v2.6.3
Biome 2.6.3 adds 15 nursery lint rules covering JavaScript, TypeScript, HTML, CSS, Playwright, Svelte, TanStack Query, and Vue. The rules flag problematic patterns such as incorrect sort comparators, unsafe `any` returns, obsolete attributes, and fragile positional element selection.
affected
Biome users enabling nursery lint rules can detect the newly covered patterns across JavaScript, TypeScript, HTML, CSS, and supported framework code.
action
Review the new nursery rules and enable those that fit your project’s linting policy.
release_signals
+Added `noArraySortForMinMax` to recommend `Math.min()` or `Math.max()` instead of sorting an array only to read its smallest or largest value.
+Added `noBooleanSortComparator` to catch sort comparators that return booleans rather than numbers.
@biomejs/biome@2.6.2highfeatureOct 21, 2026
Biome CLI v2.6.2
Biome CLI v2.6.2 introduces several new features including Git VCS integration, Stylelint configuration migration, GraphQL definition sorting, YAML formatting support, and type inference profiling. The release also includes various improvements and bug fixes.
affected
Users of Biome CLI, especially those working with Git repositories, Stylelint configurations, GraphQL, YAML, or Grit plugins, will benefit from new features and improvements.
action
Update to the latest version to take advantage of new features and improvements.
release_signals
+Added `--git` flag to `biome init` for Git VCS integration
+Added `biome migrate stylelint` command to import Stylelint configurations
+Added `useGraphqlSortedDefinitions` assist action for sorting GraphQL definitions
@biomejs/js-api@6.1.0mediumfeatureOct 21, 2026
JavaScript APIs v6.1.0
This release introduces new helper functions for byte offset conversion and GritQL search capabilities in the JavaScript API. It also adds support for additional file types and improves CLI tooling.
affected
Developers using the Biome JavaScript API for code analysis and manipulation are affected by the new features and improvements.
action
Update to the latest version to take advantage of new features and improvements.
release_signals
+Added `spanInBytesToSpanInCodeUnits` helper function for converting byte offsets to code units
+Added GritQL search functionality with `parsePattern()`, `searchContent()`, and `dropPattern()` methods
This release introduces several new lint rules for React, Svelte, and CSS, along with performance improvements and bug fixes. Notable additions include rules for React default props, Svelte prop syntax, and CSS logical properties.
affected
React, Svelte, Astro, and CSS developers using Biome's linter may need to update their code to comply with new rules.
action
Review new lint rules and update code to comply with deprecations where applicable.
release_signals
!Legacy Svelte `export let` syntax is deprecated in favor of `$props()` rune
!Imports from `$app/stores` are deprecated in favor of `$app/state`
+Added `noReactObjectTypeAsDefaultProp` rule for React default props
This release introduces several new linting rules and fixes various bugs related to formatting, parsing, and performance. Notable changes include the addition of rules to prevent returns in `Promise.prototype.finally()` callbacks and to enforce valid test titles.
affected
Developers using Biome for linting and formatting JavaScript, TypeScript, and Svelte code will benefit from new rules and bug fixes.
action
Update to the latest version to take advantage of new linting rules and fixes.
release_signals
+Added the nursery rule `noReturnInFinally` to disallow return statements in `Promise.prototype.finally()` callbacks.
+Added the nursery rule `noSvelteAtDebugTags` to disallow Svelte's `{@debug}` tag.
@biomejs/biome@2.5.13mediumfeatureSep 10, 2026
Biome CLI v2.5.13
This release introduces new nursery rules for CSS, DOM traversal, and bitwise operations, along with several fixes for type-aware linting and HTML formatting.
affected
Users of Biome's linter and formatter, especially those working with CSS, DOM traversal, and TypeScript, may be affected by new rules and fixes.
action
Update to the latest version to benefit from new linting rules and fixes.
release_signals
+Added the nursery rule `useLayeredStyles` to enforce style rules within cascade layers.
+Added the nursery rule `useBetterDomTraversing` to prefer specific DOM traversal methods.
+Added the nursery rule `noXorAsExponentiation` to report incorrect use of XOR as exponentiation.
This release focuses on fixing parsing and formatting issues in Astro expressions, improving support for JSX and TypeScript syntax, and adding new linting rules. Several bugs related to Astro attribute expressions, HTML comments, and template literals were resolved.
affected
Developers using Biome with Astro, JSX, or TypeScript syntax are primarily affected by these changes.
action
Update to version 2.5.12 to benefit from bug fixes and new linting rules.
release_signals
+Added support for template literal attribute values inside Astro expressions.
+Added the nursery rule `useFlatMathMinMax` to flatten unnecessary nested calls to `Math.min()` and `Math.max()`.
+Added the nursery rule `noThisOutsideOfClass` to report `this` outside class members and TypeScript functions with an explicit `this` parameter.
This patch release primarily fixes bugs in Astro, Vue, and TypeScript support. It adds two new nursery rules focused on security (XSS prevention) and CSS validation.
affected
Users of Biome with Astro, Vue, or TypeScript projects may be affected by bug fixes and new rules.
action
Update to v2.5.11 to benefit from bug fixes and new rules, especially if using Astro or Vue.
release_signals
!Added `noAstroSetHtmlDirective` rule to prevent XSS vulnerabilities from untrusted content in Astro's `set:html` directive
+Added nursery rule `noAstroSetHtmlDirective` to disallow Astro's `set:html` directive due to XSS risks
+Added nursery rule `noUndeclaredCustomProperties` to report undefined CSS custom properties
@biomejs/biome@2.5.10mediumfeatureAug 21, 2026
Biome CLI v2.5.10
This release primarily focuses on fixing various parsing and formatting issues in Astro files, including handling comments, expressions, and attribute values more accurately. It also introduces support for Astro's fragment shorthand and template literal attribute values.
affected
Users of Biome's Astro parser and formatter are affected by fixes and improvements to Astro syntax handling.
action
Update to version 2.5.10 to benefit from improved Astro syntax handling and bug fixes.
release_signals
+Added support for Astro's fragment shorthand.
+Added support for template literal attribute values in Astro.
+Fixed Astro rejecting attribute names that start with a colon, such as `:href`.
This release focuses on improving CSS and HTML parsing, formatting, and linting, along with fixes for Tailwind and Astro-related rules. It also enhances the `biome rage` command with additional environment variable metadata.
affected
Developers using Biome for CSS, HTML, Tailwind, or Astro projects may benefit from the new rules and fixes.
action
Update to version 2.5.9 to take advantage of the new features and fixes.
release_signals
+Added nursery rule `useNamedLayer` to disallow anonymous cascade layers in CSS.
+Added nursery rule `useTailwindShorthandClasses` to suggest shorter Tailwind utility classes.
+Added nursery rule `useAstroClientOnlyDirectiveValue` to report Astro `client:only` directives without an initializer.
@biomejs/biome@2.5.8mediumfeatureAug 11, 2026
Biome CLI v2.5.8
This release introduces several new nursery rules for React, Svelte, and CSS, along with performance improvements and bug fixes. Key changes include new linting capabilities for React Compiler, Svelte const declarations, and CSS property syntax validation.
affected
Developers using Biome for React, Svelte, or CSS linting may need to update their configurations or code to accommodate new rules and fixes.
action
Review new nursery rules and update Svelte code to use `$derived()` instead of legacy `{@const}` tags where applicable.
release_signals
+Added nursery rule `useReactCompiler` for React Compiler lint mode diagnostics
+Added nursery rule `noSvelteLegacyConst` to disallow legacy Svelte `{@const}` tags
+Added nursery rule `noInvalidPropertyInitValue` for CSS `@property` syntax validation
@biomejs/biome@2.5.7mediumfeatureAug 4, 2026
Biome CLI v2.5.7
This release introduces new linting rules for nullish coalescing, native object extension, and Tailwind CSS arbitrary values. It also includes several fixes for nested configurations, Vue pseudo-classes, and HTML/CSS formatting.
affected
Users of Biome CLI with nested configurations or specific linting rules (noUnnecessaryConditions, noUnknownPseudoClass, noUnusedVariables) may be affected by fixes and improvements.
action
Update to version 2.5.7 to benefit from new rules and fixes, especially if using nested configurations or affected linting rules.
release_signals
+Added `ignoreIfStatements` option to `useNullishCoalescing` rule to ignore specific `if` statements
+Added new nursery rule `noExtendNative` to report extending built-in object prototypes
+Added new nursery rule `noTailwindArbitraryValue` to report Tailwind CSS arbitrary values
@biomejs/biome@2.5.6mediumfeatureJul 28, 2026
Biome CLI v2.5.6
This release focuses on performance improvements, bug fixes, and enhanced linting accuracy. Key changes include fixing a performance regression in `noMisusedPromises`, improving CSS formatting, and resolving issues with Svelte file handling.
affected
Users of Biome CLI, especially those working with Svelte files or using type-aware linting rules, will benefit from the fixes and improvements.
action
Update to the latest version to take advantage of performance improvements and bug fixes.
release_signals
+Added support for Svelte declaration tags using `let` and `const`.
+Improved the performance of Biome formatter by up to ~7%.
+Added the nursery rule `noJsRestrictedProperties`, which ports ESLint's `no-restricted-properties` rule.
This release focuses on bug fixes and improvements across various rules and formatters, particularly enhancing the handling of bigint literals, CSS formatting, and type inference.
affected
Users relying on specific rules like `useExhaustiveSwitchCases`, `noBaseToString`, or CSS formatting will benefit from these fixes.
action
Update to version 2.5.5 to benefit from the latest fixes and improvements.
release_signals
+Fixed `useExhaustiveSwitchCases` for unions of bigint literals
+Improved CSS formatter casing for syntax-owned names
+Fixed CSS formatting for comments between declaration values and `!important`
+Improved generic tuple inference for `useIncludes`
@biomejs/biome@2.5.4mediumfeatureJul 15, 2026
Biome CLI v2.5.4
This release focuses on performance improvements, bug fixes, and enhancements to the HTML parser and linting rules. Notable changes include improved handling of comments in on-type formatting and fixes for Svelte directives.
affected
Users of Biome CLI, especially those working with HTML, Svelte, and YAML files, will benefit from the improvements and fixes.
action
Update to version 2.5.4 to take advantage of the latest fixes and improvements.
release_signals
+Improved performance of the HTML parser in synthetic benchmarks.
+Basic block properties formatting for YAML files.
+Sorting of important-suffix classes in `useSortedClasses`.
+Inference engine via Salsa for better module inference.
+Added CSS selector complexity checks; the rule remains inactive until an option is configured.
+Added framework and project rules for async Svelte stores, Vue expose calls after await, and unresolved default imports.
+Added a rule requiring consistent prefixes for boolean names.
Added nursery rule `noConsoleSpaces` to flag redundant spaces adjacent to arguments in console method calls.
+Added nursery rules `noMagicArrayFlatDepth`, `noNull`, `noReturnArrayPush`, `noUnreadableIife`, and `noUselessRecursion` for common JavaScript pitfalls.
+Added Vue nursery rules for computed properties used in `data`, deprecated Vue APIs and attributes, multiple slot arguments, prop mutation, side effects in computed properties, and unused refs.
migration_steps3 steps
01For Vue templates using the deprecated `scope` attribute, use `v-slot` to receive slot props instead.
02For code mutating Vue props, emit an event or copy the value instead.
03Avoid deprecated Vue 3-removed set/delete APIs and unsupported Vue Router 4 `RouterLink` `tag` props; see the corresponding lint rules.