SoulLink is a modern, AI-powered social platform for building meaningful romantic and platonic connections. It features dual modes (Love & Friendship), secure chat, games, AI assistant, and more—all with a beautiful, responsive UI.
- Dual-mode: Switch between Love and Friendship experiences
- AI-powered matching, chat tips, and content
- Face verification and blockchain-backed privacy
- Secure, real-time chat with media sharing
- Interactive games (Truth or Dare, quizzes, etc.)
- Memories gallery for photos and videos
- Calendar for important dates
- Responsive, modern UI with dark mode
- Frontend: Next.js 14, React, TypeScript, Tailwind CSS, Framer Motion
- Backend: Node.js, Express, MongoDB, Multer, OpenAI API
- Other: JWT Auth, Socket.io, Vercel/Render deployment
- Node.js (18+ recommended)
- npm or yarn
- MongoDB instance (local or cloud)
- (Optional) OpenAI API key for AI features
- (Optional) SMTP/Twilio for email/SMS
- Clone the repo:
git clone https://github.com/nytsoul/SoulLink.git cd SoulLink - Install dependencies:
cd backend npm install cd ../frontend npm install
- Configure environment variables:
- Copy
.env.exampleto.envin bothbackendandfrontendfolders and fill in required values.
- Copy
- Start the backend:
cd ../backend npm run dev - Start the frontend:
cd ../frontend npm run dev - Visit the app:
- Frontend: http://localhost:3000 (or 3001 if 3000 is busy)
- Backend: http://localhost:5000
SoulLink/
backend/ # Express API, MongoDB models, routes
frontend/ # Next.js app, components, pages
contracts/ # Smart contracts (optional)
uploads/ # Uploaded media
- Update branding in
/frontend/components/Navbar.tsxand/frontend/components/Footer.tsx. - Add or modify games in
/frontend/app/games/. - Configure AI and verification in backend
/backend/src/routes/.
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
SoulLink — Connect. Play. Grow. Powered by AI. <<<<<<< HEAD
=======
1893431 (Fix typings and deployment config)