Skip to content

Saptami191/Choice__love

Repository files navigation

💕 Choice Love - Soul-Based Matching App

A beautiful love matching application that connects people through shared values, cultural respect, and meaningful choices rather than superficial attributes.

🌟 Philosophy

"Love is not just about who you talk to, but who you understand without speaking."

This app honors the belief that true love happens when two souls resonate through shared cultural values, artistic compatibility, and life goals.

✨ Features

🎨 Divine Experience

  • Beautiful UI: Divine Krishna and Radha background representing spiritual love.
  • Glass-morphism: Modern, smooth interface with pink gradients and cultural significance.
  • Responsive: Fully optimized for mobile soul-seekers.

📝 Growth-Hacking & Engagement (New!)

  • Instant Soul Matches: Guaranteed 3–5 high-quality matches immediately (no empty states).
  • Match Freshness: Hybrid rotation strategy keeps the experience dynamic on every visit.
  • Activity Simulation: Realistic "Last Active" signals (Online, 5m ago, etc.) show a vibrant community.
  • Urgency Injection: Matches feature expiry timers (6h to 5 days) to encourage proactive connection.
  • Match Evolution: Connections progress through a lifecycle from Waiting to Active to Fading.

🔓 Reward & Progression

  • Progressive Reveal: Matches are revealed gradually (3 initially, then 6+) to build anticipation.
  • Return User Rewards: Revisiting the app "unlocks" deep philosophical insights for top matches.
  • Conversation Starters: Personalized ice-breakers generated automatically based on shared values.

📊 Admin Analytics

  • Live Event Logging: Tracking views, match clicks, and messages in real-time.
  • Admin Dashboard: Access /admin to monitor community engagement and connection rates.

🏗️ Project Structure

choice-love/
├── public/                    # Frontend files
│   ├── index.html            # Main app page
│   ├── admin.html            # Analytical Dashboard (New!)
│   ├── style.css             # Styling and animations
│   └── script.js             # Frontend JavaScript
├── server.js                 # Enhanced Backend API server
├── users.json                # User data (auto-created)
├── events.log                # Activity logs (auto-created)
├── matches.json              # Persistent match data
└── README.md                 # This file

🚀 Quick Start

  1. Install dependencies
    npm install
  2. Start the server
    npm start
  3. Open the App: http://localhost:3001
  4. Access Analytics: http://localhost:3001/admin

🚀 Live Demo

🔗 Try the App

🎯 Matching Algorithm (Calibrated)

The app now uses a Normalized Compatibility System (65–95%):

  1. Cultural Values (Weight: 3.0)
  2. Family & Tradition (Weight: 2.5)
  3. Relationship Goals (Weight: 2.5)
  4. Lifestyle Harmony (Weight: 2.0)
  5. Score Normalization: Raw values are mapped to a trust-building 65–95% range.
  6. Rare Alignment Ceiling: Only one match is permitted to reach the "Rare alignment" status (>90%).

🌈 Cultural Significance

  • Divine Inspiration: Krishna and Radha's eternal love.
  • Cultural Respect: Emphasis on family values and elder respect.
  • Soul Connection: Highlighting "Why this match" using shared philosophical overlaps.

🛠️ Development

  • Data Logs: User behavior is stored in events.log as JSON lines.
  • Stability: The engine includes defensive code for varied data types (strings vs arrays).

"True love happens when two souls understand each other's values, even without words." 💕

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors