https://github.com/idriskulubi/valspace

https://github.com/idriskulubi/valspace

Last synced: 9 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/idriskulubi/valspace
• Owner: IdrisKulubi
• Created: 2025-01-26T08:20:39.000Z (12 days ago)
• Default Branch: main
• Last Pushed: 2025-01-26T10:30:57.000Z (12 days ago)
• Last Synced: 2025-01-26T11:18:17.836Z (12 days ago)
• Language: TypeScript
• Size: 138 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Find Your Valentine - Web App Requirements

## Overview

A Tinder-like platform designed for university students to find their Valentine. Users can create profiles with multiple photos and personal details, swipe through potential matches, and connect through chat when mutual interest is expressed.

## Technology Stack

### Frontend

- **Framework**: Next.js

- **Styling**: Tailwind CSS

### Backend & Infrastructure

- **Database**: Neon DB

- **Authentication**: NextAuth.js

- **Image Storage**: Cloudinary

- **Real-time Features**: WebSockets (Pusher/Socket.io)

- **Hosting**: Vercel (web app) + Neon DB (database)

## Core Features

### 1. User Authentication

- **Login/Sign-Up**

  - Email/password authentication

  - OAuth providers (Google, etc.)

- **Profile Verification**

  - Email verification system

### 2. User Profiles

- **Profile Creation**

  - Basic details (name, bio, age)

  - Photo management (2-6 photos)

  - Interests/hobbies selection

- **Profile Management**

  - Edit functionality for all profile elements

### 3. Swiping Interface

- Photo carousel display

- Right (like) and left (dislike) swipe actions

- Daily swipe limits for non-premium users (optional)

### 4. Matching System

- **Match Creation**

  - Mutual right swipes create matches

- **Notifications**

  - Real-time match alerts

  - Message notifications

### 5. Messaging System

- **Chat Features**

  - Real-time messaging

  - Typing indicators

  - Read receipts

- **Contact Exchange**

  - Secure phone number sharing

### 6. Explore Section 

- Proximity-based profile browsing

- University-specific filtering

### 7. User Settings

- **Privacy Controls**

  - Profile visibility toggle

  - Block/unmatch functionality

- **Account Management**

  - Password updates

  - Account deletion

### 8. Admin Dashboard

- **User Management**

  - Profile review system

  - Account moderation

- **Analytics**

  - User activity metrics

  - Match/message statistics

### 9. Mobile Optimization

- Responsive design

- Mobile-first approach

### 10. Design & Branding

- **Theme**

  - Valentine's color palette (pink, red, white)

  - Romantic visual elements

- **Brand Identity**

  - App name: "Strathspace"

  - Consistent branding across platform

## Getting Started

[To be added: Setup instructions, development guidelines, and contribution process]

## License

[To be added: License information]