/Joke-Generator

A basic joke generator using material design and fetch API

Primary LanguageCSSMIT LicenseMIT

Simple Random Joke Generator

The Simple Random Joke Generator is a lightweight, web-based application designed to brighten your day with a dose of humor. Utilizing the Fetch API to retrieve jokes from a variety of sources, this application presents them in an elegant interface powered by Material Design principles. Whether you need a quick laugh or you're collecting jokes to share with friends, this generator offers a clean, user-friendly experience to explore a vast collection of jests.

Features

  • Random Joke Fetching: Effortlessly fetch random jokes with the simple click of a button.
  • Material Design Interface: Enjoy a modern, clean UI that makes joke browsing a visually pleasing experience.
  • Responsive Design: Fully responsive layout ensures a seamless experience across all devices, from desktops to smartphones.
  • No Repeat Guarantee: Algorithm designed to minimize repeats, offering you fresh humor with each click.

Getting Started

To get started with the Simple Random Joke Generator, follow these simple steps:

Prerequisites

Ensure you have the latest version of a modern web browser installed (Chrome, Firefox, Safari, or Edge).

Installation

  1. Clone the repository:
git clone https://github.com/BaselessFabric/Joke-Generator.git
  1. Navigate to the project directory:
cd joke-generator
  1. Open the index.html file in your browser.

Alternatively, you can deploy it to a web server or integrate it with a live reloading tool like Live Server in Visual Studio Code for development purposes.

Usage

To generate a joke, simply:

  1. Open the application in your web browser.
  2. Click the "Generate Joke" button.
  3. Enjoy the joke presented in a beautiful Material Design card.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgments

  • Material Design for their excellent design guidelines.
  • official-joke-api.appspot.com

Thank you for checking out the Random Joke Generator. We hope it brings you as much joy as it brought me in creating it. Happy joking!

Feel free to adjust the content to match the specific features and functionalities of your Joke Generator project, including any specific APIs you're using or additional instructions for contributors.