This project is an application used to manage a private book collection. It is separated in two separated subprojects: a frontend and a backend. They are contained using Docker and connected via NGINX to simplify installing and launching the project.
Check the frontend docs for details on the React application and its user interface. Check the backend docs for details on the Nodejs web service.
-
To run this project, first of all you need to have Docker installed. It is recommended to install the Docker desktop app.
-
Open a terminal and navigate to the root of this project. There, run
docker-compose up --build
until it has completed setting up. NOTE: If you want it to not depend on the terminal to be open, add the-d
flag. Bear in mind that in this case you will have to close the containers from the terminal or the desktop app. -
Open a browser and type the URL
http://localhost
. The login page will appear and we are ready to go! For more details on how to navigate the frontend check the frontend docs.
The Docker configuration includes a DataBase management tool: Adminer.
To access it type the URL http://localhost:8000
in a browser and the Adminer login page will appear.
There, set the user root
, the password MYSQL_ROOT_PASSWORD
and the database book_database
to be able to access the book
and user
table.