https://github.com/yeabtsega1/personal-book-collection
Personal Book Collection is a user-friendly web application that lets you easily search for your favorite books using the Open Library API. It also allows you to create and maintain a personalized, virtual bookshelf right in your browser.
https://github.com/yeabtsega1/personal-book-collection
bookstore open-library-api reactjs
Last synced: 4 months ago
JSON representation
Personal Book Collection is a user-friendly web application that lets you easily search for your favorite books using the Open Library API. It also allows you to create and maintain a personalized, virtual bookshelf right in your browser.
- Host: GitHub
- URL: https://github.com/yeabtsega1/personal-book-collection
- Owner: Yeabtsega1
- Created: 2024-06-05T12:26:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-14T08:24:17.000Z (about 1 year ago)
- Last Synced: 2024-12-27T08:08:56.905Z (6 months ago)
- Topics: bookstore, open-library-api, reactjs
- Language: JavaScript
- Homepage: https://personal-book-collection.netlify.app/
- Size: 177 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Personal Book Collection
A user-friendly React application designed to help users search for books using the Open Library API and maintain a personal bookshelf using localStorage.
## About the Project
This project provides an intuitive interface for users to search for books and manage a personal collection called "My Bookshelf". Users can easily add books from search results to their personal bookshelf and remove them when needed.
## Built With
- [React](https://reactjs.org/)
- [React Router](https://reactrouter.com/)
- [Open Library API](https://openlibrary.org/developers/api)
## Getting Started
### Prerequisites
Ensure you have [Node.js](https://nodejs.org/) and npm installed on your local machine. You can verify if you do by running:
```bash
node -v
npm -v
```
### Installation & Setup
1. **Clone the repository**:
```bash
git clone https://github.com/Yeabtsega1/personal-bookshelf.git
```
2. **Navigate to the project directory**:
```bash
cd personal-bookshelf
```
3. **Install the required dependencies**:
This step is crucial for setting up all the necessary dependencies used in the project.
```bash
npm install
```
4. **Start the local development server**:
```bash
npm start
```
Once you run this command, the application will start, and it will be accessible at `http://localhost:3000` in your preferred web browser.
5. Visit the application at `http://localhost:3000` in your browser to view the app!
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## Contact
For any queries or feedback, reach out to [[email protected]](mailto:[email protected]).
## Known Issues
- There are currently no known issues. If you encounter any, please report them.
## Future Enhancements
- Implementing user accounts for more personalized bookshelves.
- Enhancing search capabilities with filters and sorts.