# react-admin [![Build Status](https://travis-ci.org/marmelab/react-admin.svg?branch=master)](https://travis-ci.org/marmelab/react-admin) [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmarmelab%2Freact-admin.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmarmelab%2Freact-admin?ref=badge_shield) [![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/marmelab/react-admin) A frontend Framework for building data-driven applications running in the browser on top of REST/GraphQL APIs, using ES6, [React](https://facebook.github.io/react/) and [Material Design](https://material.io/). Previously named [admin-on-rest](https://github.com/marmelab/admin-on-rest). Open sourced and maintained by [marmelab](https://marmelab.com/). [Home page](https://marmelab.com/react-admin/) - [Documentation](https://marmelab.com/react-admin/Tutorial.html) - [Demo](https://marmelab.com/react-admin-demo/) - [Blog](https://marmelab.com/en/blog/#react-admin) - [Releases](https://github.com/marmelab/react-admin/releases) - [Support](https://stackoverflow.com/questions/tagged/react-admin) [![react-admin-demo](https://marmelab.com/react-admin/img/react-admin-demo-still.png)](https://vimeo.com/474999017) ## Features * Adapts to any backend (REST, GraphQL, SOAP, etc.) * Powered by [Material UI](https://mui.com/material-ui/getting-started/), [react-query](https://react-query-v3.tanstack.com/), [react-hook-form](https://react-hook-form.com), [react-router](https://reacttraining.com/react-router/) and a few more * Super-fast UI thanks to optimistic rendering (renders before the server returns) * Undo updates and deletes for a few seconds * Relationships (many to one, one to many) * Data Validation * Internationalization (i18n) * Themeable, Highly customizable interface * Supports any authentication provider (REST API, OAuth, Basic Auth, ...) * Full-featured datagrid (sort, pagination, filters) * Large library of components for various data types: boolean, number, rich text, etc. * Conditional formatting * Filter-as-you-type * Supports any form layout (simple, tabbed, etc.) * Custom actions * WYSIWYG editor * Customize dashboard, menu, layout * Super easy to extend and override (it's just React components) * Can be included in another React app ## Installation React-admin is available from npm. You can install it (and its required dependencies) using: ```sh npm install react-admin #or yarn add react-admin ``` ## How To Learn React-Admin 1. Read the [Tutorial](https://marmelab.com/react-admin/Tutorial.html) for a 30 minutes introduction. 2. Read the source code of [the demos](https://marmelab.com/react-admin/Demos.html) for real-life examples. 3. Read the [Documentation](https://marmelab.com/react-admin/documentation.html) for a deep dive into the react-admin components and hooks. 4. Red the [Architecture decisions](https://marmelab.com/react-admin/Architecture.html) to better understand why features are implemented that way. 5. Check out the [API Reference](https://marmelab.com/react-admin/Reference.html) for a complete list of the public API. 6. Get [Support](#support) for fixing your own problems ## At a Glance ```jsx // in app.js import * as React from "react"; import { render } from 'react-dom'; import { Admin, Resource } from 'react-admin'; import restProvider from 'ra-data-simple-rest'; import { PostList, PostEdit, PostCreate, PostIcon } from './posts'; render( , document.getElementById('root') ); ``` The `` component is a configuration component that allows to define sub components for each of the admin view: `list`, `edit`, and `create`. These components use Material UI and custom components from react-admin: ```jsx // in posts.js import * as React from "react"; import { List, Datagrid, Edit, Create, SimpleForm, DateField, TextField, EditButton, TextInput, DateInput, useRecordContext } from 'react-admin'; import BookIcon from '@mui/icons-material/Book'; export const PostIcon = BookIcon; export const PostList = () => ( ); const PostTitle = () => { const record = useRecordContext(); return Post { record ? `"${record.title}"` : '' }; }; export const PostEdit = () => ( }> ); export const PostCreate = () => ( ); ``` ## Does It Work With My API? Yes. React-admin uses an adapter approach, with a concept called *Data Providers*. Existing providers can be used as a blueprint to design your API, or you can write your own Data Provider to query an existing API. Writing a custom Data Provider is a matter of hours. ![Data Provider architecture](https://marmelab.com/react-admin/img/data-provider.png) See the [Data Providers documentation](https://marmelab.com/react-admin/DataProviders.html) for details. ## Batteries Included But Removable React-admin is designed as a library of loosely coupled React components built on top of [Material UI](https://mui.com/material-ui/getting-started/), in addition to custom react hooks exposing reusable controller logic. It is very easy to replace one part of react-admin with your own, e.g. to use a custom datagrid, GraphQL instead of REST, or Bootstrap instead of Material Design. ## Examples There are several examples inside the `examples` folder: * `simple` ([Stackblitz](https://stackblitz.com/github/marmelab/react-admin/tree/master/examples/simple)): a simple application with posts, comments and users that we use for our e2e tests. * `tutorial` ([Stackblitz](https://stackblitz.com/github/marmelab/react-admin/tree/master/examples/tutorial)): the application built while following the tutorial. * `demo`: ([Live](https://marmelab.com/react-admin-demo/)) A fictional poster shop admin, serving as the official react-admin demo. You can run those example applications by calling: ```sh # At the react-admin project root make install # or yarn install # Run the simple application make run-simple # Run the tutorial application make build make run-tutorial # Run the demo application make build make run-demo ``` And then browse to the URL displayed in your console. ## Support You can get professional support from Marmelab via [React-Admin Enterprise Edition](https://react-admin-ee.marmelab.com), or community support via [StackOverflow](https://stackoverflow.com/questions/tagged/react-admin). ## Versions In This Repository * [master](https://github.com/marmelab/react-admin/commits/master) - commits that will be included in the next _patch_ release * [next](https://github.com/marmelab/react-admin/commits/next) - commits that will be included in the next _major_ or _minor_ release Bugfix PRs that don't break BC should be made against **master**. All other PRs (new features, bugfix with BC break) should be made against **next**. ## Contributing If you want to give a hand: Thank you! There are many things you can do to help making react-admin better. The easiest task is **bug triaging**. Check that new issues on GitHub follow the issue template and give a way to reproduce the issue. If not, comment on the issue to ask precisions. Then, try and reproduce the issue following the description. If you managed to reproduce the issue, add a comment to say it. Otherwise, add a comment to say that something is missing. The second way to contribute is to **answer support questions on [StackOverflow](https://stackoverflow.com/questions/tagged/react-admin)**. There are many beginner questions there, so even if you're not super experienced with react-admin, there is someone you can help there. Pull requests for **bug fixes** are welcome on the [GitHub repository](https://github.com/marmelab/react-admin). There is always a bunch of [issues labeled "Good First Issue"](https://github.com/marmelab/react-admin/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) in the bug tracker - start with these. If you want to **add a feature**, you can open a Pull request on the `next` branch. We don't accept all features - we try to keep the react-admin code small and manageable. Try and see if your feature can't be built as an additional `npm` package. If you're in doubt, open a "Feature Request" issue to see if the core team would accept your feature before developing it. For all Pull requests, you must follow the coding style of the existing files (based on [prettier](https://github.com/prettier/prettier)), and include unit tests and documentation. Be prepared for a thorough code review, and be patient for the merge - this is an open-source initiative. **Tip**: Most of the commands used by the react-admin developers are automated in the `makefile`. Feel free to type `make` without argument to see a list of the available commands. ### Setup Clone this repository and run `make install` to grab the dependencies, then `make build` to compile the sources from TypeScript to JS. ### Online one-click Setup You can use Gitpod(An Online Open Source VS Code like IDE which is free for Open Source) for working on issues and making PRs. With a single click it will launch a workspace and automatically clone the repo, run `make install` and `make start` so that you can start straight away. [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/from-referrer/) ### Testing Your Changes In The Example Apps When developing, most of the time we use the **simple example** to do visual check. It's the same application that we use in Stackblitz to reproduce errors (see https://stackblitz.com/github/marmelab/react-admin/tree/master/examples/simple). The source is located under `examples/simple/`. Call `make run` to launch that example on port 8080 (http://localhost:8080). This command includes a `watch` on the react-admin source, so any of the changes you make to the react-admin packages triggers a live update of the simple example in your browser. However, the simple example is sometimes too limited. You can use the **demo example** (the source for https://marmelab.com/react-admin-demo/), which is more complete. The source is located under `examples/demo/`. Call `make run-demo` to launch the demo example with a REST dataProvider, or `make run-graphql-demo` to run it with a GraphQL dataProvider. Unfortunately, due to the fact that we use Create React App for this demo, these commands don't watch the changes made in the packages. You'll have to rebuild the react-admin packages after a change (using `make build`, or the more targeted `make build-ra-core`, `make build-ra-ui-materialui`, etc) to see the effect in the demo app. Both of these examples work without server - the API is simulated on the client-side. ### Testing Your Changes In Your App Using `yarn link`, you can have your project use a local checkout of the react-admin package instead of npm. This allows you to test react-admin changes in your app: ```sh # Register your local react-admin as a linkable package $ cd /code/path/to/react-admin/packages/react-admin && yarn link # Replace the npm-installed version with a symlink to your local version $ cd /code/path/to/myapp/ && yarn link react-admin # If you run into issues with React red-screen, then you need to register your app's version of React as a linkable package $ cd /code/path/to/myapp/node_modules/react && yarn link # And then replace the npm-installed version of React with a symlink to your app's node_modules version $ cd /code/path/to/react-admin/ && yarn link react # Rebuild the packages with the same version of React $ cd /code/path/to/react-admin/ && make build # Return to your app and ensure all dependencies have resolved $ cd /code/path/to/myapp/ && yarn install # Start your app $ yarn start ``` ### Automated Tests Automated tests are also crucial in our development process. You can run all the tests (linting, unit and functional tests) by calling: ```sh make test ``` Unit tests use `jest`, so you should be able to run a subset of tests, or run tests continuously on change, by passing options to ```sh yarn jest ``` Besides, tests related to the modified files are ran automatically at commit using a git pre-commit hook. This means you won't be able to commit your changes if they break the tests. When working on the end to end tests, you can leverage [cypress](https://www.cypress.io/) runner by starting the simple example yourself (`make run-simple` or `yarn run-simple`) and starting cypress in another terminal (`make test-e2e-local` or `yarn test-e2e-local`). ### Coding Standards If you have coding standards problems, you can fix them automatically using `prettier` by calling ```sh make prettier ``` However, these commands are ran automatically at each commit so you shouldn't have to worry about them. ### Documentation If you want to contribute to the documentation, install [jekyll](https://jekyllrb.com/docs/home/), then call ```sh make doc ``` And then browse to [http://localhost:4000/](http://localhost:4000/) ## License React-admin is licensed under the [MIT License](https://github.com/marmelab/react-admin/blob/master/LICENSE.md), sponsored and supported by [marmelab](https://marmelab.com). [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmarmelab%2Freact-admin.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmarmelab%2Freact-admin?ref=badge_large) ## Donate This library is free to use, even for commercial purpose. If you want to give back, please talk about it, [help newcomers](https://stackoverflow.com/questions/tagged/react-admin), or contribute code. But the best way to give back is to **donate to a charity**. We recommend [Doctors Without Borders](https://www.doctorswithoutborders.org/).

	Stars	Issues	Version	Updated	Created
@blueprintjs/core			5.10.2	4 days ago	7 years ago
material-ui	91,582	1,778	0.20.2	6 years ago	10 years ago
react-admin	24,006	123	4.16.16	a day ago	9 years ago
semantic-ui-react			2.1.5	4 months ago	9 years ago

@blueprintjs/core vs material-ui vs react-admin vs semantic-ui-react

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past