> For the complete documentation index, see [llms.txt](https://codedthemes.gitbook.io/berry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codedthemes.gitbook.io/berry/support/changelog.md).

# Changelog

## v5.1.1 - (12-12-2025)

* Fixed map rendering issue.
* Resolved dark mode compatibility problem in the Quill Editor.

## v5.1.0 - (29-11-2025)

* Next.js v16
* React v19.2
* Packages upgrade
  * Migration from Mapbox GL to MapLibre GL

## v5.0.0 - (11-10-2025)

* **Material-UI (MUI)**
  * Enhanced CSS variables implementation.
  * Fixed overrides for DatePicker and PickerTextField components.
  * Removed unnecessary Grid direction column usage.
  * Improved component structure using slotProps and slots.
  * Updated Stack props, replaced spacing with gap using sx.
  * Separated component override definitions into a dedicated file.
* **ApexCharts**
  * Fixed the chart flickering issue during mode changes.
  * Optimised chart data and removed unused code & hooks.
  * Fixed legend and toolbar alignment issues.
* **General Improvements**
  * Replaced Perfect Scrollbar with SimpleBar for better performance.
  * Added loader for chat message history.
  * Introduced system auto mode with live customisation options.
  * Improved overall context performance.
  * Prefetch routes and Google Fonts for enhanced loading speed.
* **Bug Fixes**
  * Fixed RTL scroll position issue.
  * Resolved calendar event rendering issues when adding or editing events.
  * Fixed the total price calculation display in the e-commerce checkout.
  * Adjusted chat drawer height.
  * Fixed the Scrollable List (basic) component rendering issue.
* **Updates**
  * Updated all package dependencies.
  * Upgraded Yarn to version 4.10.3.

## v4.1.0 - (12-05-2025)

* **Upgraded to React 19**
* **Implemented new React 19 features:**
  * Used `useTransition` for managing concurrent UI updates
  * Integrated `useDeferredValue` to optimize the rendering of deferred content
  * Updated components to use the new `use()` API
  * Applied `<Context>` as a provider pattern
  * Passed `ref` as a prop for better interoperability with functional components
* **Upgraded Yarn to version 4.9.1**
* **MUI packages upgraded:**
  * `@mui/lab` → 7.0.0-beta.11
  * `@mui/icons-material`, `@mui/material`, `@mui/utils` → 7.0.2
  * `@mui/x-data-grid`, `@mui/x-data-grid-generator`, `@mui/x-data-grid-pro`, `@mui/x-date-pickers`, `@mui/x-tree-view` → 8.1.0
* **Library replacements for React 19 compatibility:**
  * Replaced `react-copy-to-clipboard` with `copy-to-clipboard`
  * Replaced `react18-image-lightbox` with the updated `yet-another-react-lightbox`
  * Replaced `react18-input-otp` with `react-otp-input`
  * Removed `react-draft-wysiwyg`
* **Other third-party packages updated to their latest compatible versions**
* **Implemented alternative libraries where necessary for full React 19 support**
* **General bug fixes and performance improvements**

## v4.0.2 - (25-03-2025)

* Fixed: Tabler icon loading [issue](https://github.com/tabler/tabler-icons/issues/1327)
* Updated: Set Yarn version to 4.7.0

## v4.0.1 - (04-03-2025)

* Bug Fixes
  * Multi-level menu that collapses for more than three levels.
  * Resolved multilanguage issues in the horizontal layout.
  * Fixed ApexChart axis colors.

## v4.0.0 - (01-02-2025)

* Added
  * Invoice Dashboard
  * CRM Application
  * Blog Application
  * `supabase`Auth switcher options
  * Tooltip on customization options and selection
  * New demos for date picker
  * Simple layout for SaaS pages
* Upgrade packages
  * MUI v6
  * Eslint v9
  * React-router v7
  * yarn v4
  * Auth0 package change
* Set up yarn `corepack`
* Menu: Decrease menu item padding and fix menu-level items
* Removed extended Chip, achieved through the component override
* Bug fixes
  * Alert icons
  * Scrollbar issue
  * Snack bar (notify) icons
  * Framework section (landing)
  * Setup type to enum (config)
  * Fixed landing page data
  * Scrollbar with RTL
  * Breadcrumbs alignment and padding
  * Radio and checkbox label alignments
  * Fixed imports and comments
* Documentation improvements
  * Route configuration
  * Mock server

## v3.9.1 - (24-06-2024)

* No updates in code
* Documentation Updates
  * **Enhanced Documentation**: Made overall improvements for better clarity.
  * **Reorganized Sections**: Grouped related content logically.
  * **Mock Backend Guide**: Added instructions for using the mock backend. [Check here](/berry/getting-started/mock-backend.md).
  * **Licensing Guide**: Provided details on licensing. [Check here.](/berry/getting-started/licensing.md)
  * **Streamlined Authentication Docs**: Split into clearer sections.
  * **Improved Routing Documentation**: Enhanced routing instructions. [Check here.](/berry/routing.md)
    * **Set Login as Default Page**: The login page now loads first. [Check here.](/berry/routing/login-as-first-page.md)
    * **Skipping Login**: Added methods to skip login, temporarily or permanently. [Check here.](broken://pages/5n50sYLQKBoY0RQQ2850)
    * **Menu Loading from Backend**: Explained backend menu loading. [Check here.](/berry/routing/render-menu-from-the-backend.md)
  * **Improved Theming Documentation**: Clarified theme usage and updates.&#x20;
    * **Theme Central Updates**: Explained central theme updates. [Check here.](/berry/theme.md)
    * **Preset Management**: Detailed preset usage and updates. [Check here.](/berry/theme/color-presets.md)
    * **Style Customization**: Instructions on modifying [color](/berry/theme/theme-config/color.md), [typography](/berry/theme/theme-config/typography.md), [shadows](/berry/theme/theme-config/shadows.md), and [component overrides](/berry/theme/theme-config/overrides.md).
    * **Theme Layouts**: Explained theme layout structures. [Check here.](/berry/theme/layouts.md)
    * **Logo Replacement Guide**: Added instructions for updating the logo. [Check here.](/berry/theme/logo.md)

## v3.9.1 - (15-03-2024)

* Added missing auth files for NextJS

## v3.9.0 - (24-02-2024)

* Add Invoice App
* Add CRM Apps
* Add 500 error pages
* Add Dropzone plugins (used with kanban)
* Set menu with SWR instead of redux store
* Use matchPath for the active menu
* Set custom breadcrumbs
* Pricing page - set actual price note
* Fixed config enum
* Bug fixes
  * Default scroll color scheme (dark mode)
  * Horizontal menu simple page active&#x20;
  * Collapsed menu active issue
* Code optimization
  * Removed // eslint-disabled-next-line&#x20;
  * Fixed useTheme and styled uses
  * Fixed mui/icons import

## v3.8.0 - (13-11-2023)

* Added MUI Grid data table variants
* Migrate to Vite
* Package upgrades&#x20;
* Set demo for react router error boundary and loader
* &#x20;Bug Fixes
  * Fixed Breadcrumbs&#x20;
  * Fixed megamenu quick links&#x20;
  * Fixed Organization chart RTL
* Support Node 20 now

## v3.7.0 - (23-10-2023)

* Next 13 App directory
* Package updates
* Full screen toggle
* Maps
* NPM Font
* Stop menu collapse on large media for Apps
* Remove react-app-rewired

## v3.6.0 - (23-07-2023)

* Set loader for all application pages
* Set notistack notification variants
* Set a parent menu item on horizontal
* Theme customizer re-design
* Set forgot/reset password flow for Firebase and aws cognito
* Bug fixes
  * fixed megamenu application links
  * fixed header profile chip color dark mode
  * fixed palette color - color grey.600 and grey.900 conflict
  * fixed content resize on drawer toggler

## v3.5.0 - (12-05-2023)

* Replaced react-beautiful-dnd with @hello-pangea/dnd to avoid --legacy-peer-deps while npm install

## v3.4.0 - (10-04-2023)

* Removed Mock API and use [Fake API via server](https://mock-data-api-nextjs.vercel.app/)
* Update to Next JS 13
* WCAG Updates
* Set Default Auth as JWT
* .env File updates
* Minimal [Remix React](https://remix.run/) Version (Limited support)
* Added password reset for Cognito auth
* Bug Fixes
  * Landing Section fix for mobile view
  * Iphone issue - The user needs to click twice
  * Chat app - emoji issue in mobile

## v3.3.0 - (19-01-2023)

* New Landing
* CSV Export
* Render Dashboard menu using API
* Added autocomplete form with validation
* Packages updates
  * Removed react-images
  * Removed MUI-Style
  * Updated packages to the latest
* Bug Fixes

## v3.2.0 - (10-10-2022)

* React 18 upgrade
* Horizontal and Compact menu layout options
* Create a constant file for commonly used strings
* Other minor package upgrades
* SVG file updates due to React 18
* Removed *.default* from the end wherever the image has been used
* Added config-override.js to support native node module in react 18
* Removed Skeleton version
* Some miscellaneous code improvements

### Migration to React 18 and other packages

1. Delete existing node\_modules from the project
   1. Update/add the following file from Berry 3.2.0
      1. Update your **package.json**
      2. Add **config-overrides.js**
      3. Update **src/index.js**
      4. Add `GENERATE_SOURCEMAP = false` to **.env** file
      5. Update **.eslintrc** file
      6. Replace svgs from **`src\assets\images\auth`**
2. Run npm install using **`npm i --legacy-peer-deps`**

{% hint style="warning" %}
For TS and Next JS, you need to make some more changes related to types. Please refer the latest package (v3.2.0) for the same.
{% endhint %}

You can follow this link for more: <https://reactjs.org/blog/2022/03/08/react-18-upgrade-guide.html>

## v3.1.2 - (30-05-2022)

* Bug Fixes (Common)
  * Fix Issue in Mozilla with '*rem*'. Converted '*rem*' to '*px*' wherever applicable
  * Calendar - Hide Week and Month view in Mobile Media
    * *src/views/application/calendar/Toolbar.tsx*
    * *src/views/application/calendar/index.tsx*
  * ECommerce
    * Fix the issue with the opening previous image when clicking on the detail
      * *src/menu-items/application.tsx*
      * *src/views/application/e-commerce/ProductDetails/ProductImages.tsx*
      * *src/views/application/e-commerce/ProductDetails/index.tsx*
    * Remove the 'Rating' keyword when searching with a string
      * *src/views/application/e-commerce/Products/ProductFilterView\.tsx*
  * Set Menu highlighted when browser back
    * *src/layout/MainLayout/Sidebar/MenuList/NavItem/index.tsx*
    * *src/store/slices/menu.ts*
    * *src/types/menu.ts*
  * Fix Menu collapse issue having sub-menus
    * *src/layout/MainLayout/Sidebar/MenuList/NavCollapse/index.tsx*
* Bug Fixes - Next JS (Specifically)
  * Fix flickering issue in next js. When a user came to the dashboard directly, it shows the dashboard initially and then navigates to the login. This is fixed
    * *src/utils/route-guard/AuthGuard.ts*
    * *src/utils/route-guard/GuestGuard.ts*
* Provided Seed version
* Package upgrades

## v3.1.0 - (22-02-2022)

* Organization Chart
* Redux toolkit
* AWS Amplify login
* Container Layout
* Mega Menu
* Add invoice page
* SAAS pages like - Privacy Policy and FAQ
* Image upload in kanban
* Performance Enhancement
* Package upgrades
* Fix most possible security vulnerabilities
* Client suggestions and Bug Fixes
* Next JS Full Version (Released on 25-Mar-2022)

### Migration From v3.0.0 to v3.1.0

* This version brings most of the new features, so you can directly copy those components from the new version if needed.
* For the package upgrades, you can pick the latest package.json and then run yarn/npm. You can resolve errors by copying files from the latest version.
* If you need redux-toolkit for your app, we recommend using this version as a base version for your code, else you can refer src/store folder and its references.
* For any performance changes, you can refer to our [blog](https://blog.berrydashboard.com/year-wrap-up-2021-february-edition) for changes we did.

## v3.0.0 - (21-10-2021)

* Migration to [MUI 5.0.4](https://github.com/mui-org/material-ui/releases/tag/v5.0.4) stable version (Major change)
* Next.js TypeScript version (Released on 31-10-2021)
* [Kanban](https://berrydashboard.com/apps/kanban/board) full-featured App
* Simplified Authentication flow
* Upgrade to react-router v6.0.0-beta.5
* Other improvements like Styling, Documentation.
* Figma Design file - Improvement and added Kanban app
* Added new videos in the Berry Tutorial series.
  * [How to Video series](https://www.youtube.com/playlist?list=PLknn3jaIuWiALE6UUYYBaefZedx18fN-C)
  * [Authentication Video](https://www.youtube.com/watch?v=daHRKlIi6Uc)

### Migration From v2.0.0 to v3.0.0

* Berry 3.0 has major changes with the support of MUI 5.0.x stable version. **withStyle** and **makeStyle** are no longer used. So if you want to migrate your project to the latest stable version, you can do the following.
  1. &#x20;Run style CodeMode by MUI
     * [https://mui.com/guides/migration-v4](https://mui.com/guides/migration-v4/#migrate-from-jss)

{% hint style="success" %}
We have not used *codemod* for migration but we created style components and then used that. If you prefer that approach, you can do that as well.
{% endhint %}

* For the Authentication, We have improved and simplified it, so you can replace it as a whole. Just refer to this [Authentication video](https://www.youtube.com/watch?v=daHRKlIi6Uc).
* Let us know if you need migration assistance via the [Support panel](https://codedthemes.support-hub.io).

## v2.0.0 - (03-08-2021)

* Upgrade to Material-UI Beta: 5.0.0-beta.1
* Upgrade to react-router: 6.0.0-beta.0
* [E-Commerce](https://berrydashboard.com/apps/e-commerce/products) App
  * Product List
  * Product Details
  * Checkout
* Enforce Eslint Rules
* Absolute imports
* Remove package "react-material-UI-carousel" due to no support in MUI Beta. Achieved same using "slick-carousel"
* Other minor improvements & fixes

### Migration From v1.2.0 to v2.0.0

#### Use Codemods for Material-UI upgrades

Material-UI provides `codemods` \*\*\*\*for migration. Please follow this guideline: <https://next.material-ui.com/guides/migration-v4/#run-codemods> We highly recommend checking the above link if you want to upgrade your current project.

#### react-router upgrades

Follow this if you want to use react-router beta: <https://github.com/ReactTraining/react-router/blob/dev/docs/advanced-guides/migrating-5-to-6.md>

## v1.2.0 - (12-06-2021)

**Added**

* [Form Layouts](https://berrydashboard.com/forms/layouts/layouts)
  * Multiple layouts - Simple, Horizontal, with label, divider
  * Multi column forms
  * Action bar
  * Sticky Action bar
* [Form Validation](https://berrydashboard.com/forms/forms-validation)
* [Form Wizard](https://berrydashboard.com/forms/forms-wizard)
* Theme
  * 6 color preset files
  * [Grid](https://berrydashboard.com/utils/util-grid) page
* [Animation](https://berrydashboard.com/utils/util-animation)
* [Button](https://berrydashboard.com/components/button) color shadows & Animation

**Fixes**

* Added color preset files.
* Authentication responsive issues fixed.
* Change color variables name
* Table->Enhanced Table checkbox issue fixed.
* Pricing pages fixed.
* Set 404 Error page redirection.

**Apps**

* Mail
  * Change the structure of the Mail app
  * Fixed responsive issues.
* Chat
  * Fixed responsive issue.
  * The drawer issue is fixed.

### Migration from v1.1.0 to v1.2.0

#### Change in naming of color variable to make theme scalable for multiple color options.

| Old               | New               |
| ----------------- | ----------------- |
| blue50            | primaryLight      |
| blue200           | primary200        |
| blue500           | primaryMain       |
| blue600           | primaryDark       |
| blue800           | primary800        |
| deepPurple50      | secondaryLight    |
| deepPurple200     | secondary200      |
| deepPurple500     | secondaryMain     |
| deepPurple600     | secondaryDark     |
| deepPurple800     | secondary800      |
| A100              | successLight      |
| A200              | success200        |
| A400              | successMain       |
| A700              | successDark       |
| red200            | errorLight        |
| red500            | errorMain         |
| red800            | errorDark         |
| deepOrange50      | orangeLight       |
| deepOrange200     | orangeMain        |
| deepOrange800     | orangeDark        |
| amber50           | warningLight      |
| amber100          | warningMain       |
| amber500          | warningDark       |
| backgroundDark    | darkBackground    |
| paperDark         | darkPaper         |
| textDarkTitle     | darkTextTitle     |
| textDarkPrimary   | darkTextPrimary   |
| textDarkSecondary | darkTextSecondary |

## v1.1.0 - (28-05-2021)

* More closer to the single responsibility model
* Added propTypes declaration for components which helps in the development
* Set Prettier formatting property "bracketSpacing" as `true` for better readability
* Code clean up and minor bug fixes
* File Restructured for better code understanding
* Code commenting and documentation

{% hint style="warning" %}
If you using v1.0, please do backup your files first.
{% endhint %}

## v1.0 - Release (15-05-2021)

* Berry initial release


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://codedthemes.gitbook.io/berry/support/changelog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
