Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Random Quote Generator App added to Beginner Tier #785

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
42 changes: 42 additions & 0 deletions Projects/1-Beginner/Random-Quote-Generator-App.md
Original file line number Diff line number Diff line change
@@ -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.