Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edwinabdonshayo/debts-handling-app
This project is a web-based application designed to help users manage their debts efficiently. The app includes a calculator, a debtor management system, and a language selection feature, allowing users to switch between English and Swahili.
https://github.com/edwinabdonshayo/debts-handling-app
css html javascript js webapp
Last synced: 1 day ago
JSON representation
This project is a web-based application designed to help users manage their debts efficiently. The app includes a calculator, a debtor management system, and a language selection feature, allowing users to switch between English and Swahili.
- Host: GitHub
- URL: https://github.com/edwinabdonshayo/debts-handling-app
- Owner: EdwinAbdonShayo
- Created: 2024-08-05T10:37:13.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-08-10T21:38:37.000Z (6 months ago)
- Last Synced: 2024-12-20T10:13:51.869Z (about 2 months ago)
- Topics: css, html, javascript, js, webapp
- Language: JavaScript
- Homepage: https://www.edwinshayo.com
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Debt Handling App
This project is a web-based application designed to help users manage their debts efficiently. The app includes a calculator, a debtor management system, and a language selection feature, allowing users to switch between English and Swahili.
## Features
- **Language Selection**: Users can switch the interface language between English and Swahili. The selected language is saved in the browser's local storage and persists across all pages.
- **Debt Management**: Users can view, add, and manage debtor records with details such as full name, type of debt, initial debt, paid amount, owing amount, currency, and dates.
- **Calculator**: A simple calculator is provided to assist users with debt-related calculations.
## Project Structure
The project is organized as follows:
Code/
│
├── index.html # Homepage with links to other pages and settings
├── calculator.html # Calculator page
├── debtors.html # Debtors management page
│
├── Styles/
│ ├── styles.css # General styling for index.html
│ ├── calculator.css # Specific styling for calculator.html
│ ├── debtors.css # Specific styling for debtors.html
│
└── Script/
├── script.js # Main script handling language selection and global features
├── calculator.js # Specific script for calculator.html
├── debtors.js # Specific script for debtors.html
## Getting Started
### Prerequisites
- A modern web browser (Google Chrome, Firefox, Safari, etc.)
- Git (optional, for version control and collaboration)
### Installation
1. **Clone the Repository**:
```bash
git clone https://github.com/EdwinAbdonShayo/debt-handling-app.git
```
2. **Navigate to the Project Directory**:
```bash
cd debt-handling-app
```
3. **Open the `index.html` File**:
You can open the `index.html` file directly in your web browser to start using the application.
### Usage
- **Language Selection**:
1. Click on the "Settings" link available on any page.
2. A popup will appear with a language dropdown.
3. Select either "English" or "Swahili" and click "Save".
4. The language preference will be saved, and the interface will update accordingly.
- **Calculator**:
1. Navigate to the Calculator page via the link on the homepage.
2. Use the on-screen buttons to perform basic arithmetic operations.
- **Managing Debtors**:
1. Navigate to the Debtors page via the link on the homepage.
2. View existing debtor records in the table.
3. Add a new record by clicking the "Add New Record" button.
## Contributing
Contributions are welcome! If you have any improvements or suggestions, feel free to reach out through the contacts below.
## Contact
- **Author**: Edwin Abdon Shayo
- **Website**: [edwinshayo.com](https://edwinshayo.com)
- **Email**: [[email protected]](mailto:[email protected])