https://github.com/paraskuk/expenses-kotlin-android-app

Expenses Android App
https://github.com/paraskuk/expenses-kotlin-android-app

android-app kotlin kotlin-android

Last synced: about 1 month ago
JSON representation

Expenses Android App

• Host: GitHub
• URL: https://github.com/paraskuk/expenses-kotlin-android-app
• Owner: paraskuk
• Created: 2024-08-29T20:46:25.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-12-27T14:03:48.000Z (over 1 year ago)
• Last Synced: 2025-02-22T12:27:18.960Z (over 1 year ago)
• Topics: android-app, kotlin, kotlin-android
• Language: Kotlin
• Homepage:
• Size: 1.71 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Budget Tracker Android App

This is a simple budget tracker app for `Android`.

***

## Running Device

- Android Studio Emulator was used to run the app with model Launching 'Pixel Fold API 33'.

***

## Features

- Add expenses with details such as title, amount, date, and category.

- Edit existing expenses.

- View all expenses.

- View statistics on expenses, such as the most frequent category and total spending.

***

# Instructions for Using the app 

### Test the App 

- Run the Classes `ApplicationTestInstrumented` and `ExpenseDAOTest` that can be found in 

- app/src/androidTest/java/com/paras_test_android/assignment_paras to test the app functionality.

***

### Once Tests finish go to the app and execute main app on your virtual device on Android Studio

- Add expenses with details such as title, amount, date, and category.

- Then check the menu show expenses to see the expenses you have added.

- Then you can edit the expenses you have added.

- You can also view statistics on expenses, such as the most frequent category and total spending.

***

## App Menu

This is the main view of the App with two main menu options modalities:

![img.png](img.png)

- 1.Menu Options on top left corner as shown just above.

- 2.Menu Options on center of app as shown below

![img_6_menu.png](img_6_menu.png)

***

#### Add Expenses on List : Here user can add expenses one by one.

![img_1.png](img_1.png)

***

#### Show Expenses on List : Here user can view all the expenses added.

![img_2.png](img_2.png)

***

#### Edit Expenses on List : Here user will edit the expenses.

- The user can Delete All Expenses on the screen by pressing the  Delete All  button.

- A user can edit any element of the expense then press save button to save changes.

- To erase a specific expense , user needs to  erase all  the elements of a  specific  expense and then press the save button.

- User can also manually erase all the expenses on the same screen( e.g. with backspace) in one go and then press the save button to save changes.

![img_3.png](img_3.png)

***

#### Show Statistics on List : Here user can view the statistics of all expenses added.

- Show Statistics Button needs to be pressed to view the statistics.

![img_4.png](img_4.png)

![img_5.png](img_5.png)

***

### Exiting the App 

- User can exit the app by clicking on the exit button in the top left corner menu

![img_6_menu.png](img_6_menu.png)

***