https://github.com/akashsaha02/soulmatch-client
SoulMatch - A modern matrimonial platform with advanced filters, search, sorting, and premium membership features for meaningful connections.
https://github.com/akashsaha02/soulmatch-client
axios react-router reactjs shadcn-ui swiper tailwindcss tanstack-query vite
Last synced: 3 months ago
JSON representation
SoulMatch - A modern matrimonial platform with advanced filters, search, sorting, and premium membership features for meaningful connections.
- Host: GitHub
- URL: https://github.com/akashsaha02/soulmatch-client
- Owner: akashsaha02
- Created: 2025-01-29T13:24:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-02T15:10:21.000Z (4 months ago)
- Last Synced: 2026-03-02T18:39:05.014Z (4 months ago)
- Topics: axios, react-router, reactjs, shadcn-ui, swiper, tailwindcss, tanstack-query, vite
- Language: JavaScript
- Homepage: https://soulmatch-b2923.web.app/
- Size: 6.39 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SoulMatch Matrimony Platform
## Live Website
[Visit SoulMatch](https://soulmatch-b2923.web.app/)
SoulMatch is an advanced matrimony platform built using the MERN (MongoDB, Express, React, Node.js) stack. This online platform enables users to connect with potential life partners through an intuitive, secure, and user-friendly interface.
## Client-Side (Frontend)
### Summary
The client side of SoulMatch focuses on delivering a responsive and engaging user experience. Features include a homepage with premium biodatas, biodata filtering, private biodata details, and success stories. Key functionalities such as user authentication, dynamic form handling, and toast notifications have been implemented for seamless interaction.
### Key Features
- Responsive design for mobile, tablet, and desktop.
- Secure authentication using Firebase and JWT.
- Premium biodata display with dynamic filtering and sorting options.
- Private routes for biodata details, ensuring user privacy.
- Notification system for CRUD operations and authentication.
- Integration of Stripe for secure payments.
- Success stories section with user reviews and images.
- Interactive dashboard for users and admins.
### Technologies Used
- **React**: Framework for building the user interface.
- **React Router DOM**: For routing and private routes.
- **Shadcn Ui**: Used Shadcn ui to create modern components.
- **Tailwind CSS**: For styling and responsiveness.
- **TanStack Query**: Efficient data fetching and state management.
- **Firebase**: Authentication and hosting.
- **Stripe**: Payment gateway.
- **SweetAlert2**: Stylish notifications and modals.
- **Axios**: API requests.
### Scripts
- `dev`: Starts the development server.
- `build`: Builds the production-ready client application.
- `preview`: Previews the production build.
## Installation and Setup
### Client Setup
1. **Clone the Repository**
Navigate to the client directory:
```
git clone https://github.com/akashsaha02/soulmatch-client
cd soulmatch-client
```
2. **Install Dependencies**
Run:
```
npm install
```
3. **Configure Environment Variables**
Create a `.env` file and add the following key:
```
VITE_API_BASE_URL=
```
4. **Run the Development Server**
Start the development server with:
```
npm run dev
```
### Server Setup
1. **Clone the Repository**
Navigate to the server directory:
```
git clone https://github.com/akashsaha02/soulmatch-server
cd soulmatch-server
```
2. **Install Dependencies**
Run:
```
npm install
```
3. **Configure Environment Variables**
Create a `.env` file and configure the following variables:
- `MONGODB_URI` – MongoDB connection string
- `JWT_SECRET` – Secret for signing JWT tokens
- Optionally, set `NODE_ENV=production` for production deployment.
4. **Run the Server**
For development, start the server with:
```
npm start
```
The server typically runs on port 3008, unless specified otherwise in your environment.
---
## Server-Side (Backend)
### Summary
The server side ensures smooth API interactions, user data management, and secure transactions. It leverages MongoDB for database management and Express.js for creating RESTful APIs.
### Key Features
- User authentication with JWT tokens.
- Role-based access control for admin and users.
- Dynamic biodata creation and management.
- Secure storage of Firebase and MongoDB credentials using environment variables.
- Premium user management and Stripe payment handling.
- Efficient data filtering and sorting.
- Admin dashboard with management features and analytics.
### Technologies Used
- **Node.js**: Backend runtime environment.
- **Express.js**: Framework for API development.
- **MongoDB**: Database for biodata and user management.
- **Mongoose**: ODM library for MongoDB.
- **JWT**: For secure user authentication.
- **Stripe**: Payment processing.
- **Dotenv**: Secure storage of sensitive information.
- **Cors**: Enable cross-origin requests.
### Scripts
- `start`: Starts the production server.
- `dev`: Starts the development server.
## Repository Structure
- `client/`: Frontend source code.
- `server/`: Backend source code.
- `readme.md`: Documentation for the project.
## Live Website
[Visit SoulMatch](https://soulmatch-b2923.web.app/)
## Admin Credentials
- **Email**: admin@soulmatch.com
- **Password**: Admin123
## Features Overview
1. Fully responsive design.
2. Secure authentication and private routes.
3. Premium biodata filtering and sorting.
4. User dashboards for biodata and contact requests.
5. Admin dashboards for managing users and biodata.
6. Stripe integration for payments.
7. Success stories and user reviews.
8. Toast notifications for better user experience.
9. Efficient data fetching with TanStack Query.
10. Real-time updates and analytics for admins.