https://github.com/eberjohns/calc-z
Go-To Mobile Calculator for Data Analysis & Matrices, A Flutter-built mobile calculator app.
https://github.com/eberjohns/calc-z
calculator-app dart flutter-app
Last synced: 4 months ago
JSON representation
Go-To Mobile Calculator for Data Analysis & Matrices, A Flutter-built mobile calculator app.
- Host: GitHub
- URL: https://github.com/eberjohns/calc-z
- Owner: eberjohns
- License: mit
- Created: 2025-06-09T16:51:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T17:02:35.000Z (4 months ago)
- Last Synced: 2025-06-17T18:22:02.309Z (4 months ago)
- Topics: calculator-app, dart, flutter-app
- Language: C++
- Homepage:
- Size: 445 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Calc-Z
*(Note: App logo will be placed once designed!)*
**Calc-Z is a mobile calculator application built with Flutter, specifically designed for students and professionals in data-centric fields.** Say goodbye to scrambling for a laptop or complex spreadsheet software when you need to perform quick calculations on data lists or matrices. Calc-Z brings essential data manipulation capabilities right to your fingertips.
## 🚀 Features (Initial Scope)
Calc-Z aims to be your quick, on-the-go solution for data calculations. Here's what you can expect in the initial release:
* **Standard Calculator Functions:** All the basic arithmetic operations (`+`, `-`, `*`, `/`) you'd expect from a regular calculator.
* **Variable Lists (`var` button):**
* Define a variable (e.g., 'a', 'b', 'c') to represent a list of up to 20 numerical values.
* Input values one by one, ideal for quick problem-solving in class.
* Apply standard arithmetic formulas directly to these variable lists (e.g., `a^2`, `(a + 5) / 2`).
* Outputs will be presented as a list of results.
* **Built-in Functions (`fn` button):**
* Quickly perform common statistical operations on your variable lists like `sum()`, `mean()`, `median()`, `std_dev()`, `min()`, and `max()`.
* **Matrix Operations (`matrix` button):**
* Define matrices (e.g., 'A', 'B', 'C') by specifying rows and columns and populating elements.
* Perform fundamental matrix calculations:
* Scalar Multiplication (e.g., `2 * A`)
* Matrix Addition (`A + B`)
* Matrix Subtraction (`A - B`)
* Matrix Multiplication (`A * B`)
* Error handling for dimension mismatches.
* **Intuitive UI:** Clean and straightforward interface for easy navigation and formula input.
* **Error Handling:** Clear messages for invalid operations (e.g., division by zero, non-matching matrix dimensions).
## ✨ Why Calc-Z?
In academic settings, or even during quick analysis sessions, opening up a spreadsheet or a statistical package for simple operations on small datasets can be overkill and time-consuming. Calc-Z fills this gap by providing:
* **Portability:** Perform calculations anywhere, anytime, directly from your mobile device.
* **Efficiency:** Quickly input and process data lists or matrices without complex setup.
* **Focus:** Designed with the needs of data students and professionals in mind, simplifying common data tasks.
* **No Internet Required:** Once installed, perform calculations offline.
## 📱 Screenshots (Coming Soon!)
*(Once I have UI ready, this section will have actual screenshots of the app's key features: main calculator, variable input, matrix input, function menu, results display.)*
## 🛠️ Technologies Used
* **Flutter:** For cross-platform mobile development (iOS & Android).
* **Dart:** The programming language.
## 🤝 Contributing
We welcome contributions from the community! Whether it's bug reports, feature suggestions, or direct code contributions, your help is invaluable.
### How to Contribute:
1. **Fork the repository.**
2. **Clone your forked repository:**
```bash
git clone https://github.com/eberjohns/calc-z.git
```
3. **Navigate to the project directory:**
```bash
cd calc-z
```
4. **Install Flutter dependencies:**
```bash
flutter pub get
```
5. **Create a new branch for your feature or bug fix:**
```bash
git checkout -b feature/your-feature-name
# OR
git checkout -b bugfix/fix-description
```
6. **Make your changes.**
7. **Commit your changes:**
```bash
git commit -m "feat: Add new feature" # or "fix: Resolve bug"
```
8. **Push to your branch:**
```bash
git push origin feature/your-feature-name
```
9. **Open a Pull Request** on the main Calc-Z repository. Please describe your changes clearly.
### Reporting Issues:
If you find a bug or have a feature request, please open an issue on our [GitHub Issues page](https://github.com/eberjohns/calc-z/issues).
## 📄 License
This project is licensed under the **MIT License**. See the `LICENSE` file for more details.
## 📧 Contact
Have questions or want to get in touch? You can reach out to
[ Eber Johns C D / eberjohnspro@gmail.com / https://www.linkedin.com/in/eber-johns-c-d/ ].
---