Explore the App »

View Demo · Download APK · Request Feature

TABLE OF CONTENTS

1. About The Project
   • Sneak peak
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. Author
6. Documentation
7. License

About The Project

Chuck App is a Joke App that displays the most current and random chuck norris jokes, and you may acquire a new joke or fact by pressing any category represented by corresponding icons on the main page. You may also find jokes by putting a phrase into the search box.

Sneak peak

1. To the first screen, The list of categories are represented by icons and can they can be found the the top of the screen.
2. The random default joke is displayed to the screen.
3. When the first Search is clicked, We should be redirected to the search screen that has the search box to search any Joke.
4. When we click to the second icon Generate joke, A new joke should be displayed to the screen.
5. When the last icon Share with others is clicked, You will be able to share a joke with your freinds on any available app in your phone
6. When searching for a joke you, You need to enter a word having more than 3 characters, If a less than 4 characters is enetered an alert popup.
7. For more information you can check the link for the video here: Explore the App »
8. Enjoy!
   
   
   
   

⬆️

Built With

⬆️

Getting Started

This project depends on this Chuck Norris API

To get a local copy up and running follow these simple example steps.

Prerequisites

• Node: v16.13.1
• Javascript enabled browser

Installation

1. Clone the repo:

   git clone https://github.com/mwafrika/chuck-test-sovetech.git

2. go to the project folder:

   cd chuck-test-sovetech.git

3. Install the dependencies:

   yarn install

4. Start the server:

   expo start

5. To run the app locally you can do this:

   Scan the QR Code in the console using the expo app on your phone or your can use an android simulator on your computer if you have one.

6. Enjoy!

⬆️

Usage

For an easy access to the App please use this link

⬆️

Contributing

Contributions are what make the open source community such a wonderful place to learn, be inspired, and create. Your contributions are greatly appreciated.

Please, take a look at open issues for a full list of proposed features (and known issues).

If you have an idea on how to improve this, please fork the repository and submit a pull request. You may alternatively create a new issue with the tag "improvement." Don't forget to rate the project! Thank you once again!

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

⬆️

Authors

👤 Mwafrika Josué

• GitHub: @mwafrika
• LinkedIn: @mwafrika-mufungizi
• Twitter: @mwafrikamufung1
• Website: mwafrika.me

⬆️

Documentation

• Styled Components
• React Native
• React Navigation
• ESLint
• Jest
• Redux

⬆️

License

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

⬆️