https://github.com/asciencioalex/timbuproductviewer

The project involves creating a mobile app using Flutter that integrates with the Timbu API. The app retrieves and displays product information from a Timbu account, including names, descriptions, prices, quantities, statuses, and photos. The app features proper mobile architecture, UI state management, and error handling.
https://github.com/asciencioalex/timbuproductviewer

android api-service dart flutter hnginternship ios timbu-api

Last synced: about 2 months ago
JSON representation

The project involves creating a mobile app using Flutter that integrates with the Timbu API. The app retrieves and displays product information from a Timbu account, including names, descriptions, prices, quantities, statuses, and photos. The app features proper mobile architecture, UI state management, and error handling.

• Host: GitHub
• URL: https://github.com/asciencioalex/timbuproductviewer
• Owner: AsciencioAlex
• License: mit
• Created: 2024-07-08T10:40:29.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-07-19T20:08:56.000Z (6 months ago)
• Last Synced: 2024-08-23T22:15:02.845Z (5 months ago)
• Topics: android, api-service, dart, flutter, hnginternship, ios, timbu-api
• Language: Dart
• Homepage: https://appetize.io/app/android/com.example.timbu_api_app?device=pixel7&osVersion=13.0
• Size: 2.72 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  


  
Timbu Product Viewer README




# 📗 Table of Contents

- [📖 About the Project](#about-project)

  - [🛠 Built With](#built-with)

    - [Tech Stack](#tech-stack)

    - [Key Features](#key-features)

- [💻 Getting Started](#getting-started)

  - [Setup Instructions](#setup)

  - [Prerequisites](#prerequisites)

  - [Screenshots](#screenshots)

  - [APK Download link](#apk-download)

  - [Appetize showcase](#appetize-showcase)

- [👥 Authors](#authors)

- [🔭 Future Features](#future-features)

- [🤝 Contributing](#contributing)

- [⭐️ Show your support](#support)

- [🙏 Acknowledgements](#acknowledgements)

- [❓ FAQ ](#faq)

- [📝 License](#license)

# 📖 Timbu Product Viewer 

 **Timbu Product Viewer** is a mobile app that integrates with the Timbu API to display product information.

## 🛠 Built With 

### Tech Stack 

  Dart

  


    
Dart

  


  Flutter

  


    
Flutter

  


### Key Features 

- **Product Screen**

- **Checkout Screen**

- **Order Success Screen** 

(back to top)


## 💻 Getting Started 

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project, you need the following:

- Visual Studio Code IDE

- Flutter SDK

### Setup Instructions

1. Clone the repository: `git clone https://github.com/AsciencioAlex/TimbuProductViewer.git`

2. Navigate to the project directory: `cd TimbuProductViewer`

3. Run `flutter pub get` to install dependencies.

4. Run the app on an emulator or physical device: `flutter run`

### Screenshots

![Screenshot One](screenshots/screenshot_1.png)

![Screenshot Two](screenshots/screenshot_2.png)

### APK Download Link

[Download APK](https://drive.google.com/file/d/1k990OwzO2B3HMkR9C2uRiZtUX2VV_bHl/view?usp=drive_link)

### Appetize.io Showcase

[Appetize.io Demo](https://appetize.io/app/u37uj6zr2hu2ftu7ahszcjmg4a?device=pixel7&osVersion=13.0)

(back to top)


## 👥 Authors 

👤 **Alex Asciencio**

- GitHub: [@AsciencioAlex](https://github.com/AsciencioAlex)

- X: [@Codnetech](https://x.com/Codnetech)

- LinkedIn: [Alex Asciencio](https://ke.linkedin.com/in/alex-asciencio-413612b9)

- Medium: [@asciencioalex](https://medium.com/@asciencioalex)

(back to top)


## 🔭 Future Features 

- [ ] Additional pages for product categories

- [ ] Integration of multiple payment methods

- [ ] More features and widgets

(back to top)


## 🤝 Contributing 

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/AsciencioAlex/Mobile-finish-portfolio/issues).

(back to top)


## ⭐️ Show your support 

If you like this project, feel free to clone it and incorporate features that enhance your own projects.

(back to top)


## 🙏 Acknowledgements 

I thank HNG for this opportunity.

(back to top)


## ❓ FAQ 

- **Can I run the project without installing on the terminal?**

  - Yes, you can run it directly on the browser.

- **Can I build such a page from scratch and where can I learn?**

  - Yes, it's possible. Join [HNG Internship](https://hng.tech/internship/) and [HNG Tech](https://hng.tech/).

(back to top)


## 📝 License 

This project is [MIT](./LICENSE) licensed.

(back to top)