Marketo

🚀 Project Overview

Marketo delivers a seamless Flutter application tailored for users, enhancing their shopping experience. Designed to integrate with Shopify, it provides a clean and efficient platform for browsing and purchasing products directly from your Shopify store.

E-Commerce Ready

Complete shopping experience
Product browsing & search
Cart management
Order tracking

Shopify Powered

Direct Shopify integration
Real-time product sync
Secure checkout process
Inventory management

Flutter Built

Cross-platform compatibility
Native performance
Beautiful UI/UX
Responsive design

App Screenshots

Welcome Screen

Product Collection

Product Preview

Shopping Cart

App Interface

Product Details

Category View

Search Results

User Profile

Code Structure

🛍️ Shopify Integration

Quick Setup Guide

Create Shopify App

Navigate to Settings → Apps → App Development → Create an App

Generate Tokens

Create Admin API and Storefront API access tokens

Set Permissions

Configure read/write permissions for products and collections

Configure App

Update GraphQL configuration with your tokens

API Token Comparison

Token Type	Admin API Token	Storefront API Token
Usage	Backend operations (REST/GraphQL)	Frontend customer interactions (GraphQL)
Header	X-Shopify-Access-Token	X-Shopify-Storefront-Access-Token
Access Level	Full store management	Limited to storefront data

                     Required Permissions
                    read_products - View product information
write_products - Manage product data
read_collections - Access product collections
write_collections - Manage collections

                

✨ App Features

Product Discovery

Browse by main categories
Search products by name
Filter by attributes
View "Limited Quantity" items
Explore "New Arrivals"

Personalized Experience

Categorized product browsing
Personalized recommendations
Browsing history tracking
Special offers & deals

Shopping Features

Detailed product pages
Product variants support
Shopping cart management
Coupon application
Order tracking

Key App Screens

🏠 Home Screen

📂 Category Browse

🔍 Product Search

📱 Product Details

🛒 Shopping Cart

💳 Shopify Checkout

📋 Order History

👤 Account Management

                     Order Processing Flow
                    Product selection with variant options
Shopping cart management
Coupon application
Shipping information collection
Order confirmation with unique ID
Real-time status tracking

                

⚙️ Technical Specifications

Multilingual Support

Arabic (ar)
English (en)
Easy to add more languages

Flutter Dependencies

graphql_flutter - Shopify GraphQL
flutter_inappwebview - Checkout
easy_localization - Multi-language
flutter_bloc - State management
cached_network_image - Images
hive - Local storage

Shopify Requirements

Active Shopify store
API access enabled
Admin & Storefront tokens
GraphQL configuration
Product permissions

📥 Installation Guide

Prerequisites

Flutter SDK installed (Flutter.dev)
VS Code or Android Studio
Android emulator or physical device
Active Shopify store with API access

Quick Start

                    # Clone the repository
                    git clone [repository-url]

                    # Navigate to project directory
                    cd marketo_shopify

                    # Install dependencies
                    flutter pub get

                    # Run the app
                    flutter run
                

Download & Extract

Extract the project files to your desired location

Install Dependencies

Run flutter pub get in the project directory

Configure Shopify