https://github.com/nitbravoa92/bookstore
Development of a web page to add and display books using ReactJS and Redux as application state handler.
https://github.com/nitbravoa92/bookstore
api-rest react-router-v6 reactjs redux-thunk redux-toolkit
Last synced: 10 days ago
JSON representation
Development of a web page to add and display books using ReactJS and Redux as application state handler.
- Host: GitHub
- URL: https://github.com/nitbravoa92/bookstore
- Owner: NitBravoA92
- License: mit
- Created: 2023-07-13T06:07:55.000Z (about 2 years ago)
- Default Branch: dev
- Last Pushed: 2023-08-05T20:37:45.000Z (about 2 years ago)
- Last Synced: 2025-01-13T14:51:57.506Z (9 months ago)
- Topics: api-rest, react-router-v6, reactjs, redux-thunk, redux-toolkit
- Language: JavaScript
- Homepage: https://bookstore-app-ho74.onrender.com/
- Size: 665 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Bookstore WebApp
# 📗 Table of Contents
- [📗 Table of Contents](#-table-of-contents)
- [Bookstore WebApp](#bookstore-webapp)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [💻 Getting Started ](#-getting-started-)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Build](#build)
- [👥 Authors ](#-authors-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)
**Bookstore** is a books web application built with ReactJS, where users can see a list of the latest most famous books added and obtain detailed information about them. In addition, users can add a new book and choose which ones to remove. This webapp will consist of 2 pages: The Books page and the Categories page. In this first version, only the Books page will be 100% finished.
Client
- **Using the ReactJS library**
- **Using the ReactJS Router library**
- **Using JSX syntax**
- **Using semantic HTML**
- **SPA Approach**
- **Responsive Design**
- **Using Redux Toolkit for a global state management**
To see the application working live, you can click on the following link that contains the demo version:
- [Bookstore WebApp - Live Demo](https://bookstore-app-ho74.onrender.com/)
To get a local copy up and running, follow these steps.
### Setup
Clone this repository to your desired folder:
```sh
cd my-folder-name
git clone git@github.com:NitBravoA92/bookstore.git
```
### Prerequisites
In order to install, modify and run this project, it is necessary to have the following applications installed:
- **Git:** to manage the project versions of source code. [You can Download Git here](https://git-scm.com/)
- **Nodejs and NPM:** to install and manage the project dependencies. [Nodejs and NPM installation guide](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- **A code editor** like Visual Studio Code (Recommended) or any other of your preference. It is necessary to open the project and add or modify the source code. [You can Download Visual Studio Code here](https://code.visualstudio.com/)
It is also important to have at least basic knowledge about ReactJS, JSX, HTML, CSS and Javascript languages so you will be able to understand and work with the code of the project.
- [Learn the basics of HTML](https://developer.mozilla.org/en-US/docs/Web/HTML)
- [Learn the basics of CSS](https://developer.mozilla.org/en-US/docs/Web/CSS)
- [JavaScript basics](https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics)
- [Javascript Arrays](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array)
- [Javascript Objects](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
- [JavaScript modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
- [ReactJS](https://react.dev/learn)
- [JSX](https://react.dev/learn/writing-markup-with-jsx)
- [Create React App](https://github.com/facebook/create-react-app)
### Install
Install this project by running the next command into your project folder:
```sh
npm install
```
All the packages and libraries necessary for the project to work will be installed in a folder called /node_module. After this installation, the project will be ready to use.
### Usage
In the project directory, you can run:
- `npm start`
Runs the app in the development mode.\
Open [http://localhost:3000](http://localhost:3000) to view it in your browser.
The page will reload when you make changes.
You may also see any CSS and JS linters errors in the console running the following commands:
CSS Linter
```sh
npx stylelint "**/*.{css,scss}"
```
Javascript Linter
```sh
npx eslint "**/*.{js,jsx}"
```
### Build
- `npm run build`
Builds the app for production to the `build` folder.\
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.\
Your app is ready to be deployed!
See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
**Note**: Please only modify the components files and the CSS files. Do not modify configurations files of the project.
👤 **Nitcelis Bravo**
- GitHub: [Nitcelis Bravo](https://github.com/NitBravoA92)
- Twitter: [@softwareDevOne](https://twitter.com/softwareDevOne)
- LinkedIn: [Nitcelis Bravo Alcala](https://www.linkedin.com/in/nitcelis-bravo-alcala-b65340158)
- [x] **Initialize project with components**
- [x] **Add reducers and actions**
- [x] **Use Redux to manage the state of the components**
- [x] **Connect to the Bookstore API**
- [x] **Add CSS styles to the UI following a proposed design.**
Contributions, issues, suggestions and feature requests are welcome!
Feel free to check the [issues page](../../issues/).
To do Contributions, please fork this repository, create a new branch and then create a Pull Request from your branch. You can find detailed description of this process in: [A Step by Step Guide to Making Your First GitHub Contribution by Brandon Morelli](https://codeburst.io/a-step-by-step-guide-to-making-your-first-github-contribution-5302260a2940)
If you liked this project, give me a "Star" (clicking the star button at the beginning of this page), share this repo with your developer community or make your contributions.
I would like to thank my Microverse teammates for their support. They have supported me a lot in carrying out this project, giving me suggestions, good advice and solving my code doubts.
This project is [MIT](./LICENSE) licensed.