LiquiFact Frontend

Live

• Website: https://liquifact-frontend.vercel.app
• Docs: https://liquifact-frontend.vercel.app/docs
• API: https://liquifact-backend.vercel.app (API docs: https://liquifact-backend.vercel.app/docs)
• Contract (testnet): CDQCKR2YU6IVQ4GYPBMXBPZ4FGFQB5H25AI7ZSETHS2CZ5ZRCWQDSO6P

Web app for LiquiFact, the invoice liquidity network on Stellar. SMEs list unpaid invoices and get paid today; investors fund them through a Soroban escrow contract and earn yield when the debtor settles.

Part of the LiquiFact stack: frontend (this repo) · backend (Express API) · contracts (Soroban).

Pages

Route	What it does
/	Landing page: product overview, live API stats, escrow contract
/marketplace	Invoices from the API with status filters
/marketplace/[id]	Invoice detail and funding form
/submit	Submit an invoice for financing
/docs	Product overview, architecture, usage guide, API and contract reference

If the API is unreachable the marketplace falls back to bundled demo data.

Development

Requires Node.js 20.9+.

npm ci
npm run dev      # http://localhost:3000
npm test         # unit tests (node:test)
npm run build

Configuration

All variables are optional (see .env.local.example):

Variable	Default
NEXT_PUBLIC_API_URL	https://liquifact-backend.vercel.app
NEXT_PUBLIC_CONTRACT_ID	CDQCKR2YU6IVQ4GYPBMXBPZ4FGFQB5H25AI7ZSETHS2CZ5ZRCWQDSO6P
NEXT_PUBLIC_STELLAR_NETWORK	testnet
NEXT_PUBLIC_SITE_URL	https://liquifact-frontend.vercel.app

Deployment

Deployed on Vercel (vercel deploy --prod). CI (.github/workflows/ci.yml) runs npm ci, npm test and npm run build on node 20 for every push to main and every pull request.

License

MIT — see LICENSE.