Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/Maddoxx88/next-joke

Random Two Part Joke App using Flutter.
https://github.com/Maddoxx88/next-joke

api flutter flutter-app jokes random-generation share ui

Last synced: 30 days ago
JSON representation

Random Two Part Joke App using Flutter.

Awesome Lists containing this project

README

        

NextJoke







Read, Share, Enjoy the Next Joke. Built with Flutter.







#### Initial Widget on CodeAppRun:

[![codeapprun.io](https://raw.githubusercontent.com/acervenky/codeapprunbadge/master/assets/car4.svg)](https://codeapprun.io/sharky/widget/aMzzTEMOwJ)

## Table of Contents

- [Introduction](#introduction)
- [Features](#features)
- [Packages Used](#packages-used)
- [Feedback](#feedback)
- [Build Process](#build-process)
- [License](#license)
- [Acknowledgments](#acknowledgments)

## Introduction
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) ![Status](
https://img.shields.io/badge/status-active-success?style=flat-square)

Keep on getting endless amount of jokes with just a click. You can even share the joke to your friends if you like it. Also you can, if you want, change the color theme of your current UI to explore some great color combinations.

**Available ONLY for Android.**

## Features

* BLoC State Management
* Unlimited API Fetch
* Tweak UI Theme
* Joke Sharing
* Other awesome features yet to be implemented

## Packages Used

- [http](https://pub.dev/packages/http) - To make HTTP requests
- [google_fonts](https://pub.dev/packages/google_fonts) - Display Custom Fonts
- [flutter_bloc](https://pub.dev/packages/flutter_bloc) - BLoC Management
- [equatable](https://pub.dev/packages/equatable) - To compare objects
- [flutter_spinkit](https://pub.dev/packages/flutter_spinkit) - Animated Loading Indicator
- [esys_flutter_share](https://pub.dev/packages/esys_flutter_share) - Used for Sharing the Joke to all available applications

## Feedback

Feel free to send me feedback on [Twitter](https://twitter.com/sunitshirke_88) or [file an issue](https://github.com/Maddoxx88/next-joke/issues/new). Feature requests are always welcome. If you wish to contribute, please take a quick look at the [guidelines](./CONTRIBUTING.md)!

## Build Process

- Follow the [Flutter Guide](https://flutter.dev/docs/get-started/install) for getting started building a project with dart code. **A Mac is required if you wish to develop for iOS.**
- Clone or download the repo
- `flutter pub get` to install packages
- Connect Emulator or a physical device
- `flutter devices` to check if device is connected
- `flutter run` to run the app on the connected device

Please take a look at the [contributing guidelines](./CONTRIBUTING.md) for a detailed process on how to build your application as well as troubleshooting information.

## License

This project is licensed under the MIT License - see the `LICENSE` file for details

## Acknowledgments

- Thanks to [@15Dkatz](https://github.com/15Dkatz) for making this awesome [Random Joke API](https://github.com/15Dkatz/official_joke_api).
- Star Badge - [Animated Github Badges](https://github.com/acervenky/animated-github-badges/blob/master/README.md)

## Give it a if you like it!