Practical overview
When it fits
Use Shoesafari to shop for footwear when Stellar wallet checkout is relevant, or consult its repository when studying a storefront integrated with Soroban escrow.
Who it is for
- Shoppers who want to order footwear using Stellar USDC and a Freighter wallet.
- Developers examining or adapting a web storefront with Stellar and Soroban payment integration.
Documented uses
- Browse footwear and place an order through an online storefront.
- Pay for an order from a Freighter wallet using USDC on Stellar.
- Inspect an escrow-based checkout implementation that records orders and supports payment release or refund.
Requirements & limits
The repository documents a live storefront and a separate testnet development flow. Its Stellar payment stage requires a deployed checkout contract ID in local configuration.
- Checkout uses Freighter and a Stellar transaction rather than a conventional card-only flow.
- The documented contract holds payment in escrow until dispatch or refund.
- The repository identifies the storefront as Next.js 14 and the checkout contract as Rust with Soroban SDK 27.
- The project is MIT-licensed and its storefront and Stellar integration are described as open source.
- Testnet instructions are for development and are separate from live purchases.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up Shoesafari locally
Configure the storefront for local development and open its home page.
Before you start
- The Shoesafari repository
- Node.js and npm
- Values for the existing Firebase/Mongo configuration used by the app
Steps
Clone the repository and change into its directory.
Install dependencies with the command below.
npm installCopy
.env.local.exampleto.env.localand fill in the required values. For the documented Stellar-only testnet configuration, setNEXT_PUBLIC_STELLAR_NETWORK=testnetand provide a checkout contract ID when available.Run the command below and open
http://localhost:3000.npm run dev
Expected outcome
The local storefront home page is available; the documented checkout path is reached by adding an item to the cart and visiting checkout.
Guide limitations
- Without a deployed checkout contract ID, the Stellar payment stage remains disabled.
- The README's testnet configuration is for development; testnet is separate from live purchases.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- ShoeSafari-Org/ShoeSafari · Official homepage title · retained in its source language
Related options
A different online retail niche — The project identifies adapting its catalog and checkout for another niche as a likely-compatible direction, while noting that customization details are not demonstrated.

