Advanced Mortgage Loan Origination Platform for Modern Lending Professionals
Quick Start • Features • Screenshots • Documentation • Support
MLO Engine is a comprehensive mortgage loan origination platform designed for Mortgage Loan Officers (MLOs), real estate professionals, and lending institutions. Built with modern web technologies, it provides real-time loan calculations, client management, and professional marketing tools.
- Loan Calculations: Purchase and refinance scenarios with real-time payment calculations
- Client Management: Comprehensive database for borrower profiles and loan options
- Marketing Tools: Professional open house flyers with live loan data
- Team Collaboration: Share scenarios with team members and real estate partners
- Multi-State Support: Calculations for 15 states with county-level accuracy
| Feature | Description | Status |
|---|---|---|
| Purchase Calculator | Full purchase loan analysis with multiple loan types | ✅ Live |
| Refinance Calculator | Rate & term and cash-out refinance calculations | ✅ Live |
| Down Payment Assistance | DPA program calculations and qualification | ✅ Live |
| Income Calculators | Schedule C, W2, 1120S, rental income analysis | ✅ Live |
| Lead Calculator | Lead generation and qualification tools | ✅ Live |
- Client Database: Store and manage borrower profiles with loan scenarios
- Option Comparison: Compare multiple loan options side-by-side
- Open House Flyers: Generate co-branded marketing materials
- Sharing Console: Share calculations with realtors and clients
- Team Management: Collaborate with team members on loan scenarios
- Conventional: Conforming and jumbo loans
- Government: FHA, VA, USDA loan programs
- Non-QM: Alternative documentation loans
- Down Payment Assistance: Various DPA programs
Southeast: Florida, Georgia, North Carolina, South Carolina, Tennessee
Southwest: Arizona, Texas
Northeast: Massachusetts, Maryland, New Jersey
West: California, Colorado, Nevada, Utah, West Virginia
Loan Option Comparison |
Income Calculators |
Open House Flyers |
Down Payment Assistance |
- Framework: Next.js 15.3.3 (App Router)
- UI Library: React 18.3.1 with TypeScript 5.5.4
- Styling: Tailwind CSS 3.4.12 + Radix UI Components
- State Management: Zustand with Immer
- Forms: React Hook Form patterns
- Animations: Framer Motion
- Database: Supabase (PostgreSQL)
- Authentication: Supabase Auth with OTP support
- File Storage: Supabase Storage
- PDF Generation: jsPDF, html2pdf.js
- Image Processing: Sharp, react-easy-crop
- Testing: Jest with React Testing Library
- Code Quality: ESLint, Prettier
- Performance: Bundle analyzer, Lighthouse integration
- Node.js 18+ and npm
- Supabase CLI installed (
npm install -g supabase) - Docker Desktop (for local Supabase)
# Clone the repository
git clone https://github.com/loandock/mloengine.git
cd mloengine
# IMPORTANT: Set up root environment variables FIRST
cp .env.example .env
# Edit .env with your configuration.env file in the root directory MUST be configured before running any commands.
# Run backend setup - this MUST be done at least once before using frontend
./entrypoint.sh --backendThis initializes the local Supabase instance with the database schema.
# Typical usage - runs both backend and frontend
./entrypoint.sh --backend --frontendThis starts:
- Supabase local instance on http://localhost:54323
- Next.js development server on http://localhost:3000
./entrypoint.sh [options]
Options:
--backend Start the Supabase backend
--frontend Start the Next.js frontend
--stop Stop the Supabase service
--reset Reset the Supabase database
--status Show Supabase instance status
--clean Remove .env.local files before starting
--help Display help messageIf you prefer manual setup or need to run services separately:
# Backend setup
cd backend
supabase start
# Frontend setup (in a new terminal)
cd frontend/mloengine
npm install
cp .env.example .env.local
# Edit .env.local with Supabase local credentials
npm run devRoot .env file (required for entrypoint script):
# Add your environment-specific variablesFrontend .env.local file (auto-generated or manual):
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54323
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_local_anon_key
NEXT_PUBLIC_ENVIRONMENT=developmentnpm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
npm run format # Format code with Prettier
npm run test # Run tests
npm run analyze # Analyze bundle sizemloengine/
├── frontend/mloengine/ # Next.js application
│ ├── src/
│ │ ├── app/ # App router pages
│ │ ├── components/ # React components
│ │ ├── hooks/ # Custom hooks
│ │ ├── models/ # Business logic
│ │ ├── store/ # Zustand stores
│ │ └── utils/ # Utilities
│ └── public/ # Static assets
├── backend/ # Supabase configuration
└── documentation/ # Project documentation
Comprehensive documentation is available in the /documentation directory:
- Architecture Guide - System design and patterns
- Feature Documentation - Detailed feature guides
- API Reference - Backend integration guides
- Project Overview - High-level project information
The project includes comprehensive test coverage:
- 48 test files covering core business logic
- State calculations verified for all 15 supported states
- Loan calculations tested for accuracy
- Run tests with:
npm test
- Documentation: Documentation Hub
- Email: support@mloengine.com
- LinkedIn: MLO Engine on LinkedIn
- Authentication: Secure login with OTP support
- Data Isolation: Row Level Security (RLS) ensures data privacy
- Encryption: All data transmitted over HTTPS
- Compliance: Equal Housing Opportunity compliant
This project is proprietary software. All rights reserved.
Copyright © 2024 LoanDock, LLC
Equal Housing Opportunity
MLO Engine - Empowering Mortgage Professionals