⚡ DevMatch — Next-Gen AI Developer & Client Marketplace

Bridging top software engineering talent with ambitious companies through Generative AI AI semantic matching, progressive 4x25% milestone escrow contracts, auto-generated legal PDF agreements, and cross-platform native Android access.

Explore Live Web App • AI Deep Fit Analysis • Milestone Escrow • PDF Contracts • Mobile App • Quickstart

---

🌟 Overview

DevMatch is a full-stack platform designed to eliminate the friction, ghosting, and payment disputes inherent to traditional freelance marketplaces. By pairing Advanced Generative AI semantic intelligence, instant vector PDF contract generation, hardware-accelerated push alerts, and an automated 4x25% progressive escrow state machine, DevMatch sets a new benchmark for trust and velocity in software hiring.

---

🚀 Key Feature Pillars

🤖 Advanced Generative AI Deep Fit Semantic evaluation engine analyzing candidate portfolios, skill stacks, and past velocity to output match scores, executive summaries, readiness gap analysis, and tailored technical interview questions.	🛡️ 4 x 25% Progressive Escrow Automated milestone gating where developers submit deliverable proof of work (GitHub PRs, live demo URLs), clients review and approve, and funds unlock progressively in Indian Rupees (₹).
📄 Auto-Generated PDF Legal Contracts 1-click vector PDF contract generator incorporating unique reference IDs, Indian IT Act legal jurisdiction, 4x25% payment schedules, IP transfer terms, and digital timestamped signature seals.	📲 Native Push & Sound Alerts System-level push notifications, Android hardware vibration (navigator.vibrate), and synthesized Web Audio API chimes for live messages and milestone payment approvals.
📱 Native Android Mobile App Packaged with Capacitor and compiled via JDK 21 / Gradle into a standalone app-debug.apk with camera hardware permissions and 60fps animations.	🔒 Enterprise RBAC & Security Strict Firestore document security rules, session-only authentication persistence, server-side Razorpay HMAC SHA-256 verification, and dedicated Admin oversight panel.

---

🤖 AI Deep Fit & Semantic Matching Engine

DevMatch leverages the Generative AI API (advanced-llm-engine) to provide unmatched transparency during candidate evaluation:

flowchart TD
    A[Client Project Requirement] --> B[Advanced LLM Engine Semantic Engine]
    C[Developer Profile & Portfolio] --> B
    B --> D[✨ AI Match Score 0-100%]
    B --> E[📝 2-Sentence Executive Rationale]
    B --> F[💪 3 Key Technical Strengths]
    B --> G[⚠️ Readiness & Gap Analysis]
    B --> H[🎯 Custom Technical Interview Questions]

Loading

• Interactive Modal: Clients can click "✨ AI Deep Fit" on any developer to inspect the AI reasoning engine before sending offers.
• Smart Milestone Breakdown: Clients can input rough project briefs and let the AI auto-generate the 4-phase milestone schedule.

---

💳 4 x 25% Progressive Milestone Escrow

DevMatch protects both parties with an automated, 4-phase financial workflow:

flowchart LR
    A[🚀 Project Created] --> B[Phase 1: 25% Active Work]
    B --> C[👨‍💻 Submit GitHub PR / Demo]
    C --> D[🏢 Client Review & Escrow Release]
    D --> E[💰 Phase 1 ₹ Wallet Credited]
    E --> F[Phase 2: 25% Unlocked]
    F --> G[Phase 3: 25%]
    G --> H[Phase 4: 100% Complete & Reviews]

Loading

1. Phase 1 (25%): Developer completes the prototype and submits deliverables.
2. Client Review: Client inspects the live code/demo and releases funds from escrow.
3. Automated Progression: Phase 2 unlocks, the developer's wallet is credited with ₹ INR, and audio/push alerts are triggered.
4. Final Phase: On 100% completion, clients leave verified star ratings and reviews.

---

📄 Auto-Generated PDF Milestone Escrow Contracts

Every project on DevMatch can generate an official, legally structured PDF contract with a single click:

• Document Structure:
  • Header: DevMatch Escrow Guarantee with unique tracking code (e.g. DVM-2026-XXXXX).
  • Parties: Formal Principal (Client) and Contractor (Developer) identification.
  • Scope & Financials: Total project budget in ₹ INR and 4x25% breakdown.
  • Milestone Table: Deliverables matrix, payment amount per phase, and verification criteria.
  • Legal Clauses: Progressive release terms, 100% IP ownership transfer to Client upon payout, and DevMatch Admin dispute arbitration under the Indian Information Technology Act.
  • Digital Verification Seal: Official DevMatch Escrow stamp and timestamped signature blocks.

---

🛠️ Technology Stack

Frontend Architecture:
├── React 19 (Modern Functional Components & Hooks)
├── Vite 8 (Sub-Second HMR & Production Bundling)
├── Tailwind CSS v4 (Glassmorphic Dark Theme & Responsive Layouts)
├── Framer Motion (Fluid 60fps Micro-Animations)
└── Recharts (Interactive Financial & Earnings Analytics)

