A Flutter application for Muslims that help them challenge and motivate themselves

تنافسوا

a flutter application for muslims that help them challenge and motivate themselves and their friends to read azkar in a fun way.

on play store & on app store

also, take a look at the backend repository.

stats

• 12,200 app installs.
• 2543 signed-in users.
• 1113 users have at least one azkar challenge.
• 999 users have at least one tafseer challenge.
• 849 users have at least one reading quran challenge.
• 205 users have friends.

setting up a development environment

git

to set up a local development environment, you have to do the following :

• download [tanafaso-frontend] (https://github.com/challenge-azkar/tanafaso-frontend)
• download your download using git download https://github.com/<your-github-username>/tanafaso-frontend
• navigate to your local repository using your cmd/terminal based on your local environment
• check that your download is the origin remote using git remote -v, if it is not then added using git remote add origin https://github.com/<your-github-username>/tanafaso-frontend
• add the original project as upstream remote using git remote add upstream https://github.com/challenge-azkar/tanafaso-frontend
• congratulations, you can start contribute now, but make sure you create branch for every proposed change you make.

firebase notifications development

please note that if you don’t intend to do changes regarding notifications, you have to comment the line apply plugin: 'com.google.gms.google-services' in file android/app/build.gradle so as to be able to build the android project.

if you intend to do changes regarding notifications, please create a firebase cloud messaging testing project and then move the google-services.json file you will obtain from firebase to android/app directory.

dependencies

dependencies for android

• android studio ide
• flutter sdk
• java sdk

dependencies for ios

• xcode ide

for more information about dependencies, you can check the flutter documentation.

code guidelines

• use snake case for file names.
• the filename should correspond to the name of the primary class in the file.
• names of files that contains widgets that take the whole screen should end with the suffix: _screen.dart, for example, signup or login takes up the whole screen for authentication.
• names of files that contains widgets that don’t take the whole screen should end with the suffix: _widget.dart, for example, invite friends from facebook or twitter is a widget since it is part of the screen widget, but does not take the whole screen.
• use camel case convention for class and enum names.
• name (classes, variables, functions, modules) in a meaningful name which describe its functionality.
• make sure that all .dart files are formatted using flutter format command.

code structure

assets (pictures, fonts and certificates) can be found in the assets/ folder.

as you may already know, the cool thing about flutter is that you write code once in dart and
then flutter does the hard work of compiling it into native android and ios code. you can find
the compiled native code in the following directories (note that you would rarely need to
change code in these
directories):

• android/
• ios/

all the dart code can be found in the lib/ directory.

• lib/models/: contains the definitions of all of the models used in the application (e.g. user, challenge
  , etc…) and also defines how every model should be encoded and decoded.
• lib/net/: implements the wire between the frontend and the backend (challenge-azkar/tanafas-backend).
  • lib/net/endpoints.dart contains all of the endpoints that the api is supporting for this
    frontend version.
• lib/utils/: contains classes that provide utilities that will be used throughout the application code.
• lib/views/: contains all of the declarations of the user interface.
  • *screen.dart: classes that end with the suffix “screen” are declaring a whole screen that the
    user will see.
  • *widget.dart: classes that end with the suffix “widget” are declaring a widget that will be
    part of the user screen.

contributing

(optionally) join tanafaso’s discord server to give feedback, propose new features or ask for help.

there are a lot of ways you can contribute to this project. you can filter issues by good first issue label to get started with an issue that is easy to fix.

• suggest new features by filing an issue.
• report bugs by filing an issue.
• add code documentation, so that it is easier for future contributers to ramp-up.
• add unit tests (read the testing strategy).
• add widget tests (read the testing strategy).
• refactor the code to make it more readable, maintainable and scalable.
• add pull requests with bug fixes.
• add pull requests with new features.

license

the application code is licensed under mit license.