This project was developed to demostrate the use of frontend technologies alongside backend technologies. It is a web application that essentially converts currencies of any kind to a desired currency using current/live rates.
In other to successfully run this program the following should be installed:
Create the neccessary environmental variables:
This project was made by using the following technologies:
- React
- React Query
- Axios
- NodeJs
- Express
- MongoDB
- Docker
- Kubernetes
This project can be ran locally and can also be ran on docker.
The following steps should be followed after installing the prerequisite to run the project locally:
-
Create a .env file in both the frontend folder and the backend folder. For the backend folder, the env file would contain:
- MONGODB_URL=<Your-Personal-MONGODB_URL>
- JWT_SECRET=IwillNotMakeLastAttempt
For the Frontend folder, the env file would contain:
- VITE_API_KEY=<Personal-VITE_API_KEY>
-
run the command
npm install && npm run dev
This command has to be ran in the terminal from the frontend folder and also on the backend folder to install the dependencies and run both the backend and the frontend server. The terminal will display the URLs for both your frontend server and backend server after running the commands.
This doesn't need you installing NodeJs or any dependencies on your machine. All dependencies would be installed on the docker container. To successfully run this project on docker the following steps should be taken:
-
Install and run docker desktop on your machine, to use docker technology
-
Update the environment variables on the docker-compose file
-
Run the following commands
docker-compose build
docker-compose up
This would build the project on a Node container and the docker-compose file will simultanously run both servers and display their urls on the terminal.
-- Ongoinging development --
The project has been deployed and can be found in the following links:
Web: Currency-Converter
Demo Account:
username: Spending
password: Oporleti1?
or
username: jaymhorsh
password: Ola12345.
Jaji Moshood ####### Web Developer
Azeez Razaq ####### DevOps Engineer