> For the complete documentation index, see [llms.txt](https://appseed.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appseed.gitbook.io/docs/products/full-stack/react-material-dashboard.md).

# Full-Stack React Material

Premium React Dashboard designed by Creative-Tim, coded as a full-stack product by AppSeed

Full-stack version of **React Material Dashboard**, a premium design crafted by **Creative-Tim** now usable with multiple API Backend Servers: **Node JS**, Flask, Django. The UI comes with pre-configured **JWT authentication** powered by a [Unified API Interface](/docs/boilerplate-code/api-server/api-unified-definition.md) that makes this product compatible with more than one backend: Node JS, Flask, Django (FASTapi coming soon). For newcomers, **React Material Dashboard** is a popular dashboard template that makes use of light, surface, and movement.

* [Full-stack React Material Dashboard](https://appseed.us/full-stack/react-material-dashboard) - product page
* [Full-stack React Material Dashboard](https://fullstack-react-material-dashboard.appseed-srv1.com/) - LIVE Demo

![React Material Dashboard - Full-stack Version](https://4080083720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYVW6MKCi9iujNc3SK_%2F-Mgj6v09Zx2nkIp2CItc%2F-Mgj7OlW5oPQSqRa1Aaa%2Freact-material-dashboard-screen.png?alt=media\&token=45bb97bc-01b9-460c-8618-516b9d12f6a8)

## Product Dependencies

To successfully compile and use the product, please make sure your workstation has the right tools installed and accessible in the terminal window:

* [Node JS](https://nodejs.org/en/) 12.x version (or above) - used to build both parts (frontend & backend)
* [GIT](https://git-scm.com/) versioning command-line tool - used to clone the sources from Github
* A code editor: [VsCode](https://code.visualstudio.com/) or [Atom](https://atom.io/)
* Ability to work in the terminal window

## Product Features

The product aims to help developers skip over the basics and start faster a new full-stack product already enhanced with authentication, a pixel-perfect UI powered by production-ready backends. The fact that makes this full-stack product unique is the JSON-API compliance over multiple servers:

* \*\*\*\*[Node JS API](/docs/boilerplate-code/api-server/node-js.md): Typescript, Flexible persistence (SQLite, Mongo), TypeORM, Validation
* [Django API](/docs/boilerplate-code/api-server/django.md): JWT Authentication over DRF, SQLite, Docker
* [Flask API](/docs/boilerplate-code/api-server/flask.md): powered by Flask-JWT-extended, SQL-Alchemy, Docker
* Coming soon APIs: **FASTapi**, **Laravel API**

By default, the UI redirects the guest users to the login page. Once the user is authenticated, all private pages are unlocked.

> Implemented JWT Authentication Flow: Login, Logout, Register.

![Full-Stack React Material Dashboard - Login](https://4080083720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYVW6MKCi9iujNc3SK_%2F-Mgj6v09Zx2nkIp2CItc%2F-MgjHy3DFVK5N3jx-p-H%2Ffullstack-react-material-dashboard-login-xs.jpg?alt=media\&token=994f2dbf-fbcd-4f65-87ea-a0dee651a8fc)

## **How to use the product**

Full-stack React Material Dashboard is built using a two-tier architecture where the UI is decoupled from the backend API server and communicates using requests secured by **JWT tokens**. The recommended way to start using this full-stack product is to follow a simple setup:

* Step #1 - Build and start the backend server
* Step #2 - Build and start the UI
* Create a new user via the registration page
* Authenticate and access the private pages
* Add your magic on top of the existing codebase.

## Start the backend server

As mentioned before, the UI is configured to work with many backend servers that share a common API interface: [Django](/docs/boilerplate-code/api-server/django.md), [Node JS](/docs/boilerplate-code/api-server/node-js.md), [Flask](/docs/boilerplate-code/api-server/flask.md). Based on your license (free or commercial) the access is granted to the request API Server. On this page, we will compile and start the free version of Node JS API (open-source product).

> Start [Node JS API Server](/docs/boilerplate-code/api-server/node-js.md) - open-source version

**Step #1 -** Clone the sources

```
$ git clone https://github.com/app-generator/api-server-nodejs.git
$ cd api-server-nodejs
```

**Step #2 - Install dependencies** via NPM or Yarn

```
$ npm i
// OR
$ yarn
```

**Step #3 - Run the SQLite migration** and create the required tables

```
$ yarn typeorm migration:run
```

**Step #4 - Start the API server** - development mode

```
$ npm dev
// OR
$ yarn dev
```

The API interface used by the API is a simple JWT authentication layer that exposes the following methods:

* USERS API:
  * `/api/users/register`: create a new user
  * `/api/users/login`: authenticate an existing user
  * `/api/users/logout`: delete the associated JWT token
  * `/api/users/checkSession`: check an existing JWT Token for validity
  * `/api/users/edit` - edit the information associated with a registered user

At this point, the backend API should be & and running on address: `http://localhost:5000` and we can move on with the setup and build the React UI.

## Start the React UI

The **React Material Dashboard** being a commercial product, a license is required before getting access to the source code. In case you don't have a license, please access the product page and purchase one.

**Step #1** - Clone the project

```
$ git clone https://github.com/app-generator/priv-react-material-dashboard-pro.git
$ cd priv-react-material-dashboard-pro
```

**Step #2** - Install dependencies via NPM or yarn

```
$ npm i
// OR
$ yarn
```

**Step #3** - Start in development mode

```
$ npm run start 
// OR
$ yarn start
```

## Backend Integration

> The backend API server address is saved in `src/config/constant.js`.

```
export const API_SERVER = "http://localhost:5000/api/";
```

> Frontend api has been created at `src/api/auth.js`.

```
const axios = Axios.create({
    baseURL: `${baseURL}/api`,
    headers: { "Content-Type": "application/json" },
});
```

## React Material UI

*Official Product Information* **- Material Dashboard PRO** React is a Premium Material-UI\@4.1.0 Admin with a fresh, new design inspired by Google's Material Design. We are very excited to introduce our take on the material concepts through an *easy-to-use* and beautiful set of components. Material Dashboard PRO React was built over the popular Material-UI framework - *UI designed by **Creative-Tim***:

* [Material Dashboard React](https://bit.ly/36LDZyo) - open-source version (React template version)
* [Material Dashboard React](https://bit.ly/3o8InNN) - premium version (React template version)

![React Material Dashboard - Template Version.](https://4080083720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYVW6MKCi9iujNc3SK_%2F-MgkEZx8hYxAFvpOLx8N%2F-MgkGRKVw3FrFtJlRwP8%2Freact-material-dashboard-ct.jpg?alt=media\&token=068b9ea3-2054-466a-8759-59101193eca3)

## Support & Resources

* For assistance access the [support](https://appseed.us/support) page
* Join [Discord](https://discord.gg/fZC6hup) - 24/7 LIVE assistance for registered users
* [React Apps](https://appseed.us/apps/react) - free and commercial products