Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mahmoudelsayed7/tasbih
Flutter app for counting prayer beads with an easy interface, dark mode, and persistent data storage.
https://github.com/mahmoudelsayed7/tasbih
bloc counter cubit cubit-bloc donate-app flutter flutter-android flutter-apps flutter-bloc islamic sharedpreferences tasbih tasbih-digital-android
Last synced: 4 days ago
JSON representation
Flutter app for counting prayer beads with an easy interface, dark mode, and persistent data storage.
- Host: GitHub
- URL: https://github.com/mahmoudelsayed7/tasbih
- Owner: MAHMOUDELSAYED7
- Created: 2024-07-16T09:07:46.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-06T08:04:57.000Z (about 1 month ago)
- Last Synced: 2025-01-01T05:44:03.581Z (4 days ago)
- Topics: bloc, counter, cubit, cubit-bloc, donate-app, flutter, flutter-android, flutter-apps, flutter-bloc, islamic, sharedpreferences, tasbih, tasbih-digital-android
- Language: C++
- Homepage:
- Size: 2.82 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Tasbih
Tasbih Counter is a simple Flutter app that allows users to count their tasbih (prayer beads) conveniently. The app features an easy-to-use interface and operates exclusively in dark mode.
A new Flutter project.## Features
- **`Counter Functionality`**: Easily increment the counter.
- **`Reset Counter`**: Reset the counter to start a new counting session.
- **`Persistent Data`**: The counter state is saved even if the app is closed, allowing users to continue their count later.## Screenshots
## Installation
To get started with Tasbih, follow these steps:
**`Step 1:`** Clone the Repository
First, you'll need to clone the repository from GitHub. Open your terminal and run the following command:
```
https://github.com/MAHMOUDELSAYED7/Tasbih.git
```
Replace with the actual URL of your repository if it was changed.**`Step 2:`** Install Dependencies
After navigating to the project directory, you need to install all the necessary dependencies. Run:
```
flutter pub get
```
This command fetches all the dependencies listed in the `pubspec.yaml` file.**`Step 3:`** Configure the App
Ensure all necessary configurations are done. This includes adding your assets and setting up environment variables if needed. Verify that your `pubspec.yaml` file includes all required `assets` and `fonts`.**`Step 4:`** Run the Application
Finally, run the application on your desired device using the following command:
`
```
flutter run
```
This command compiles your Flutter app and deploys it to the connected device or simulator.Additional Tips
**`Updating Dependencies:`** If there are any updates to the dependencies, you can update them using:
```
flutter pub upgrade --major-versions
```
Flutter Doctor: Run flutter doctor to ensure that your development environment is set up correctly.
```
flutter doctor
```
This command checks your environment and displays a report of the status of your Flutter installation, dependencies, and connected devices.By following these steps, you'll have the Tasbih mobile app and running on your device. If you encounter any issues during installation, please refer to the Flutter documentation.
## Dependencies
This project uses the following dependencies:- **`bloc`**: State management library for Flutter apps.
- **`cupertino_icons`**: Icon set for iOS-styled Flutter apps.
- **`flutter`**: Flutter SDK for building cross-platform apps.
- **`flutter_bloc`**: Cubit and BLoC state management for Flutter.
- **`flutter_screenutil`**: Responsive UI design and adaptation for Flutter.
- **`shared_preferences`**: Persistent local storage for key-value pairs.
- **`url_launcher`**: Launch URLs from Flutter applications.## Dev Dependencies
- **`flutter_launcher_icons`**: Generate launcher icons for Flutter apps.
- **`flutter_lints`**: Official Dart code linter rules for Flutter.
- **`flutter_test`**: Testing framework and utilities for Flutter apps.## Usage
1. **`Increment Counter`**: Tap the increment button to increase the counter.
1. **`Reset Counter`**: Tap the reset button to reset the counter to zero.## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contact
For any questions or feedback, please reach out via email: [[email protected]]([email protected])