Skip to main content
More in Learn

React Native eCommerce Boilerplate

This React Native Boilerplate gives you a head start when building a React Native e-commerce app for iOS and Android. You can have rich e-commerce content with the super structured PIM engine in Crystallize powering your product catalog.

This boilerplate is connected to the Crystallize API. By default, this React Native eCommerce boilerplate is connected to our demo tenant called “Furniture”. This is the same tenant being used in the JAMStack eCommerce Boilerplate using NextJS and shows re-use of product information and rich marketing content across Web and iOS and Android Apps.

You can also check out this boilerplate as a live eCommerce demo.

Introduction

This guide will walk you through how you can download and set up the react-native boilerplate using our CLI. Then we’ll go over how to run the app. At the moment we’ve only tested this on iOS but we’ll be doing it for Android soon.

Livestream demo

Getting started with React Native eCommerce

To get started with your own React Native eCommerce App you simply need to use our CLI. It will walk you through the process

npx @crystallize/cli my-project

Once you do that, you'll be greeted with this screen where you have the option to select our various boilerplates. But for the sake of this guide, we’ll go with React Native. Use the arrow keys to navigate to the bottom of the list. Once you find the React Native option press enter.

Then you’ll be asked to select a Crystallize Tenant. You can either choose our default tenant or you can create your own tenant by signing up on Crystallize.

After choosing your tenant you’ll be asked to enter a Service API URI, you can choose our default one or enter your own service API URI if you have one.

crystallize cli being used to download react native boilerplate

Running on iOS

To run the iOS app you need to have Xcode and Cocoapods installed. Once the CLI finishes the installation, navigate into your project using the terminal and run the following commands.

cd ios
pod install
cd ..

To run the app simply run the following command

npx react-native run-ios

react native posters demo

Configuring environment variables

To configure environment variables you can find the env file at the root of the project. Feel free to change them if you have a tenant and service API set up.

CRYSTALLIZE_TENANT_IDENTIFIER=furniture
SERVICE_API_URL=https://service-api-demo.superfast.shop/api/graphql

Next steps: Service API

In order to manage a fully operational eCommerce, you need to manage user authentication, basket validation, payment, and such.

For that, we have prepared a boilerplate for you, the Service API boilerplate, which you would want to add alongside your React Native project. Follow our guide for how to set it up.

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community