Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bhatiachirag2002/gst_calculator_using_kotlin
https://github.com/bhatiachirag2002/gst_calculator_using_kotlin
android android-app calculator calculator-application gst-calculator kotlin
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/bhatiachirag2002/gst_calculator_using_kotlin
- Owner: bhatiachirag2002
- Created: 2024-08-20T06:01:55.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-08-20T07:22:49.000Z (3 months ago)
- Last Synced: 2024-10-10T14:43:44.634Z (about 1 month ago)
- Topics: android, android-app, calculator, calculator-application, gst-calculator, kotlin
- Language: Kotlin
- Homepage:
- Size: 863 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GST Calculator App
## Overview
The **GST Calculator** is an Android app built with Kotlin that not only calculates the Goods and Services Tax (GST) but also includes basic arithmetic operations like addition, subtraction, multiplication, and division. This app is designed for ease of use, providing quick and accurate calculations for both GST and general arithmetic operations, making it an essential tool for everyday use.
## Features
- **GST Calculation**: Calculate GST for any amount with just a few taps.
- **Basic Arithmetic Operations**: Perform addition, subtraction, multiplication, and division directly within the app.
- **GST Addition/Subtraction**: Easily add or subtract GST from an amount to get the net or gross value.
- **Multiple GST Slabs**: Supports various GST slabs (e.g., ,3%, 5%, 12%, 18%, 28%).
- **Net & Gross Amount Calculation**: Automatically calculate the net or gross amount based on the selected GST rate.
- **User-Friendly UI**: A clean, intuitive interface designed with Material Design principles.
## Technologies Used
- **Kotlin**: The programming language used for Android development.
- **Android SDK**: For building and running the app on Android devices.
- **XML**: Used for designing the user interface.
- **Material Design**: Ensures a modern and user-friendly experience.
## Screenshots
## Installation
To run the GST Calculator app on your device or emulator, follow these steps:
1. **Clone the repository:**
```bash
git clone https://github.com/bhatiachirag2002/gst_calculator_using_kotlin.git
```
2. **Open the project in Android Studio:**
- Launch Android Studio.
- Select `Open an existing Android Studio project`.
- Navigate to the cloned repository and select the project folder.
3. **Build the project:**
- Ensure you have the correct Android SDK installed.
- Build the project by clicking on the "Build" menu and selecting "Build Project".
4. **Run the app:**
- Connect an Android device or use an emulator.
- Click on the "Run" button to install and run the app.
## Usage
1. **Open the app** and enter the amount or values you need to calculate.
2. **Select the GST slab** or choose an arithmetic operation (add, subtract, multiply, divide).
3. **Calculate** to get the GST amount, total amount, or the result of your arithmetic operation.
4. Use the **GST addition/subtraction** feature to quickly calculate the net or gross amount with GST.
## Contributing
Contributions are welcome! If you have any suggestions or improvements, feel free to create a pull request or open an issue.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.