Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mustapha7018/any-jokes

Flutter app that generates a variety of jokes
https://github.com/mustapha7018/any-jokes

api-rest flutter-ui joke-api mobile-development

Last synced: about 2 months ago
JSON representation

Flutter app that generates a variety of jokes

Awesome Lists containing this project

README

        

# Any-Jokes 🤣

Welcome to **Any-Jokes**! This repository contains a collection of hilarious jokes that will brighten up your day. Whether you're looking for a quick laugh or a way to break the ice, you've come to the right place. 🌟

## Dev Info

- Name: Mustapha Adams
- Email: [email protected]

## Introduction

**Any-Jokes** is a simple yet fun Flutter application where you can find jokes. 😂

## Features

- A collection of jokes from various categories.
- Easy-to-use interface for browsing jokes.
- Generate 5 jokes at a time

## Folder Scaffold
- lib/: Contains the main application code.
- lib/data/providers/: Contains the API provider for fetching jokes.
- lib/data/models/: Contains the joke model class.

## Setup

Follow these steps to set up the project locally:

1. **Clone the repository** 🌀
```sh
git clone https://github.com/Mustapha7018/Any-Jokes.git
cd Any-Jokes
```

2. **Install Flutter** 🚀
- If you haven't already, download and install Flutter from the [official website](https://flutter.dev/docs/get-started/install).

3. **Check Flutter setup** 🛠️
```sh
flutter doctor
```

4. **Get the dependencies** 📦
```sh
flutter pub get
```

## Usage

To run the application on your device or emulator, use the following command:

```sh
flutter run
```

## Find Joke
- Launch the app on your device or emulator.
- Use the search bar to enter a keyword for jokes.
- Use the dropdown menu to filter jokes by category.
- Click on "Search Jokes" to fetch and display jokes based on your criteria.

## App UIs
![WhatsApp Image 2024-06-25 at 01 43 47_0bf603df](https://github.com/Mustapha7018/Any-Jokes/assets/91817013/96212838-b542-4fb3-ba0e-1c5291e904b2)
![WhatsApp Image 2024-06-25 at 01 44 22_0c003090](https://github.com/Mustapha7018/Any-Jokes/assets/91817013/fc3e9c4a-d598-4bee-b373-4f1ae6c1bc7e)
![WhatsApp Image 2024-06-25 at 01 45 26_0907062f](https://github.com/Mustapha7018/Any-Jokes/assets/91817013/07199a26-85a7-4928-8a75-6e84d33f0903)
![image](https://github.com/Mustapha7018/Any-Jokes/assets/91817013/cb535276-0e95-4bfc-9a1b-be89319fbbaa)
![image](https://github.com/Mustapha7018/Any-Jokes/assets/91817013/a0d5a221-b0e6-4b75-98e8-46043fc6661a)
![image](https://github.com/Mustapha7018/Any-Jokes/assets/91817013/f203e3e5-f8be-4b76-b453-ebd3f6d6d3ff)