Complete Borrow App

BorrowApp composes the complete SatsTerminal borrowing journey into one framework-agnostic application. It includes loan creation, offer selection, workflow tracking, loan history, focused management views, repayment, collateral withdrawal, and platform-wallet EVM withdrawal. No application routes are required. Selecting, tracking, or creating a loan opens a focused view controlled by URL search parameters.

Install

npx shadcn@latest add https://ui.satsterminal.com/r/borrow-app.json

This single command installs every supporting SatsTerminal block and required shadcn primitive automatically.

BorrowApp requires @satsterminal-sdk/borrow 1.7.3 or later.

Render

"use client";

import { BorrowApp } from "@/components/borrow-app";

export function BorrowPage() {
  return <BorrowApp apiKey={process.env.NEXT_PUBLIC_SATSTERMINAL_API_KEY!} />;
}

BorrowApp includes a minimal UniSat connector, owns the BorrowProvider, restores the extension account and SDK session, and starts a fresh SDK session only when restoration is unavailable. No wallet package is required. Applications that already manage a wallet can pass their own SDK-compatible wallet prop; doing so bypasses the built-in UniSat connection screen.

Included flow

The installed app composes:

LoanComposer and AvailableOffers
Resumable BorrowFlow
UserLoans
LoanManagement for Deposit more and Borrow more
RepayLoan
WithdrawCollateral
WalletWithdrawal for EVM platform-wallet transfers
PlatformWalletAddress in the application header

Focused loan pages

BorrowApp starts on a dashboard containing the composer, offers, history, and wallet withdrawal. Creating a loan or selecting an existing loan switches to a focused transaction view instead of stacking management components below the dashboard. The selected view is stored in namespaced stBorrow* URL search parameters using the browser History API. Refreshing preserves the current transaction, browser Back returns to the dashboard, and the component remains framework-agnostic—no Next.js or React Router dependency is required.

Props

Prop	Type	Purpose
`apiKey`	`string`	Required SatsTerminal API key unless `sdkOverride` is supplied
`wallet`	`WalletProvider`	Optional external Bitcoin adapter; bypasses built-in UniSat connection
`sdkConfig`	`Omit<BorrowSDKConfig, "apiKey" \| "wallet">`	Optional overrides for the SDK configuration
`sdkOverride`	`BorrowSDK`	Alternative pre-built SDK instance for tests or advanced integrations
`destinationAddress`	`string`	Optional payout override passed to loan execution
`defaultBitcoinAddress`	`string`	Default destination for collateral withdrawal
`defaultEvmAddress`	`string`	Default destination for platform-wallet withdrawal
`autoRestore`	`boolean`	Restore persisted SDK sessions; defaults to `true`
`autoStart`	`boolean`	Initialize a session when restoration fails; defaults to `true`
`title`	`string`	Application header title
`accountLabel`	`string`	Connected-wallet label shown in the header
`onDisconnect`	`() => void`	Optional callback after built-in disconnect, or external disconnect action
`onLoanSelected`	`(loan) => void`	Observe a loan being opened from history

Atomic components

Use the individual registry blocks instead when you need custom routing or a different layout. BorrowApp installs the same editable source components; it does not introduce a separate closed component system.

Overview

Suite

UI Components

Swaps

Borrow

Bridge

Earn

Complete Borrow App

Complete Borrow App

Install

Render

Included flow

Focused loan pages

Props

Atomic components

​Complete Borrow App

​Install

​Render

​Included flow

​Focused loan pages

​Props

​Atomic components

Complete Borrow App

Install

Render

Included flow

Focused loan pages

Props

Atomic components