Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mandarwagh9/genquote

Users can generate new quotes, tweet their favorites, and save quotes to their favorites list
https://github.com/mandarwagh9/genquote

html quote quote-generator twitter x

Last synced: 16 days ago
JSON representation

Users can generate new quotes, tweet their favorites, and save quotes to their favorites list

Awesome Lists containing this project

README

        

# Random Quote Generator

Welcome to the Random Quote Generator project! This is a simple web application that provides inspirational quotes to users. Users can generate new quotes, tweet their favorites, and save quotes to their favorites list.

## Features

- **Generate Random Quotes**: Fetches and displays random inspirational quotes from an external API.
- **Tweet Quotes**: Allows users to tweet the current quote with a promotional watermark.
- **Save Favorites**: Users can save their favorite quotes to a local storage and manage them.
- **Delete Favorites**: Users can remove quotes from their favorites list.

## Technologies Used

- **HTML**: Markup language for structuring the web page.
- **CSS**: Styles the web page with modern aesthetics.
- **JavaScript**: Handles dynamic content and interactions.
- **Quotable API**: Provides random quotes for the application.

## Installation

To get started with the Random Quote Generator, follow these steps:

1. **Clone the Repository**:
```bash
git clone https://github.com/yourusername/GenQuote.git
```

2. **Navigate to the Project Directory**:
```bash
cd GenQuote
```

3. **Open `index.html` in Your Browser**:
Simply open the `index.html` file in your web browser to view the application.

## Usage

1. **Generate a New Quote**: Click the "New Quote" button to fetch and display a random quote.
2. **Tweet the Quote**: Click the "Tweet Quote" button to open Twitter with the current quote pre-filled, including a promotional watermark.
3. **Save to Favorites**: Click the "Save Quote" button to add the current quote to your favorites list.
4. **View Favorites**: The favorites section displays all saved quotes. Click the trash icon next to a quote to remove it from your favorites.

## Contributing

Contributions are welcome! If you have suggestions or improvements, please follow these steps:

1. **Fork the Repository**.
2. **Create a New Branch**:
```bash
git checkout -b feature/your-feature
```
3. **Make Your Changes**.
4. **Commit Your Changes**:
```bash
git commit -am 'Add new feature'
```
5. **Push to the Branch**:
```bash
git push origin feature/your-feature
```
6. **Create a Pull Request**.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Contact

For any questions or feedback, please reach out to [X/twitter](https://x.com/waghweb).