LiveLink is a gamified social web platform that makes it fun and easy to connect with friends, discover new activities, and plan events. Users can log in via phone number, explore activity recommendations powered by AI, track their social experiences, and personalize their profile.
-
🔐 Phone Number Login
Secure login using Twilio Verify API with SMS code authentication. -
🎯 Event Discovery & Recommendations
AI-generated suggestions powered by Cohere based on group size and activity type. -
🧑💼 Profile Page
Modern, styled profile layout with user info and future video + action sections. -
🧭 Navigation Sidebar
Intuitive layout for navigating between Events, Friends, Discovery, and Profile. -
📦 Component-Based Architecture
Built with React and organized into reusable components and pages.
- Frontend: React (Vite), JavaScript, CSS Modules
- Backend: Node.js + Express
- APIs:
frontendmain/ ├── src/ │ ├── assets/ # Images for profile/header │ ├── components/ # Sidebar, EventsContext, etc. │ ├── pages/ # Profile.jsx, Discovery.jsx, Events.jsx... │ ├── App.jsx # App routing structure │ └── main.jsx # App entry └── public/
backend/ ├── server.js # Express backend with Twilio & Cohere routes ├── twilio.js # Twilio client and service SID └── .env # Environment variables
- Node.js v18 or higher
- A Twilio account with a verified phone number
- Cohere API key (https://dashboard.cohere.com/api-keys)
- Numverify API key (free at https://numverify.com)
-
Clone the repo:
git clone https://github.com/yourusername/livelink.git cd livelink
In your .env file: TWILIO_ACCOUNT_SID=your_sid TWILIO_AUTH_TOKEN=your_token TWILIO_SERVICE_SID=your_service_sid COHERE_API_KEY=your_cohere_key NUMVERIFY_API_KEY=your_numverify_key
Run the backend: node server.js
Run the frontend: cd frontendmain npm run dev