Skip to main content
RIDLY - React Native E-commerce Mobile App SDK
Services
BlogGitHub
Back to Documentation

On this page

OverviewArchitectureTech StackFeaturesAccessibilityInternationalizationUI ComponentsHooksPlatform AdaptersPlugin SystemTheme SystemTestingInstallationConfigurationFAQ
GitHub
Back to Documentation
Stablev1.0.2

RIDLY Mobile SDK

Open-source React Native framework for building premium e-commerce mobile applications

Overview

RIDLY Mobile SDK is an open-source React Native framework for building premium e-commerce mobile applications. It provides a complete solution with adapters for multiple e-commerce platforms, a powerful theming system, extensive plugin architecture, and full accessibility compliance (EAA 2025 & WCAG 2.1 AA).

Architecture

The SDK uses a Yarn Workspaces monorepo architecture with clear separation of concerns:

apps/Application implementations for different platforms
apps/magento/Magento 2 implementation (production-ready)
packages/core/@ridly/mobile-core - Core components, hooks, stores, and types
packages/adapter-magento/@ridly/adapter-magento - Magento 2 GraphQL adapter
themes/luxe/
RIDLY

Free SDK. Custom development. Ready solutions for e-commerce.

SDK

  • GitHub
  • Documentation
  • Features

Resources

  • Blog
  • Services
  • Accessibility
  • Contact
  • Support

Connect

  • LinkedIn
© 2026 RIDLY. All rights reserved.·Lviv, Ukraine
AboutOfferRefundPrivacyTermsLicenseCookies
@ridly/theme-luxe - Premium luxury theme
plugins/Optional premium plugins (auth, search, payments)
e2e/Detox E2E test suites (13 test flows)

Tech Stack

•React Native 0.81.5—Cross-platform mobile
•Expo ~52.0.0—Development platform
•React 19.1.0—UI component library
•Expo Router—File-based navigation
•TypeScript 5.3+—Type-safe development
•Zustand 4.5.0—Lightweight state stores
•TanStack Query 5.0—Server state management
•React Hook Form 7.50—Form handling with Zod
•Detox 20.47.0—E2E testing

Core Features

Implemented

  • Multi-platform e-commerce adapters (Magento 2 production)
  • Slot-based theming system with light/dark mode
  • 11 premium plugins (auth, search, payments, offline)
  • Accessibility widget (EAA 2025 & WCAG 2.1 AA) — partial
  • Internationalization with 5 languages (EN, UK, DE, FR, ES)
  • Multi-currency support (EUR, USD, GBP, UAH, PLN) — partial
  • Detox E2E testing (13 test suites)
  • Product comparison and recently viewed
  • Order history with status tracking
  • Guest and customer checkout
  • Apple Pay & Google Pay via Stripe
  • Barcode & QR code scanner

Planned

  • Shopify Storefront GraphQL adapter
  • Shopware 6 Store API adapter
  • WooCommerce REST API adapter

Accessibility (EAA 2025)

RIDLY Mobile includes a comprehensive accessibility widget compliant with European Accessibility Act 2025 and WCAG 2.1 AA standards.

Vision

  • Font Size (50-200%)
  • Letter/Line Spacing
  • Dyslexia Font

Colors

  • High Contrast
  • Saturation Control
  • Color Blind Modes

Navigation

  • Focus Highlight
  • Big Cursor
  • Keyboard Navigation

Content

  • Hide Images
  • Mute Sounds
  • Reading Mask

Cognitive

  • ADHD Mode
  • Reading Guide
  • Text Alignment
Visually ImpairedColor BlindDyslexia FriendlyADHD FriendlyCognitive Disability

Internationalization

Complete internationalization system with translations, number/date formatting, and RTL support.

Languages

EN - EnglishUK - UkrainianDE - GermanFR - FrenchES - Spanish

Currencies

EUR €USD $GBP £UAH ₴PLN zł

UI Components

Ready-to-use components with full customization:

Button

Variants: primary, secondary, outline, ghost, danger. Sizes: sm, md, lg. States: loading, disabled

Text

Typography variants: h1-h4, body, caption, label, price. Custom weight and alignment

Input

Types: text, email, password, phone, search. Error states and helper text

Card

Variants: elevated, outlined, filled. Customizable padding

Badge

Variants: default, status, discount, count. Pill and outline styles

Price

Currency formatting, sale prices, price ranges

Skeleton

Loading placeholders for text, cards, images

Toast

Notifications: success, error, warning, info. Configurable position and duration

Hooks

React hooks for all e-commerce operations:

useAdapter()Access the active e-commerce adapter
useAuth()Authentication: login, logout, register, isAuthenticated
useCart()Cart: items, addItem, removeItem, updateQuantity, applyCoupon
useCheckout()Checkout flow: addresses, shipping, payment, placeOrder
useProducts()Product list with filters, sorting, pagination
useProduct()Single product with reviews and related items
useCategories()Category tree and navigation
useSearch()Product search with suggestions
useWishlist()Saved items management
useOrders()Order history
useConfig()App configuration and theme

