This release should be relatively simple for most consumers of this library since the main breaking change is dropping support for node-sass and requiring sass since node sass has been deprecated as well as removing deprecated variables, hooks, and components. Most users should be able to run the following commands to upgrade to v3.0.0:

npm update react-md
npm uninstall node-sass
npm install sass

Or with yarn

yarn add react-md
yarn remove node-sass
yarn add sass

In addition, there is now partial support for the new Sass module system with the react-md package which also simplifies the import usage and has a slight build performance improvement for large projects. To start using the new module system, update all the @import statements as shown below:

-@import '~@react-md/theme/dist/mixins';
-@import '~@react-md/utils/dist/mixins';
-// other react-md imports
+@use 'react-md' as *;

 // No other changes required!

If you override variables within react-md:

-@import '~@react-md/theme/dist/color-palette';
-$rmd-theme-light: false;
-$rmd-theme-primary: $rmd-purple-500;
-$rmd-theme-secondary: $rmd-pink-a-200;
-
-@import '~react-md/dist/styles';
+@use '@react-md/theme/dist/color-palette' as color;
+@use 'react-md' as * with (
+  $rmd-theme-light: false,
+  $rmd-theme-primary: color.$rmd-theme-purple-500,
+  $rmd-theme-secondary: color.$rmd-theme-pink-a-200,
+);
+
+@include react-md-utils;

Check out the updated customizing your theme documentation, #1214, or 958f34f for more in-depth examples.

BREAKING CHANGES

@react-md/theme: $rmd-theme-dark-elevation now defaults to true instead of false
sass: node-sass is no longer supported and users must switch to sass
@react-md/utils: Removed InteractionModeListener since it was an alias for UserInteractionModeListener
@react-md/utils: Removed ResizeObserver component and useResizeObserverV1 implementation
@react-md/tooltip: Removed TooltipHoverModeConfig component
@react-md/card: Removed deprecated $rmd-card-dark-elevation-bordered-background-color variable
@react-md/tooltip: Removed deprecated props from Tooltipped component
@react-md/form: The second argument for useIndeterminateChecked is now an object of options

Bug Fixes

sass: drop node-sass in favor of sass since it's deprecated (126fb5a)
sass: use math.div instead of division since it's deprecated (d8c3f12)

Features

@react-md/theme: $rmd-theme-dark-elevation defaults to true (b371337)
react-md: Simplify sass usage with: @use 'react-md'; (787bfb5)

Documentation

react-md.dev: removed documentation around pre-compiling styles (29b5d74)
react-md.dev: Update Sass Documentation for @use (68e8c6b)
react-md.dev: Updated sandboxes for new Sass module system (095ae97)

Other Internal Changes

Added additional tests to bump test coverage (4d0371c)
@react-md/card: removed deprecated $rmd-card-dark-elevation-bordered-background-color variable (01c9350)
@react-md/dev-utils: Added simple sass-migrator command (a8e8df3)
@react-md/dev-utils: autoConfirm flag passed to initBlog (dec09b8)
@react-md/dev-utils: Combine all scss files into react-md/dist/_everything.scss (c7177e6)
@react-md/dev-utils: Update release script to hopefully work with prereleases (e0ef881)
@react-md/dev-utils: updated sassdoc and variables to use everything.scss (a0f0699)
@react-md/dev-utils: updated variables command to work with sass (5376be1)
@react-md/form: removed deprecated implementation in useIndeterminateChecked (6b7871f)
@react-md/tooltip: removed deprecated props from Tooltipped component (6dca9b1)
@react-md/tooltip: removed TooltipHoverModeConfig component (664ec30)
@react-md/utils: remove ResizeObserver component and useResizeObserverV1 implementation (6a6b109)
@react-md/utils: removed InteractionModeListener alias (216c8ef)
examples: updated examples to latest dependencies (f2eb07a)
react-md.dev: Each package includes a link to typedoc API in navigation tree (c388ba6)
react-md.dev: ran migrator for deprecated division (98d2c58)
react-md.dev: removed tilde from imports (6081e14)
react-md.dev: update all scss files for @use imports (958f34f)
react-md.dev: update all styles to use react-md/dist/everything (2da5033)
react-md.dev: Update links for previous versions (2d0a0e6)
react-md.dev: updated docs for new rmd-theme-dark-elevation defaults (b2269ff)
react-md.dev: updated examples to work with sass instead of node-sass (d8ddf51)
react-md.dev: updated sandboxes to use root react-md (c0f25f7)

3.0.0-alpha.0

Diff

mlaursen

published 3.0.0-alpha.0 • 3 years ago

2.9.1

Diff

mlaursen

published 2.9.1 • 3 years ago

Changelog

Source

2.9.1 (2021-07-27)

Bug Fixes

@react-md/layout: Do not unmount children when swapping to non-fixed appbar mini layouts (64103c8), closes #1207
@react-md/utils: useMediaQuery uses addEventListener/removeEventListener (b889a9e)

Other Internal Changes

fixed sass-lint error (58f614b)
install: slighly reduce install size by excluding tests in publish (9d01a44)
react-md.dev: fix links to form demos in blog (b1626b5)

2.9.0

Diff

mlaursen

