Overview | SplitPay Docs

splitpay-web is the primary decentralized user interface for the SplitPay protocol, built as a modern full-stack Next.js 16 application utilizing the App Router.

No Legacy Backend Dependencies

The current SplitPay web application interacts directly with Stellar Soroban RPC and the on-chain smart contract. It does not use the deprecated Node.js backend or legacy Paystack payment processor from original prototypes.

Web App Architecture

The web application handles client-side wallet connection, transaction assembly, read-only simulation, and state polling:

textData Flow Architecture

Next.js 16 App Router UI (/pools, /payments, /wallet)
│
▼
lib/contract/splitpay.ts (Typed Soroban Contract Client)
├── Simulates read calls via Horizon / Soroban RPC
├── Assembles transaction footprint via @stellar/stellar-sdk
├── Signs with Freighter Extension (@stellar/freighter-api) or Dev Keypair
└── Submits signed XDR and polls for on-chain confirmation

Core Web Capabilities

Interactive Pool Builder: Create multi-recipient payment pools with real-time 10,000 basis points balance validation.
Live Split Preview Calculator: Preview member allocations and remainder distribution before committing a transaction on-chain.
Dual Wallet Provider: Native support for Freighter browser extension alongside instant, in-browser Testnet dev keypairs funded via Friendbot.
Explorer Deep Linking: Direct links to Stellar Expert Explorer for verified transaction hashes and contract footprints.

Modern Tech Stack

Next.js 16

App Router

React 19

Server & Client

Tailwind CSS v4

Brand Theme Tokens

Stellar SDK 13

Soroban RPC & XDR