AI & Document Generation:
├── Advanced Generative AI (Semantic Candidate Fit & Milestone Structuring)
├── jsPDF & jsPDF-AutoTable (Client-Side Vector Legal Agreement Generation)
└── Web Audio API (Synthesized Real-Time Notification Chimes)

Backend & Cloud Infrastructure:
├── Firebase Authentication (Google OAuth + Email/Password + Session-Only Persistence)
├── Cloud Firestore (Reactive Real-Time DB with Production RBAC Rules)
├── Firebase Storage (Encrypted Portfolio & Deliverables Storage)
└── Firebase Hosting (Global CDN Edge Deployment)

Mobile Engineering:
├── Capacitor 8 (Cross-Platform Native Bridge)
└── Android SDK / OpenJDK 21 / Gradle 8 (Native APK Packaging & Hardware APIs)

Payments & Verification:
├── Razorpay Smart Gateway (UPI QR, Cards, NetBanking in ₹ INR)
└── Express / Node.js Backend (HMAC SHA-256 Signature Verification)

---

📱 Native Android Mobile App

DevMatch comes bundled with a fully compiled, cross-platform Android application:

• Compiled APK Path: android/app/build/outputs/apk/debug/app-debug.apk (Size: ~5.93 MB)
• Build Fresh APK: npm run mobile:build
• Open in Android Studio: npm run mobile:open
• Sync Web Changes to Mobile: npm run mobile:sync

---

📁 Repository Structure

devmatch_v1.0/
├── 📂 android/               # Native Android Studio project & Gradle build files
├── 📂 public/                # Static public assets, favicon & logos
├── 📂 server/                # Express backend for Razorpay order generation & HMAC verification
├── 📂 src/
│   ├── 📂 auth/              # Login, Register, Forgot Password & Admin Login
│   ├── 📂 components/        # Onboarding wizards, UI primitives, PhotoUpload, Badges
│   ├── 📂 context/           # AuthContext & global reactive states
│   ├── 📂 dashboard/         # Multi-role dashboard views (Developer, Client, Admin)
│   ├── 📂 landing/           # Landing page components (Hero, Features, AI Assistant, etc.)
│   ├── 📂 routes/            # ProtectedRoute, PublicRoute, AdminProtectedRoute
│   ├── 📂 services/
│   │   ├── aiService.js      # Heuristic & algorithmic matching engine
│   │   ├── authService.js    # Firebase Auth & session persistence
│   │   ├── contractService.js# jsPDF legal milestone agreement generator
│   │   ├── aiService.js  # Advanced Generative AI semantic AI integration
│   │   ├── notificationService.js # Web Audio chime, push & vibration service
│   │   ├── projectService.js # 4x25% milestone escrow state machine
│   │   └── razorpayService.js# Multi-tab payment sandbox & live order verification
│   ├── 📂 utils/             # Firebase SDK client initialization
│   ├── App.jsx               # React.lazy() route configuration with Suspense
│   └── main.jsx              # Application entry point
├── capacitor.config.json     # Mobile runtime settings
├── firebase.json             # Hosting rewrites and deployment rules
├── firestore.rules           # Production document security rules
├── storage.rules             # Production file upload security rules
└── package.json              # Project dependencies and operational scripts

---

⚙️ Getting Started

1. Prerequisites

• Node.js: v18 or higher
• Java: JDK 21 (for compiling the Android APK)
• Android Studio: (Optional, for device emulators)

2. Installation

# Clone the repository
git clone https://github.com/Pranav7758051011/devmatch.git
cd devmatch

# Install dependencies
npm install

3. Environment Configuration

Create a .env file in the root directory:

VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
VITE_FIREBASE_DATABASE_URL=your_database_url
VITE_FIREBASE_PROJECT_ID=your_project_id
VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=your_app_id
VITE_FIREBASE_MEASUREMENT_ID=your_measurement_id

# Optional: Generative AI API Key for Live Deep Fit Analysis
VITE_AI_API_KEY=your_ai_api_key

4. Running Locally

# Start Vite Development Server (http://localhost:5173)
npm run dev

# Start Razorpay Verification Server (Optional, for live HMAC signatures)
cd server
npm install
npm run start

5. Production Build & Deployment

# Build optimized web bundle
npm run build

# Deploy to Firebase Hosting & Firestore Security Rules
npx firebase-tools deploy --only hosting,firestore

# Build Android APK
npm run mobile:build

---

🔒 Proprietary License & Copyright Notice

Copyright © 2026 Pranav Bade. All Rights Reserved.

This software, its source code, assets, UI designs, mobile implementations, and documentation are strictly Proprietary and Confidential.

Important Notice: No person, company, or entity may use, copy, modify, merge, publish, distribute, sublicense, sell, reverse engineer, or decompile this software without the express, prior written permission of Pranav Bade.

For licensing inquiries or commercial permissions, contact the repository owner.

---

_{Crafted with passion, precision, and state-of-the-art web & mobile technology by Pranav Bade.}