saegl5 / check_student_loans_ios

Native iOS app of an experimental study

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Alt

Native App

Check your student loans' length of repayment and amount of savings.

This project is a native iOS app that is one of two parts of an experimental study—the other part being course material, and it is designed to supplement the course material. The combination of both parts is dubbed an instructional app. Users select an estimated cost, select the interest rate of their loan(s), and select a monthly payment. The app will estimate how long repayments will take and how much users can save by paying more than the minimum. It can perform such estimates for realistic and hypothetical situations. (This app will not tell you how much money you have loaned. Contact your school's bursar office for that information. Once you have that information, use this app.)

Features:

  • Automatic estimation
  • Customization
  • Swipe leftward (if enabled) to view how estimates were calculated.
  • Swipe leftward (if enabled) to examine how estimates would vary, depending if interest were compounded and on the percentage of interest users paid monthly.

It is designed for iPhone 7. Compatible with iPhone 6/6 Plus, 6s/6s Plus, 7 Plus, 8/8 Plus or later, but not iPhone SE or below
Not designed for iPad devices

Alt
(Version 2.3.1) Removed on March 24, 2019

Alternative downloads:
Version 2.2.2 Beta for Panel Discussion*  :white_check_mark:[No malware detected]
Version 2.2.2 Beta - Summative Copy*  :white_check_mark:[No malware detected]
Version 2.7.3 - Latest (Sep 20, 2019)  :white_check_mark:[No malware detected]

* identical

Install alternative downloads using iTunes or Apple Configurator on iPhone devices.

Build from Source Code

Get Xcode from the App Store, and install it.

Also, download and install Git.

Open the Terminal, and clone the project:

git clone https://gitlab.com/check-student-loans/ios.git

(Recommended) Verify the project's authenticity: Look upward for "Verified," next to the commit SHA.

(Recommended) Open the Terminal, and verify the project's integrity:

cd ios
git show-ref --heads --hash

Check that the hash matches the commit SHA.

Open the project in Xcode, and build the native app:

  • For a virtual or connected iPhone device, select Product > Build.
  • Otherwise, select Product > Archive > Distribute App; select a method of distribution; and follow the prompts. If this fails, consult this answer on how to export IPA files manually, the original response.

Usage

Under Product, choose a Destination (e.g., iPhone 7 or a connected device), and click Run.
Or, install the IPA file using iTunes or Apple Configurator on a user's own iPhone device.

Move the slider's thumb, to select an estimated cost nearest to yours.
Press ▼ to select the interest rate of your loan.
Press − or + to select a monthly payment nearest to yours.

To edit the slider, interest rate, monthly payment or minimum, or to enable swiping leftward, press on the padlock icon.
After editing them or enabling swiping, relock.

Known to work in Xcode 11.1 using Swift 4.2

(You can test the native app's calculations against this spreadsheet.)

Contributing

Sign into GitLab, to fork the project.

Modify the source code.
Stage, commit and push the changes.

Return to GitLab, and submit a new pull request.
To report any issues, submit a new issue or discuss an existing one.

(For instructions on how to export a new video introduction, consult the README in this directory.)

History

Oct 31, 2019: enhanced accessibility
Sep 25, 2019: unified author name and email of all commits
Sep 20, 2019 · Version 2.7.3: corrected location of video file because its location had moved
Sep 17, 2019: starting signing commits, signed and re-committed old ones, inadvertently lost empty commits but they were empty anyway
Aug 27, 2019 · Version 2.7.2: updated interest rate, fixed issue in which savings was rounded before change in savings was calculated
Aug 26, 2019 · Version 2.7.1: fixed issue in which maximum payments changed with percentages of interest payments
Aug 24, 2019 · Version 2.7: changed default minimum to ten-year minimum, highlighted option in source code to revert the default minimum, fixed appending final balances to balance arrays, reverted test that forgot to revert, corrected error in which remainders of total paid and savings might display three digits, corrected error in which final balance in table often displayed a negative zero since last version
Aug 21, 2019 · Version 2.6.3: corrected rounding errors involving change in savings, decided to exit beta
Aug 16, 2019 · Version 2.6.2: fixed issue in which annual and monthly interest rates in "showmath" view controller displayed incorrectly for unusually small or large rates, and fixed a crash when minimizing the monthly payment for ten-year minimum and paying only principal
Aug 5, 2019 · Version 2.6.1: integrated checking and correcting for errors
Jul 18, 2019 · Version 2.6: added button to mathematics screen for minimizing monthly payment amount for any percentage of interest payment, revised video introduction
Feb 9, 2019 · Version 2.5.2: cleaned entire project, source code is 50% leaner, fixed issue where outstanding totals would not disappear if insight is closed, fixed issue where keyboard displayed after clicking on monthly balance boxes, fixed issue where users could paste text into monthly balances
Jan 16, 2019 · Version 2.5.1: upgraded codebase, fixed video introduction close button, hid status bar when video introduction controls are displayed, fixed edit pay monthly box from dropping to bottom of view controller, displayed alert if device is incompatible with app, addressed warnings
Oct 12, 2018: refreshed entire project but inadvertently purged commit history
Oct 1, 2018 · Version 2.4: permitted users to revert developments, fixed issue where coffee cup displays even though users must pay extra, fixed issue where text in remaining balance column is misaligned for greater monthly payments, fixed issue where text colors in remaining balance did not return after closing breakdown of pay, fixed text color of dots for remaining balance
May 27, 2018 · Version 2.3.2: corrected maturity rating, fulfilled conditions of SIL Open Font License
Mar 24, 2018 · Version 2.3.1: added key to Info.plist, added license
Mar 17, 2018 · Version 2.3: initial commit

Known Issues

Video introduction does not render correctly, if installed from the App Store.
Potential Xcode bug: Unlike for plain text, for attributed text the interface builder draws custom fonts from Font Book.
iOS updates may have broken swiping back to the main screen.

License

MIT

Copyright (c) 2018-2020 Ed Silkworth

About

Native iOS app of an experimental study

License:MIT License


Languages

Language:Swift 100.0%