DEV Community

loading...
Cover image for Node JS API - With React UI: Berry Dashboard

Node JS API - With React UI: Berry Dashboard

Sm0ke
#Automation, my favorite programming language
・3 min read

Hello Coders,

This article presents a simple Node JS API Server built with Express, MongoDB and Typescript. The product can be used to bootstrap fast a backend server or just for educational purpose. To make this article more useful, I will mention an open-source React Dashboard already configured to work with this Node/Express server.

Thanks for reading! - Content provided by App Generator.


(already configured to communicate with the Node JS API Server)


React Berry Dashboard - Open-source full-stack seed project crafted in React and Material UI.


How To use the code

As mentioned, product has a simple codebase and anyone with a basic NodeJS knowledge can compile and start locally the server with just a few commands typed in a terminal window. Bellow are the build commands extracted from the README file. Before type anything, please make sure you have a decent Node JS version, the recommended version is 12.x or above. Another dependency is to have a MongoDB Server up & running.

Step #1 - Clone the sources

$ git clone https://github.com/app-generator/api-server-nodejs.git
$ cd api-server-nodejs
Enter fullscreen mode Exit fullscreen mode

Step #2 - Install dependencies

$ npm i
// OR
$ yarn 
Enter fullscreen mode Exit fullscreen mode

Step #2 - Start the API server (development mode)

$ npm dev
// OR
$ yarn dev 
Enter fullscreen mode Exit fullscreen mode

Once the server is up & running, we can use POSTMAN to query the API server and check out the responses. The API definition of the server is also available on Github at this location.

By default, our server starts on port 5000 but we can customize the value in the .env file saved in the root of the project.

The API:

  • Register - create a new user
  • Login - authenticate the user and returns a (JWT) Token on success
  • Logout - kill the session
  • Check Session - verify that a session is still active

Registration request

Using POSTMAN we can test the API server with ease. Let's create a new user:

Edit the URL

http://localhost:5000/api/users/register
Enter fullscreen mode Exit fullscreen mode

Edit the Request Body

{
    "username":"test",
    "password":"pass", 
    "email":"test@myserver.com"
}
Enter fullscreen mode Exit fullscreen mode

If the user is successfully created, we should see something like this in the response field:

{
    "userID": "60e7db4331173d284832a0ab",
    "msg": "The user is created"
}
Enter fullscreen mode Exit fullscreen mode

Node JS API - Registration API request in POSTMAN.


Pretty simple! In a similar way we can authenticate the user or check if the session is still active or not.


Authenticate User (login)

Edit The URL

http://localhost:5000/api/users/login
Enter fullscreen mode Exit fullscreen mode

Request Body

{
    "password":"pass", 
    "email":"test@myserver.com"
}
Enter fullscreen mode Exit fullscreen mode

The response should include the generated JWT Token and from this point we can perform request and access the private section exposed by the API.


Where to go from here? We can connect a React UI to talk with our simple API and authenticate users.


React Node JS Berry

This open-source React Dashboard, designed by CodedThemes, can be download from the product page (no registration lock) or directly from Github.


All good, let's build the product

Step #1 - Clone the project

$ git clone https://github.com/app-generator/react-berry-admin-template.git
$ cd react-berry-admin-template
Enter fullscreen mode Exit fullscreen mode

Step #2 - Install dependencies via NPM or yarn

$ npm i
// OR
$ yarn
Enter fullscreen mode Exit fullscreen mode

Step #3 - Start in development mode

$ npm run start 
// OR
$ yarn start
Enter fullscreen mode Exit fullscreen mode

Once the React UI is up and running, we can create and authenticate users and get access to the private area of the site.


React Node JS Berry - Login page.


React Node JS Berry - UI Icons

React Node JS Berry - UI Icons page.


Thanks for reading! Feel free to AMA in the comments.

Discussion (9)

Collapse
crearesite profile image
WebsiteMarket

Really nice React design!

Collapse
sm0ke profile image
Sm0ke Author

Ty! Crafted by by @codedthemes
I'm just the messenger.

Collapse
sm0ke profile image
Sm0ke Author

Ty! Crafted by @codedthemes
I'm just the messenger.

Collapse
uithemes profile image
ui-themes • Edited

The API looks simple.
Would be great to have that Docker usable :)
Thank you for sharing this!

Collapse
sm0ke profile image
Sm0ke Author

Yw! The codebase aims to help beginners.
There are many great full-featured Node JS API starters already published on GH.

Collapse
sentadoensilla profile image
sentadoensilla

Beauty and usefull

Collapse
sm0ke profile image
Sm0ke Author

Ty! 🚀🚀

Collapse
rakesh_nakrani profile image
Rakesh S Nakrani

Thanks for sharing Berry Nodejs open source seed project. @sm0ke

Collapse
sm0ke profile image
Sm0ke Author

🚀🚀