Start Building

Quickstart

Run a minimal Truv integration end-to-end in Python, Ruby, Go, Node.js, or C#. Create a user, launch Bridge, receive a webhook, and fetch a report. Use this to verify your API keys work and understand the core flow before building anything.

Quickstart

Clone, configure, and run in minutes with Docker. Five languages available.

Demo apps

The demo-apps repo implements 12 real integration patterns across four verticals. Each makes live API calls, launches Bridge, receives webhooks, and fetches reports. Pick the demo that matches your use case and use it as a starting point.

Prerequisites

Node.js 18+
ngrok (free tier) for receiving webhooks locally
A Truv sandbox account

Setup

git clone https://github.com/truvhq/demo-apps.git
cd demo-apps
npm install
cp .env.example .env

Open .env and add your Truv API credentials:

API_CLIENT_ID=your_client_id
API_SECRET=your_secret

Start ngrok in a separate terminal to receive webhooks:

ngrok http 3000

Copy the https://...ngrok-free.dev URL into .env:

NGROK_URL=https://your-tunnel.ngrok-free.dev

Run the app:

npm start        # Express server on :3000
npm run dev      # Vite dev server on :5173

Open http://localhost:5173 and pick a demo.

Choose a demo

Vertical	Demo	Pattern	Products
Mortgage	POS Application	Embedded Orders	VOIE, VOA
Mortgage	POS Tasks	Embedded Orders (multi-task)	VOIE, VOE, VOA
Mortgage	LOS	Hosted Orders	VOIE, VOE
Mortgage	Document Processing	Document Processing	Document extraction
Public Sector	Customer Portal	Embedded Orders	VOIE, VOE
Public Sector	Document Processing	Document Processing	Document extraction
Public Sector	Case Worker Portal	Hosted Orders	VOIE, VOE
Consumer Credit	Smart Routing	Bridge Widget	VOIE
Consumer Credit	Bank Income	Bridge Widget	Income Insights
Consumer Credit	Payroll Income	Bridge Widget	VOIE
Consumer Credit	Paycheck-Linked Loans	Bridge Widget	PLL
Retail Banking	Direct Deposit Switch	Bridge Widget	DDS

Which demo fits your use case?

If you’re building…	Start with
Mortgage origination (purchase, refi, HELOC)	POS Application
Consumer lending (auto, personal, BNPL)	Payroll Income or Smart Routing
Co-borrower or multi-product verification	POS Tasks
Loan processor or caseworker portal	LOS or Case Worker Portal
Account funding / direct deposit capture	Direct Deposit Switch
Earned wage access or loan repayment	Paycheck-Linked Loans
Income from bank when payroll unavailable	Bank Income
Benefits eligibility (SNAP, Medicaid, TANF)	Customer Portal
Pay stub / W-2 / tax return processing	Document Processing

See Test Credentials for sandbox login scenarios.

​Quickstart

Quickstart

​Demo apps

​Prerequisites

​Setup

​Choose a demo

​Which demo fits your use case?

Quickstart

Demo apps

Prerequisites

Setup

Choose a demo

Which demo fits your use case?