This library is free to use, even for commercial purpose. If you want to give back, please talk about it, help newcomers, or contribute code. But the best way to give back is to Donate to a Charity. We recommend Doctors Without Borders.

v5.0.0

This major release introduces new features and some breaking changes. Here are the highlights:

UI Improvements

Apps now have a theme switcher and a dark theme by default (#9479)
Inputs now default to full width (#9704)
Links are now underlined (#9483)
List pages restore scroll position when coming back from Edit and Create views (#9774)
Errors in the Layout code now trigger the Error Boundary (#9799)
Button size can be set via props (#9735)

App Initialization

Simpler custom layout components just need to render their children (#9591)
No more props drilling for Layout, AppBar, Menu, etc (#9591)
useDefaultTitle() hook returns the application title from anywhere in the app (#9591)

Data Providers

Data providers can now cancel queries for unmounted components (opt-in) (#9612)
GraphQL data providers are easier to initialize (they are now synchronous) (#9820)
GraphQL-Simple data provider supports Sparse Fields in queries (#9392)
GraphQL-Simple data provider supports updateMany and deleteMany mutations (#9393)
withLifecycleCallbacks now supports for wildcard and array of callbacks (#9577)
Middlewares are more powerful and handle errors better (#9875)

List pages

Datagrid has rowClick enabled by default, it links to the edit or show view depending on the resource definition (#9466)
List bulkActionButtons is now a Datagrid prop (#9707)
setFilters doesn't debounce by default, so custom filters work as expected (#9682)
List parameters persistence in the store can be disabled (#9742)

Forms & Inputs

Inputs no longer require to be touched to display a validation error (#9781)
ReferenceInputs are now smarter by default as they use the recordRepresentation (#9902)
Server-Side validation is now more robust (#9848)
warnWhenUnsavedChanges works again (#9657)
Smart input components like TranslatableInputs, ArrayInput, or ReferenceManyInput now compose more seamlessly thanks to a new SourceContext. There is no need for getSource in FormDataConsumer. (#9533)
All inputs now have a unique ID - no more duplicate ID warnings (#9788)
Learning Forms is facilitated by a new Form chapter in the doc (#9864)

DX Improvements

The default Record Representation for resources is now smarter (#9650)
Data provider hooks like useGetOne have a smart return type based on the request state. This will force you to plan for the error case. (#9743)
Stricter TypeScript types will detect more errors at compile time (#9741)
PropTypes are gone, so there is no conflict with TypeScript types (#9851)
create-react-admin can run in non-interactive mode (#9544)
ra-data-fakerest accepts a delay parameter to simulate network delays (#9908)
data-generator-retail now exposes types for the generated data (#9764)

Bump dependencies

React-admin requires React 18 to leverage Concurrent React (#9827)
React-admin uses the latest version of react-router, react-query, date-fns, fakerest, etc. (#9657, #9473, #9812, #9801, #9908)
Internet Explorer is no longer supported (#9530)

Upgrading to v5

We've written a migration guide to help you upgrade your apps to v5. It covers all the breaking changes and how to adapt your code to the new APIs.

We estimate that a react-admin app with 50,000 lines of code will require about 2 days of work to upgrade to v5.

Changelog

Fix <SelectArrayInput> options panel width and placement (#10232) (fzaninotto)
[Doc] Fix mutationMode reference in create documentation (#10231) (erwanMarmelab)
[Doc] Fix remaining isLoading should be renamed to isPending (#10218) (smeng9)
Build(deps-dev): Bump vite from 5.3.1 to 5.3.6 (#10217) (dependabot[bot])
[Doc] Add ra-data-graphql-supabase to data provider list (#10216) (maxschridde1494)
[Doc] Update <Calendar> doc to explain custom event format (#10214) (erwanMarmelab)
Fix duplicated dependencies in dev packages (#10212) (fzaninotto)
Build(deps): Bump dset from 3.1.3 to 3.1.4 (#10211) (dependabot[bot])
[Doc] Fix outdated isLoading in Data Provider chapter (#10209) (smeng9)
Build(deps): Bump dompurify from 2.4.3 to 2.5.4 (#10208) (dependabot[bot])
Fix for ids not being escaped in paths in the Simple Rest Data Provider (#10206) (ckhsponge)
[Doc] Add doc for <DatagridAgClient>, make <DatagridAg> stable (#10205) (erwanMarmelab)
Fix filter button accessibility (#10204) (djhi)
[Doc] Create a doc page for <DateRangeInput> (#10202) (erwanMarmelab)
Fix FilterButton checked status (#10191) (fzaninotto)
Enable Store sync when disableSyncWithLocation is true (#10187) (WiXSL)
Add icons to FilterButton dropdown (#10186) (erwanMarmelab)
Update <Datagrid> and <SimpleList> empty message when a filter is active (#10184) (erwanMarmelab)
Add support for response metadata in dataProvider.getList() (#10179) (fzaninotto)
Add global Reset CSS (#10164) (fzaninotto)
Fix input validation and dirty state after re-enabling disabled fields (#10163) (michel-paiva)
Add support for computed fields in ra-data-json-server's dataProvider.create() (#10162) (fzaninotto)
[Doc] Document <ReferenceManyField storeKey> prop (#10142) (slax57)
Add <ReferenceManyField storeKey> to allow more than one reference for the same resource (#10132) (djhi)
[Doc] Fix codemod filename extensions in upgrade guide (#10199) (afilp)
Build(deps): Bump dset from 3.1.3 to 3.1.4 (#10196) (dependabot[bot])
[Demo] Fix clear filters option in tabbed datagrid (#10193) (fzaninotto)
Fix List shows empty page too often (#10190) (fzaninotto)
Build(deps): Bump webpack from 5.83.1 to 5.94.0 (#10175) (dependabot[bot])
[Doc]: Fix SimpleFormIterator add and remove buttons snippets (#10173) (julienV)
Fix useFormGroup doesn't return validation errors with react-hook-form 7.53.0 (#10168) (slax57)
Avoid "no source" warning when theres a finalSource in useInput (#10153) (GuilhermeCarra)
[chore] Unit tests: Expand expect with testing-library helpers (#10169) (ThieryMichel)
Build(deps): Bump micromatch from 4.0.5 to 4.0.8 (#10165) (dependabot[bot])
Fix create-react-admin fails with Yarn PnP (#10161) (fzaninotto)
Fix Datagrid row does not appear clickable although it is (#10160) (fzaninotto)
[Doc] Fix video playback on Firefox (#10152) (ThieryMichel)
Build(deps): Bump axios from 1.6.1 to 1.7.4 (#10151) (dependabot[bot])
[Doc] Add screencast for EditInDialogButton in ReferenceManyField documentation (#10137) (djhi)
[Doc] Improve types in QuickFilter doc (#10150) (slax57)
[Doc] Add ra-data-nestjs-query to the list of Data Providers (#10145) (mrnkr)
Fix <PrevNextButtons> index when using paginated results (#10144) (slax57)
[Doc] Fix broken links to webm videos (#10143) (slax57)
Fix ra-data-graphql incorrectly warns about deprecated override option being set (#10138) (JonasDoe)
[Doc] Update ra-search documentation to mention disableHighlight (#10135) (djhi)
[Doc] Fix <ReferenceInput> usage incorrectly mentions the validate prop (#10134) (fzaninotto)
Fix create-react-admin CLI to generate valid react-admin v5 apps (#10131) (djhi)
Update <SelectInput> to support an array of strings as choices (#10038) (fzaninotto)
Add ability to disable title in page components (#9969) (fzaninotto)
Update <ReferenceField> to render a link to the show view when relevant (#9951) (fzaninotto)
Preserve extra query parameters in List view (#9933) (Nilegfx)
Allow to customize Login page icon with <Login avatarIcon> (#9917) (mjarosch)
Add ability to customize the success notification message in delete buttons (#9868) (ethembynkr)
Allow <Title> to be non configurable (#9836) (markyao6275)
fix <AutocompleteInput> clear button does not clear new choice (#10023) (adguernier)
[Doc] Update ra-relationships documentation (#10018) (djhi)
[Doc] Verify if Beginning mode exist before add event (#10016) (arimet)
separate test and default data providers (#10001) (Nilegfx)
Fix <FilterLiveSearch> should react to filter values change (#9996) (slax57)

For a detailed changelog, see the release notes for the following pre-releases:

FAQs

What is ra-core?

Is ra-core popular?

Is ra-core well maintained?

Package last updated on 20 Jun 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install