/sum-plus

Mobile application for elementary school students to practice arithmetic.

Primary LanguageDart

Sum+

Mobile application that seeks to promote the practice and learning of basic mathematics, allowing to practice arithmetic operations. It is intended primarily for elementary school students of educational institutions, but it's suitable for anybody who wants to exercise their maths.

Quest

Views

First page Login Signup Home Quest Results Profile History

Getting Started

Releases (Android)

In the Releases section, you will find APK file for download and installation. Since this installation is through an APK, Android will prompt an alert when attempting to install it. In that case, just proceed to install it.

Running Source code and Mount Backend

This is an optional guide to use the login and signup features, as well as saaving your progress in the backend. However, you can avoid this by selecting the Guest Mode in the app login screen (your progress will be saved locally).

Prerrequisites

Steps

Mounting the backend means running a server-side application that this app uses for both sign up and login. That is the Authentication Server, a dockerized application.

Even though you can host the Authentication Server anywhere, you can follow the next steps to host it temporarily in Play with Docker for simplicity:

  1. Clone this repository.

    git clone https://github.com/leovergaramarq/sum-plus.git

  2. Install the necessary dependencies (run in the project root folder).

    flutter pub get

  3. Go to Play with Docker.

Play with Docker image

  1. Create an account in DockerHub if you don't have one, and sign in with this account.

  2. Start.

Play with Docker image
  1. Create an instance.
Play with Docker image
  1. Run these commands in the terminal.
git clone https://github.com/augustosalazar/p_auth_server.git

docker build --tag authi p_auth_server

docker run -d -it -p 8000:8000 authi
Play with Docker image
  1. Select port 8000 or "OPEN PORT" for a custom port. A new tab will open.
Play with Docker image
  1. In the opened tab, copy the URL.
Play with Docker image
  1. Go to the file /lib/data/repositories/auth_authserver_repository.dart and replace the URL in variable _baseUrl (approximately line 11) with the copied value in the previous step. Make sure not to put the final slash (/).
Replacing _baseUrl

  1. Run the app with your preferred development environment (Android Studio, Visual Studio Code, etc.) or with the command (run in the project root folder):

    flutter run

Acknowledgements