Platform Adapters

The SDK uses an adapter pattern for e-commerce backends. Each adapter implements 50+ methods:

Magento 2 / Adobe Commerce

Stable

Full GraphQL API support (40+ methods)

Shopware 6

Planned

Store API integration

WooCommerce

Planned

REST API integration

Adapter Methods

  • Products: getProducts, getProduct, searchProducts, getRelatedProducts
  • Categories: getCategoryTree, getCategory, getCategories
  • Cart: createCart, getCart, addToCart, updateCartItem, removeCartItem, applyCoupon
  • Auth: login, register, logout, refreshToken, requestPasswordReset
  • Customer: getCustomer, updateCustomer, getAddresses, addAddress
  • Checkout: setShippingAddress, getShippingMethods, setPaymentMethod, placeOrder
  • Orders: getOrders, getOrder, reorder
  • CMS: getCmsPage, getCmsBlocks

Plugin System

RIDLY Mobile includes a modular plugin system for extending functionality:

Algolia Search

AI-powered instant search with Algolia

createAlgoliaSearchPlugin

Klevu Search

AI-powered search with Klevu

createKlevuSearchPlugin

Google Sign-In

Social login with Google OAuth

createGoogleAuthPlugin

Apple Sign-In

Native Apple authentication

createAppleAuthPlugin

Facebook Login

Social login with Facebook

createFacebookAuthPlugin

Apple Pay

Apple Pay integration via Stripe

createApplePayPlugin

Google Pay

Google Pay integration via Stripe

createGooglePayPlugin

Push Notifications

Firebase Cloud Messaging

createPushNotificationsPlugin

Barcode Scanner

Camera-based barcode/QR scanning

createBarcodeScannerPlugin

Offline Mode

Data caching and offline queue

createOfflineModePlugin

Trustpilot

Trustpilot reviews integration

createTrustpilotPlugin

Theme System

Slot-based theming with design tokens and light/dark mode support:

Theme Tokens

Colors

primary, secondary, accent, background, surface, text, error, success, warning

Border Radius

small, medium, large, button, card, image

Spacing

screenPadding, cardPadding, sectionGap

Typography

fontFamily, baseFontSize, headingWeight, bodyWeight

// theme.ts
export const theme = {
  colors: {
    primary: '#3B82F6',
    secondary: '#10B981',
    background: '#0F172A',
    surface: '#1E293B',
    text: '#F8FAFC',
    error: '#EF4444',
    success: '#22C55E',
  },
  borderRadius: {
    small: 4,
    medium: 8,
    large: 16,
    button: 8,
    card: 12,
  },
  spacing: {
    screenPadding: 16,
    cardPadding: 12,
    sectionGap: 24,
  },
  typography: {
    fontFamily: 'System',
    baseFontSize: 16,
    headingWeight: '700',
    bodyWeight: '400',
  },
}

E2E Testing

Detox E2E testing infrastructure with 13 test suites:

smoke - Basic app launch and navigation
auth - Login, registration, logout flows
catalog - Product browsing and categories
cart - Add to cart, update, remove items
checkout - Full checkout with address form
wishlist - Add/remove wishlist items
compare - Product comparison
orders - Order history and details
settings - Settings screen
accessibility - Accessibility features
multicurrency - Currency switching
offline - Offline mode functionality
premium-features - Theme, Algolia, scanner

Installation

Requirements

  • Node.js 18+
  • Yarn 4+
  • Expo CLI
  • iOS Simulator (Mac) or Android Studio
# Clone repository (SDK - open source)
git clone https://github.com/rtsehynka/ridly-mobile-sdk.git

# Clone repository (Pro - licensed)
git clone https://github.com/rtsehynka/ridly-mobile.git

cd ridly-mobile

# Install dependencies
yarn install

# Start demo app
yarn dev

# Build packages
yarn build

# Type check
yarn typecheck

Configuration

All settings are defined in ridly.config.ts:

storePlatform, API URL, store code
themeColors, typography, spacing, dark mode
featuresEnable/disable wishlist, reviews, guest checkout
localizationLanguages, currency, RTL support
checkoutRequired fields, default country
navigationTabs, drawer configuration
homeBanner, categories, featured products sections

FAQ

What platforms are supported?

iOS 14+ and Android 8+

What e-commerce backends work?

Currently Magento 2 / Adobe Commerce. Shopware 6 and WooCommerce are planned.

Can I customize components?

Yes, use the ComponentRegistry for style overrides or create your own components.

Is Expo required?

Yes, the SDK is built on Expo for easier development and deployment.

Is it production ready?

The core SDK and Magento adapter are stable. Some Pro features are in development.

Get Started

View on GitHubContact Us