published 2.9.0 • 3 years ago

Changelog

Source

2.9.0 (2021-07-18)

This release is focused around the FileInput component in the @react-md/form package and implementing a useFileUpload hook to handle uploading/previewing files in the browser. However, there is a notable change in this release for the form documentation since the demos have been split into the following pages:

Bug Fixes

@react-md/form: FileInput correctly center the icon when children aren't provided (3a6ab33)
@react-md/layout: useLayoutNavigation possible perf fix (3d65e4e)

Features

@react-md/form: FileInput automatically swaps button type to text if children exist (e5585e1)
@react-md/form: FormMessageCounter component added to public API (1508812)
@react-md/form: Added a useFileUpload hook to upload files to the browser (efb3f2f), closes #1159
@react-md/utils: added useDropzone hook (bc07a1f)

Other Internal Changes

Added CodeQL Workflow for code analysis (9b4a279)
@react-md/form: Added tests for useFileUpload (49ce4d9)
@react-md/layout: Added additional test coverage (7c123ef)
react-md.dev: Added an endpoint for uploading files that acts like a /dev/null (9663ae8)
react-md.dev: Added examples for useFileUpload (8f9002e)
react-md.dev: fix eslint error after updating prettier (75a9b0f)
react-md.dev: Fixed rightAddon for Customizing Select Options Demo (367cc0d)
react-md.dev: Split form demos into separate pages (8594930)
react-md.dev: Use temporary layout on desktop in dev mode to get more screen space (53b20c4)

2.8.5

Diff

mlaursen

published 2.8.5 • 3 years ago

Changelog

Source

2.8.5 (2021-07-03)

Bug Fixes

@react-md/form: MenuItemCheckbox added missing indeterminate state (aa2c552), closes #1186
@react-md/form: useIndeterminateChecked correctly uses readonly prefix (7f69a71)
@react-md/form: useIndeterminateChecked supports MenuItemCheckbox with new option (9ab67bf)
@react-md/form: MenuItemCheckbox, MenuItemRadio, and MenuItemSwitch styles on light themes (fc4dcd9)

Documentation

@react-md/form: Updated documentation for useIndeterminateChecked (8646c28)

Other Internal Changes

@react-md/dev-utils: Updated release script to allow custom CHANGELOG updates (dde151b)
@react-md/form: Added tests for useIndeterminateChecked (cc2a422)
react-md.dev: Updated MenuWithFormControls example for indeterminate checkboxes (2d20848)

2.8.4

Diff

mlaursen

published 2.8.4 • 3 years ago

Changelog

Source

2.8.4 (2021-06-10)

Bug Fixes

@react-md/form: Pass checked prop to component (bffae6f)
@react-md/form: Fixed controlled behavior for Switch components (8c65df6), closes #1175
@react-md/utils: omit uses readonly prefix for key list (d3e1ee8)
@react-md/utils: Slightly better tooltip behavior after clicking somewhere on the page (4d3fc16)

Documentation

react-md.dev: Updated general documentation (9bc8a0d)
react-md.dev: Update next and build deps to fix font loading issues (e528617)

Other Internal Changes

updated doc tsconfig for better autocompletion (7fb8b94)
Renamed contrast check function (97c1ad7)
add website alias to changelog config (d98bf51)
ran prettier after upgrading to v2.3.0 (3ce236a)

2.8.3

Diff

mlaursen

published 2.8.3 • 3 years ago

Changelog

Source

2.8.3 (2021-05-18)

Bug Fixes

@react-md/layout: Added fixedAppBar flag into the useLayoutConfig (14e6587)
@react-md/layout: Mini Layouts Align Icons with Hamburger Menu in Dense Mode (abbe9a9)
@react-md/layout: non-fixed AppBar mini layouts (84313fc), closes #1101
@react-md/layout: Offset for temporary mini layouts (86e75bf)
@react-md/states: Added missing classnames dependency (a7a2012), closes #1155

Documentation

@react-md/layout: Added demo for non-fixed AppBar layouts (d217ac1)
@react-md/typography: Added examples for overriding typography styles (57033bd), closes #1147
react-md.dev: Added simple API documentation with typedoc (84739af)
react-md.dev: don't include version for latest react-md (a69359b)
react-md.dev: Light Theme Code Preview Colors (c9cc6a7)
react-md.dev: redirect to v1 website (5d9ee71)
react-md.dev: small updates after switching to free hosting (96e2dcd)
react-md.dev: update v1 links to new repo and static hosting (92801bb)
react-md.dev: updated tsdoc to work with typedoc (cf54c35)
react-md.dev: Fix typedoc source links when deployed through vercel (a4eed1b)
react-md.dev: Fixed useLayoutNavigation hook example in creating a new app (1cde856)

Other Internal Changes

no longer build,lint,test node 10 since I upgraded some dependencies (1d3f889)
fix anchor link to useFixedPositioning example docs (eb5a9fc)
fixed typo (ef3f9e4)
removed v1 info from README (b0e8ccb)
@react-md/dev-utils: Removed old typedoc WIP (a7d7429)
deployment: Fixed deploy script (4072b93)
workflow: dropped node 10 since I upgraded some dependencies (fd81950)

…