Introduction

MatchNest is a full-featured, production-ready matrimonial SaaS platform built with Next.js 14+, TypeScript, Prisma ORM, and Tailwind CSS. It provides everything you need to launch a professional matrimonial website.

What is MatchNest?

MatchNest is a complete, self-hosted matrimonial platform with:

• A beautiful marketing website with pricing, about, features, and success stories pages
• Full user dashboard with profile management, matchmaking, messaging, and billing
• Comprehensive admin panel for managing users, payments, content, and settings
• Flexible subscription system with Free, Silver, Gold, and Platinum plans
• Secure JWT-based authentication with role-based access control
• File upload system for avatars and photo galleries
• Support ticket system for customer service
• Real-time notifications

Tech Stack

Quick Start

The fastest way to get MatchNest running locally:

# Clone the repository
git clone https://github.com/your-repo/matchnest.git
cd matchnest

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your values

# Set up the database
npm run db:push
npm run db:seed

# Start development server
npm run dev

Then open http://localhost:3000 to see the app.

Default admin credentials after seeding: [email protected] / admin123

Directory Structure

matchnest/
├── prisma/
│   ├── schema.prisma        # Database schema (20+ models)
│   └── seed.ts              # Demo data seeder
├── prisma.config.ts         # Prisma 7 configuration
├── src/
│   ├── app/
│   │   ├── (marketing)/     # Public website pages
│   │   ├── (auth)/          # Login, register, forgot password
│   │   ├── (dashboard)/     # Member dashboard
│   │   ├── (admin)/         # Admin panel
│   │   ├── api/             # API routes
│   │   └── docs/            # Documentation (this site)
│   ├── components/
│   │   ├── ui/              # Reusable UI components
│   │   └── layout/          # Layout components
│   └── lib/
│       ├── auth.ts          # JWT authentication
│       ├── prisma.ts        # Database client
│       ├── constants.ts     # App-wide constants
│       ├── utils.ts         # Utility functions
│       ├── validations.ts   # Zod validation schemas
│       ├── subscription.ts  # Subscription limits
│       └── upload.ts        # File upload handler
└── public/
    └── uploads/             # User-uploaded files