A personal private lending management mobile app built with React Native + Expo. Helps track loans, monthly interest payments, principal repayments, and lending portfolio stats — with Tamil/English language support and dark/light mode.
| Login | Dashboard | Add Loan |
|---|---|---|
 |
.jpeg) |
 |
- Dashboard — Total principal in rotation, all-time interest received, total accrued (incl. deferred), and expected income this month
- Borrowers — Add and manage borrowers with principal amount, interest rate, payment cycle, and optional tenure
- Monthly View — Timeline of monthly payment statuses: paid (green), pending (amber), deferred (blue), overdue (red)
- Principal Repayment — Partial or full repayment; full repayment closes the loan
- Compound Interest — Optional: deferred interest accumulates as pending or adds to principal next month
- Payment Cycles — Calendar month or anniversary date
- PDF Export — Per-borrower statement and monthly summary
- Notifications — Local push reminders for upcoming/overdue payments
- Auth — Email/password + Google Sign-in via Firebase
- Bilingual — English and Tamil (தமிழ்)
- Theming — Dark and light mode
| Layer | Technology |
|---|---|
| Framework | React Native + Expo (SDK 54, managed workflow) |
| Routing | Expo Router v3 (file-based) |
| Backend | Firebase (Firestore + Auth) |
| State | Zustand v5 |
| UI | React Native Paper v5 |
| i18n | react-i18next + i18next |
| Notifications | expo-notifications |
| expo-print + expo-sharing | |
| Date utils | date-fns |
- Node.js 18+
- Expo CLI (
npm install -g expo-cli) - Expo Go app on your device, or Android/iOS emulator
git clone https://github.com/your-username/lendtrack.git
cd lendtrack
npm install- Go to console.firebase.google.com and create a new project
- Enable Email/Password authentication
- Enable Firestore Database
- Register an Android/iOS app and download the config
- Open
lib/firebase.tsand replace the placeholder config:
const firebaseConfig = {
apiKey: "YOUR_API_KEY",
authDomain: "YOUR_AUTH_DOMAIN",
projectId: "YOUR_PROJECT_ID",
storageBucket: "YOUR_STORAGE_BUCKET",
messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
appId: "YOUR_APP_ID",
};- Set Firestore security rules (example):
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /users/{userId} {
allow read, write: if request.auth.uid == userId;
}
match /loans/{loanId} {
allow read, write: if request.auth != null &&
resource.data.userId == request.auth.uid;
allow create: if request.auth != null;
}
match /payments/{paymentId} {
allow read, write: if request.auth != null;
}
}
}
npm start
# then press 'a' for Android, 'i' for iOSapp/
_layout.tsx # Root: auth gate, PaperProvider, i18n init
(auth)/
login.tsx
register.tsx
(app)/
_layout.tsx # Tab navigator (Dashboard, Borrowers, Monthly, Settings)
dashboard.tsx
monthly.tsx
settings.tsx
borrowers/
index.tsx # Borrowers list
add.tsx # Add loan form
[id]/
index.tsx # Borrower detail + monthly payment timeline
repay.tsx # Principal repayment
lib/
firebase.ts # Firebase init (update config here)
calculations.ts # Interest math (pure functions)
firestore/
loans.ts # Loan CRUD + real-time subscription
payments.ts # Payment CRUD
users.ts # User profile CRUD
notifications.ts # Local push notification scheduling
pdf.ts # PDF generation
i18n/
en.json # English strings
ta.json # Tamil strings
store/
authStore.ts # Auth state
loansStore.ts # Loans + payments real-time state
settingsStore.ts # Language/theme/alert days (persisted)
types/index.ts # All TypeScript types
constants/Colors.ts # Full color palette (dark + light)
hooks/useTheme.ts # Theme hook
- Deferred + Compound ON → deferred interest is added to principal the next month
- Deferred + Compound OFF → deferred interest accumulates as pending (not added to principal)
- Partial repayment → recalculates future interest on reduced principal
- Full repayment → marks loan as closed
Private — personal use only.