Clear agreements. Visible progress. Stronger trust.
A shared space for money between people who know each other.
Explore the live app · Watch the video · The product · Run locally
Jointly created and owned by Jeel Nandha and Shardul Narvekar.
▶ Watch TrustFirst in 24 seconds
Create an agreement · Track progress · Share proof · Settle clearly
Music: Happy Beats & Business Moves Vol. 11 by Sascha Ende · CC BY 4.0
Informal lending often starts with a conversation and ends up scattered across messages, screenshots, and memory. TrustFirst gives both sides one place to see the commitment, follow repayments, keep payment evidence, and know what needs attention next.
It is built for friends, families, and trusted groups who want more clarity without turning a personal relationship into a complicated process.
The lender's Ask AI to Call Borrower action starts the call request without fetching browser location. The server checks lender access and the borrower's phone number before contacting Sarvam.
| What you can do | |
|---|---|
| Create an agreement | Record the amount, purpose, return date, and an optional witness in a shared agreement. |
| Follow the money | See repayment progress, upload proof, and keep agreement activity in one timeline. |
| Coordinate a group | Make a group money request, accept partial contributions, and track the resulting agreements. |
| Pay and confirm | Use UPI QR flows or Razorpay test-mode checkout; signed webhooks confirm captured Razorpay payments. |
| Handle the conversation | Send email reminders or request Sarvam-powered voice mediation. |
| Keep a verifiable record | Anchor selected agreement and payment fingerprints on Polygon Amoy without putting raw personal details on-chain. |
Trust scores, Firebase notifications, and location context support the experience. Some external actions require a privileged access grant.
flowchart LR
A[Create an agreement] --> B[Share with borrower and optional witness]
B --> C[Track repayment and proof]
C --> D[Confirm settlement]
C --> E[Reminder or Sarvam voice call]
B -. selected fingerprints .-> F[Polygon Amoy]
C -. selected fingerprints .-> F
| Layer | Stack |
|---|---|
| Web experience | Next.js App Router, React, TypeScript, Tailwind CSS, Radix UI, GSAP, Lenis |
| Identity and data | Firebase Authentication and Cloud Messaging, MongoDB, Mongoose, GridFS |
| Payments and communication | UPI, Razorpay, Sarvam AI, Nodemailer |
| Verifiable records and context | Solidity, ethers, Polygon Amoy, Radar |
You need Node.js 20.9 or newer, npm, your own Firebase project, and MongoDB connection. Provider features need their own accounts and credentials.
git clone https://github.com/DevilSharky/Trust-First.git
cd Trust-First
npm ci
cp .env.example .env.localFill in .env.local with your Firebase web app, Firebase Admin, and MongoDB values, then start the app:
npm run devOpen http://localhost:3000. On Windows PowerShell, use Copy-Item .env.example .env.local instead of cp. The local setup guide covers each integration, webhooks, access grants, and verification.
app/ Pages and API routes
components/ Product interface and reusable UI
lib/ Services, access checks, payments, and blockchain logic
models/ MongoDB models
contracts/ Solidity contracts
scripts/ Polygon Amoy deployment and verification
docs/ Local setup and project imagery
Razorpay is configured for test-mode payments, and the blockchain integration targets the Polygon Amoy testnet. TrustFirst records informal commitments; it does not claim that an agreement is a legal contract or that a trust score is a credit score.
TrustFirst is jointly created and owned by Jeel Nandha and Shardul Narvekar. The source is public to view, but the original code, design, documentation, and brand materials are all rights reserved. Read AUTHORS.md and LICENSE for attribution and permissions. Third-party dependencies retain their own licenses.
Please keep credentials, wallet keys, user uploads, and production data out of Git. For a security issue, see SECURITY.md.