Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cypher-o/latana
https://github.com/cypher-o/latana
Last synced: 24 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/cypher-o/latana
- Owner: Cypher-O
- Created: 2024-09-13T11:09:52.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2024-09-13T21:10:03.000Z (3 months ago)
- Last Synced: 2024-09-15T03:27:53.390Z (3 months ago)
- Language: Dart
- Size: 709 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Flutter Latana Assessment App
Latana is a mobile fitness application built using Flutter, designed to enhance user engagement through personalized learning content and fitness challenges. The app features a smooth login experience and a dynamic home page where users can access various fitness activities and challenges with a clean and intuitive interface.
## Features
- User Authentication secure (Login and Registration) for personalized access
- Dynamic Home Page: Showcases fitness challenges, learning sections, and progress tracking.
- Custom Widgets: Reusable components for buttons, text, and input fields tailored for a fitness theme.
- Exercise Tracking: Users can view and select various exercises and challenges.
- Clean and modern UI design
- Responsive layout for various screen sizes
- Efficient state management## Prerequisites
Before you begin, ensure you have met the following requirements:
- Flutter SDK (version 2.0 or higher)
- Dart SDK (version 2.12 or higher)
- Android Studio / VS Code with Flutter extensions
- An Android or iOS device/emulator for testing## Tools used in building
- Flutter `v3.24.0` - Mobile SDK for building natively compiled applications.
- cupertino_icons `^1.0.6` - Provides iOS-style icons for the app.
- stacked `^3.4.3` - State management solution that simplifies the architecture.
- stacked_services `^1.5.0` - Service locator for managing dependencies.
- flutter_svg `^2.0.10` - SVG rendering for scalable vector graphics in the app.
- build_runner `^2.4.8` - Code generation tool.
- stacked_generator `^1.5.3` - Code generation for the Stacked architecture.## Installation
1. Clone the repository:
git clone2. Navigate to the project directory:
cd latana3. Get the dependencies:
flutter pub get4. Run the app:
flutter run## Usage
1. **Login Page**: Start at the login screen to enter user credentials.
2. **Home Page**: After logging in, users can explore fitness challenges, continue learning sections, and engage with interactive exercise icons.## Running Tests
To run the unit and widget tests for this project:
1. Ensure you're in the project root directory.
2. Run the following command:
flutter testThis will execute all the tests in the `test/` directory.
## Contributing
Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
Here's how you can contribute:
1. Fork the repository.
2. Create a new branch: `git checkout -b feature-branch-name`.
3. Make your changes and commit them: `git commit -m 'Add some feature'`.
4. Push to the branch: `git push origin feature-branch-name`.
5. Create a pull request.Please make sure to update tests as appropriate and adhere to the existing coding style.
## Acknowledgments
- Flutter and Dart teams for providing an excellent framework and language.
- Contributors and open-source projects that inspired this app.## App Screenshots
| ![Login Screen](/assets/screenshots/login.png) | ![Home Screen](/assets/screenshots/home.png) |
|:--:|:--:|
| Login Screen | Home Screen |## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contact
If you have any questions, feel free to reach out to [Olumide Awodeji] at [[email protected]].
## APK Download URL
[Latana Assessment App Download](https://latana-v1.s3.us-east-2.amazonaws.com/latana.apk)