Dynamic Full-Stack Web Application

Welcome to a compelling full-stack web application, carefully crafted to demonstrate the synergy of technology and innovation. 🚀

Overview

This repository is a showcase of a dynamic full-stack web application, powered by the Java Spring framework for the robust backend and React.js for the interactive frontend. It offers:

JWT User Authentication and Authorization for a secure user experience.
Seamless execution of CRUD Operations supported by essential Spring framework libraries:
- Spring Security
- Spring Web
- Spring Data JPA
- Spring JDBC on the server side.
A modern and user-friendly frontend leveraging React, ReactRouter, and the elegant Chakra framework.
Postgres as the dependable database of choice.
Comprehensive Unit and Integration Tests for reliability and stability.
Full compatibility with CI/CD pipelines for automated builds and deployments.

Deployment

The Backend is effortlessly deployable on AWS Elastic Beanstalk, providing scalability and ease of management.
The Frontend is ready for automated deployment through AWS Amplify, ensuring a seamless user experience.
Profile pictures are stored efficiently using AWS S3, enhancing the visual appeal and user interactions.

Feel free to clone and deploy this application yourself, or contribute to this open-source gem. 🌟

Prerequisites
Getting Started
- Backend (Spring Framework)
- Frontend (React)
Configuration
Usage

Prerequisites

Before you begin, ensure you have met the following requirements:

JDK 17 (both Java 8 and 11 also supported), Node.js v18 or above
Docker installed in your machine and postgres v15.3 or above running in a container.

Getting Started

To get this project up and running, follow the steps below for both the backend (Spring Framework) and frontend (React) components.

Backend (Spring Framework)

To get running backend:

Clone the repository:

git clone https://github.com/msbeigiai/spring-full-stack.git

Navigate to the backend directory:
```
 cd spring-full-stack
```
to run the application there are 2 alternative ways:
- 1. running each one individually
- 1. or by deploying to docker hub and running docker compose.
    I suggest the second option because both backend and frontend will run in a single command
Navigate to the backend folder and run:
```
mvn clean deploy jib:build
```
this command will deploy the latest backend in Docker hub and later can be run in docker compose.

Frontend (React)

To get running frontend:

Navigate back to frontend, then navigate to react folder and run:
```
cd ../frontend/react
docker build . -t msbeigiai/msbeigi-react
docker push msbeigiai/msbeigi-react
```
this will also push latest version of frontend into Docker hub.
To boot up the entire project navigate back to the project root and then run docker compose command:
```
cd spring-boot-example/
docker compose up -d
```

Configuration

In case you see error booting up backend just navigate inside postgres database by running:

docker exec -it postgres bash

and then run:

psql -U msbeigi

while you are prompted for password, supply password.
inside postgres database create customer database by writing:

CREATE DATABASE customer;

by now your application must be up and running.

Usage

By configuring the project as above guidelines, project can run perfectly.

msbeigiai/spring-full-stack