Skip to content

Awesome Books is a project that implements medium-fidelity wireframes to create a UI.

Notifications You must be signed in to change notification settings

zamcham/Awesome-Books

Repository files navigation

Awesome Books

logo

Awesome Books

📗 Table of Contents

📖 Awesome Books

"Awesome books" is a simple website that displays a list of books and allows you to add and remove books from that list. By building this application, I will learn how to manage data using JavaScript. Thanks to that my website will be more interactive. I will also use a medium-fidelity wireframe to build the UI.

🛠 Built With

Tech Stack

Client

Key Features

  • A fully functional website
  • Mobile first website

(back to top)

🚀 Live Demo

(back to top)

💻 Getting Started

To get a local copy up and running, follow these steps:

Prerequisites

In order to run this project you need:

  1. A web browser to see the website.

  2. And a code editor if you want to edit the code. For example, Vs Code.

Setup

Clone this repository to your desired folder:

  1. Clone it using your terminal:
git clone https://github.com/zamcham/Awesome-Books.git
  1. If the previous method does not work you may also download the repo as a .zip file and once you decompress the .zip file you are ready to use it.

Important: do not forget to clone the repo in the correct folder, probably you will use the following commands to achieve that in your terminal:

  1. To navigate a certain folder:
cd <folder name>
  1. To navigate to the previous folder:
cd ..

Install

Install this project with:

  1. To see this project you will not need to install something else.

  2. But in case you want to test the linter that I configured to check errors you will have to complete the following steps:

npm init -y
npm install --save-dev hint@7.x
  1. If you run npm install do not forget to create a .gitignore file to prevent the node_modules to be uploaded to GitHub:
.gitignore
node_modules/

Usage

To see this project you will only need to:

  1. Open the index.html file with a web browser.

Run tests

To run tests, run the following command:

npx hint .

Deployment

You can deploy this project using GitHub pages:

  1. Log in to your GitHub account and navigate to the repository that contains your website files.
  2. Make sure that your website files are located in the main branch and in the root directory of the repository.
  3. If your website is not already live, make sure that the index.html file is the main page of your website.
  4. Click on the "Settings" tab in your repository.
  5. Scroll down to the "GitHub Pages" section.
  6. In the "Source" dropdown menu, select the branch where your website files are located. For a simple website with only HTML and CSS, this is typically the main branch.
  7. In the "Path" field, make sure that the root directory is specified (i.e., "/").
  8. Click "Save" to generate your website.
  9. Wait a few minutes for GitHub to build and deploy your website.
  10. Once the website is deployed, visit the GitHub Pages URL to view your site.

(back to top)

👥 Authors

👤 Cristian Zambrano

👤 Julio Quezada

(back to top)

🔭 Future Features

  • I will add a contact form
  • I will add a navigation bar

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project please give a star. Thanks in advance.

(back to top)

🙏 Acknowledgments

I would like to thank Wes Bos because I learned how to implement flexbox with his free tutorial:

(back to top)

❓ FAQ (OPTIONAL)

  • Are you goin to use React in the future?

    • Yes! I will transform this website into a React App.
  • Did you create this website from scratch?

    • Yes! From zero, and I will improve it a lot.

(back to top)

📝 License

This project is MIT licensed.

(back to top)

About

Awesome Books is a project that implements medium-fidelity wireframes to create a UI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published