Skip to content

hossameldinfahmi/MEAN-Good-Reads-App

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Documentation for GitHub MEAN App Goodreads Clone

Introduction:

This documentation aims to provide an overview of the Goodreads Clone App built using the MEAN stack and hosted on GitHub. This app allows users to create an account, search and add books to their reading list, view and review books, and interact with other users through comments and book recommendations.

Prerequisites:

Before running the app, you should have the following installed:

  1. Node.js
  2. MongoDB
  3. Angular CLI

Running the App:

To run the app locally, follow the below steps:

  1. Clone the repository to your local machine using git clone <repository-url>
  2. Navigate to the project directory using cd goodreads-clone
  3. Install the dependencies using npm install
  4. Start the backend server using npm run start:server
  5. Open a new terminal window, navigate to the project directory, and start the frontend server using npm run start:client
  6. Open your web browser and navigate to http://localhost:4200

App Features:

  1. User Authentication: Users can create a new account, login, and logout. The authentication process is managed by JSON Web Tokens (JWTs).
  2. Book Search and Adding to Reading List: Users can search for books using the Google Books API and add them to their reading list.
  3. Book Details and Reviews: Users can view the details of a book, including its description, author, and reviews. Users can also add their own reviews and ratings.
  4. User Interaction: Users can comment on books and recommend books to other users.
  5. User Profile: Users can view their own profile, which includes their reading list and book reviews.

Code Structure:

  1. client directory: This directory contains the Angular frontend code. It includes components, services, and models used to build the user interface.
  2. server directory: This directory contains the Node.js backend code. It includes routes, controllers, and models used to handle user requests, interact with the database, and perform business logic. Backend latest version repo link: [a link](https://github.com/nadaezzat-99/Bookary-API)
  3. package.json file: This file contains the dependencies and scripts used to build and run the app.

Conclusion:

The Goodreads Clone App is an example of a full-stack web application built using the MEAN stack. Its features include user authentication, book search, book details and reviews, user interaction, and user profiles. The app's code is structured into the client and server directories, with the package.json file containing the dependencies and scripts.

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 49.0%
  • HTML 31.7%
  • CSS 19.3%