Getting Started

Setting up your development environment for Irion BNPL.

Prerequisites

Before interacting with Irion, ensure you have the following:

  • Algorand Wallet: Pera Wallet or Defly connected to Testnet.
  • Node.js: Version 20 or higher.
  • USDC Opt-in: Your wallet must be opted-in to Asset ID 758823248.

Local Development (Monorepo)

The Irion framework is organized as a monorepo. To run the full stack locally:

1. Clone the Repository

git clone https://github.com/nickthelegend/irion-core.git
cd irion-core

2. Environment Configuration

Copy the .env.example files in the core, shopping, and merchant apps:

cp .env.example .env.local

3. Install Dependencies

npm install

4. Launch the Suite

We recommend running the apps in separate terminals:

# Terminal 1: User Dashboard
cd irion-core && npm run dev

# Terminal 2: Shopping App
cd irion-shopping-app && npm run dev

# Terminal 3: Merchant App
cd irion-merchant-app && npm run dev

Obtaining Test Tokens

If you are on Testnet, you can use our built-in Faucet to receive some Mock USDC (iUSDC) and ALGOs for gas:

  1. Connect your wallet to Irion Core.
  2. Navigate to the Faucet section.
  3. Opt-in to the iUSDC asset.
  4. Request tokens.

[!TIP] Use the Loro Explorer to track your on-chain transactions and credit score updates in real-time.