shopping-assistant-mobile-client

Cross platform mobile client application for Shopping Assistant that utilizes Natural Language Processing (NLP) technology to interpret user queries for products and gifts. Users interact through a chat-style interface to communicate their shopping requirements.

Features
Stack
Installation
- Prerequisites
- Setup Instructions
Configuration

Features

Cross-platform mobile app built with Flutter.
Chat-style interface for natural language queries related to shopping.
Integration with NLP technology to understand user product and gift requests.
Supports managing wishlists and personal product selections.
Product browsing with images, ratings, prices, and descriptions.
Cart management of selected products.
Account login and authentication.
Real-time event stream handling for search and product suggestions.
Supports adding products to personal wishlists.
Supports iOS and Android platforms with native configurations.

Stack

Dart & Flutter (UI framework for cross-platform mobile development)
GraphQL (queries and mutations via graphql_flutter)
HTTP networking with http package
JWT token management with jwt_decoder
State management and UI with Flutter
Local storage using shared_preferences
Native Android code: Kotlin
Native iOS code: Swift and Objective-C bridging header
Image caching with cached_network_image
UI icons and graphics in SVG format

Installation

Prerequisites

Flutter SDK installed (stable channel recommended)
Dart SDK included with Flutter
Android Studio or Xcode for respective platform builds
Android device or emulator / iOS device or simulator
CocoaPods installed (for iOS dependencies)

Setup Instructions

Clone the repository:

git clone https://github.com/Shchoholiev/shopping-assistant-mobile-client.git
cd shopping-assistant-mobile-client

Get Flutter dependencies:
```
flutter pub get
```
iOS setup (from root project folder):
```
cd ios
pod install
cd ..
```
Run on Android:
```
flutter run -d android
```
Run on iOS:
```
flutter run -d ios
```
For building release versions, follow Flutter's platform-specific deployment guidelines.

Configuration

This app uses environment-specific API base URLs set internally. Consider modifying the base URL in lib/network/api_client.dart if needed.
Authentication tokens are managed and cached via shared_preferences.
No explicit environment variable files are required; sensitive data such as API keys or tokens should be managed securely and injected at runtime if applicable.
Android Manifest and iOS Info.plist include Internet permission by default.

Please ensure your development environment matches versions compatible with the dependencies listed in pubspec.yaml and platform configurations in the android and ios folders.

3.0 KiB Raw Permalink Blame History