Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/muchokidavid/joker
A React app that fetches and displays random jokes from different categories using a Jokes API.
https://github.com/muchokidavid/joker
api bootstrap5 firebase html-css-javascript ico json md packages reactjs responsive-web-design tailwindcss
Last synced: about 1 month ago
JSON representation
A React app that fetches and displays random jokes from different categories using a Jokes API.
- Host: GitHub
- URL: https://github.com/muchokidavid/joker
- Owner: MuchokiDavid
- License: mit
- Created: 2024-01-03T11:04:01.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-06-06T21:37:59.000Z (5 months ago)
- Last Synced: 2024-10-12T16:41:50.893Z (about 1 month ago)
- Topics: api, bootstrap5, firebase, html-css-javascript, ico, json, md, packages, reactjs, responsive-web-design, tailwindcss
- Language: JavaScript
- Homepage: https://joker-react.vercel.app/
- Size: 1.22 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Joker App
A React app that fetches and displays random jokes from different categories using a Jokes API.
## Table of Contents
- [Features](#features)
- [Setup](#setup)
- [Usage](#usage)
- [API Used](#api-used)
- [Contributing](#contributing)
- [License](#license)
- [Author](#author)
## Features
- Fetch random jokes from different categories.
- Select a category from a dropdown menu.
- Display the selected category's random joke.
- Simple and responsive UI.
## Setup
### Prerequisites
- Node.js and npm installed on your machine.
### Installation
1. Clone the repository:
```bash
git clone https://github.com/MuchokiDavid/Joker.git
2. Navigate to the project directory:
```bash
cd joker
```
3. Install dependencies:
```bash
npm install
```
### Usage
1. Start the development server:
```bash
npm start
```
2. Open your browser and navigate to http://localhost:3000.
You should see an interface with a "Get Joke" button, a select input for selecting the category of jokes and a paragraph of joke randomly generated.
3. Explore random jokes by selecting different categories from the dropdown.
### API Used
This app uses the Jokes API to fetch random jokes. You can find more information about the [API here.](https://v2.jokeapi.dev/)
### Contributing
1. Fork the repository.
2. Create a new branch for your feature: git checkout -b feature/new-feature.
3. Make your changes and commit: git commit -m 'Add new feature'.
4. Push to the branch: git push origin feature/new-feature.
5. Submit a pull request.
### License
This project is licensed under the MIT License - see the LICENSE file for details.
### Author
[Muchoki David](https://www.linkedin.com/in/david-muchoki-866552204)