diff --git a/Projects/1-Beginner/Random-Quote-Generator-App.md b/Projects/1-Beginner/Random-Quote-Generator-App.md new file mode 100644 index 000000000..8b092184d --- /dev/null +++ b/Projects/1-Beginner/Random-Quote-Generator-App.md @@ -0,0 +1,42 @@ + +# Random Quote Generator + +**Tier:** 1-Beginner + +The Random Quote Generator is a simple web application that generates and displays random quotes to the user. It is a great project for beginners who want to practice their web development skills and learn about working with APIs. + +## Purpose of the Application + +The purpose of this application is to provide users with an enjoyable and inspiring experience by displaying random quotes from various sources. Users can use these quotes for motivation, reflection, or simply for fun. This project serves as an introduction to web development, APIs, and basic user interface design. + +## Main Features + +- Display a random quote on the web page. +- Fetch random quotes from a public API. +- Allow users to request a new random quote by clicking a button. +- Provide a simple and clean user interface to enhance the user experience. + +## User Stories + +- [ ] As a user, I want to see a random quote displayed when I open the application. +- [ ] As a user, I want to be able to click a button to generate a new random quote. +- [ ] As a user, I want the quote to include the author's name. +- [ ] As a user, I want to share the displayed quote on social media platforms. +- [ ] As a user, I want the option to copy the quote to my clipboard for easy sharing. + +## Bonus Features + +- [ ] Allow users to filter quotes by category or topic (e.g., motivational, funny, inspirational). +- [ ] Implement a "favorite" or "save" feature that allows users to save their favorite quotes. +- [ ] Add a feature to search for quotes by keywords. +- [ ] Create a user account system that allows users to save and manage their favorite quotes. + +## Useful Links and Resources + +- [Quotable API](https://quotable.io/api/): This API provides a free and simple way to fetch random quotes for your application. +- [How to Fetch Data from an API with JavaScript](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Fetching_data): A tutorial on using JavaScript to fetch data from an API. + +## Example Projects + +1. [Quotes on Design](https://quotesondesign.com/): A website that showcases design-related quotes. This can serve as an example of a similar project. +2. [Inspirational Quotes](https://github.com/vinitshahdeo/inspirational-quotes): An open-source project on GitHub that provides a collection of inspirational quotes. You can explore the source code for reference. \ No newline at end of file