Providers
Guide to setting up necessary providers and obtaining their API keys.
In today’s world utilizing third-party providers is essential for building a robust e-commerce platform.
These providers can significantly reduce overhead and eliminate the need for redundant development efforts. Below, you will find a list of providers that integrate seamlessly with our system, enabling you to get started quickly while we keep adding more options.
You can also roll your own solution, for more information, please see Search and Platform Agnostic.
Below is the list of environment variables that you’ll need to configure in your .env.local
file for the proper setup of your enterprise commerce system:
SHOPIFY_STORE_DOMAIN=your_store_domain.myshopify.com
SHOPIFY_STOREFRONT_ACCESS_TOKEN=your_storefront_access_token
SHOPIFY_ADMIN_ACCESS_TOKEN=your_admin_access_token
SHOPIFY_APP_API_SECRET_KEY=your_app_api_key
MEILISEARCH_ADMIN_KEY=admin_key
MEILISEARCH_CATEGORIES_INDEX=categories
MEILISEARCH_PRODUCTS_INDEX=products
MEILISEARCH_HOST=https://something.meilisearch.io
LIVE_URL=https://commerce.blazity.com
FLAGS_SECRET=EAMwX-AhlPipEaZfTc-24bxAZ7BvLikwuIV2Zq7FP64 # change to your own
Replace values for each key with the actual value that you will obtain through the setup process described below.
Commerce Platform
Shopify
Shopify is a leading e-commerce platform that allows you to create and manage your online store with ease.
Keys to obtain:
SHOPIFY_STORE_DOMAIN
SHOPIFY_STOREFRONT_ACCESS_TOKEN
SHOPIFY_ADMIN_ACCESS_TOKEN
SHOPIFY_APP_API_SECRET_KEY
1. Shopify Store Domain
- Variable Required:
SHOPIFY_STORE_DOMAIN
- How to Obtain:
- Your Shopify store domain is the URL of your Shopify store. You can obtain it in shopify dashboard, it should be without
https
and/
at the end of the string. Example:cool-socks.myshopify.com
- Your Shopify store domain is the URL of your Shopify store. You can obtain it in shopify dashboard, it should be without
2. Headless App
- Variable Required:
SHOPIFY_STOREFRONT_ACCESS_TOKEN
- Installation and Configuration:
- Visit the Shopify Marketplace and search for the Headless commerce application or navigate directly to https://apps.shopify.com/headless.
- Install the application, open it, and create a new Storefront within the app.
- In the “Manage API Access” section, click on the
Manage
button next to Storefront API. - Make sure you have enabled
unauthenticated_read_product_inventory
andunauthenticated_read_customer_tags
scopes - Copy the Private access token displayed and place it in your
.env
file underSHOPIFY_STOREFRONT_ACCESS_TOKEN
.
3. Private Admin App
- Variables Required:
SHOPIFY_ADMIN_ACCESS_TOKEN
,SHOPIFY_APP_API_SECRET_KEY
- Application Setup and Scopes Configuration:
- Go to the Shopify admin dashboard, navigate to Settings >
Apps and sales channels
>Develop Apps
, and click onCreate app
. - After naming and creating your app, move to the
Configuration
tab. - In the “Admin API access scopes” section, click
Edit
and select the following scopes:write_product_listings
read_product_listings
read_products
write_products
- Under Webhook subscriptions, choose the
2024-01
API version. - Lastly, navigate to the
API Credentials
section.- Copy the Admin API access token and place it in your
.env.local
file underSHOPIFY_ADMIN_ACCESS_TOKEN
- Also, copy the
API secret key
and place it in your.env.local
file underSHOPIFY_APP_API_SECRET_KEY
- Copy the Admin API access token and place it in your
- Go to the Shopify admin dashboard, navigate to Settings >
Search & Merch
Meilisearch
Meilisearch is a powerful, fast, open-source search engine.
There are two main ways to host Meilisearch:
- on-premise (self-hosting on dedicated servers or cloud providers)
- using Meilisearch Cloud.
For the purposes of this guide, we will focus on the recommended approach, which is using Meilisearch Cloud.
Keys to obtain:
MEILISEARCH_PRODUCTS_INDEX
MEILISEARCH_CATEGORIES_INDEX
MEILISEARCH_ADMIN_KEY
MEILISEARCH_HOST
MEILISEARCH_REVIEWS_INDEX - only if you're using reviews feature
To get started with Meilisearch Cloud, navigate to the Meilisearch Cloud platform and log in.
- Create a new project within the platform.
- Create two indicies called
products
andcategories
. If you wish to use different names make sure your environment variablesMEILISEARCH_PRODUCTS_INDEX
andMEILISEARCH_CATEGORIES_INDEX
are updated accordingly. - After your project is set up, proceed to the “Settings” tab of your Meilisearch Cloud project.
- Locate and copy the
Default Admin API Key
. This key should be securely stored in your.env.local
file under theMEILISEARCH_ADMIN_KEY
variable. - Copy the Meilisearch URL and place it in your
.env.local
file underMEILISEARCH_HOST
. Ensure you do not include a trailing slash at the end of the URL. - Set up your indicies
Indicies setup
The last thing, but also crucial for application to work correctly is setting your Meilisearch index the right way.
Products index:
Filterable attributes:
- “hierarchicalCategories” only if you’re planning on using this feature
- “avgRating” only if you’re using reviews feature
[
"collections",
"collections.handle",
"collections.id",
"flatOptions",
"handle",
"minPrice",
"tags",
"variants.availableForSale",
"vendor",
"hierarchicalCategories",
"hierarchicalCategories.lvl0",
"hierarchicalCategories.lvl1",
"hierarchicalCategories.lvl2",
"avgRating"
]
Sortable attributes:
“avgRating” only if you’re using reviews feature
[
"minPrice",
"updatedAtTimestamp",
"avgRating"
]
Categories index:
Filterable attributes:
[
"handle",
"id"
]