Encore Events

Encore Events is a next-generation social event planning platform that reimagines how we gather. From designing stunning story-like invitations to real-time collaborative playlists and AI-powered photo sharing, Encore makes every event unforgettable.

✨ Key Features

🎨 Event Design & Management

• Visual Story Designer: Create Instagram-story style event invitations with custom backgrounds, gradients, and themes.
• Rich Event Details: Manage date, time, location (with autocomplete), and descriptions.
• Smart RSVP: Track attendees with "Going", "Maybe", and "Not Going" statuses.
• QR Code Sharing: Instantly share events via unique QR codes or deep links.

🎵 Collaborative Music

• Shared Playlists: Attendees can contribute songs to the event playlist.
• Multi-Service Import: Import playlists directly from YouTube Music and Spotify. "Switch Vibe" feature lets you instantly clone community playlists.
• Live Voting: Upvote songs to influence the queue order.
• Inline Preview: Listen to track previews directly within the app.

📸 AI Gallery & Face Match

• Smart Face ID: Setup your Face ID once, and the app automatically finds you in every event album.
• Face Clustering: Privacy-first AI that groups photos by identifying participants.
• One-Click Share: Upload photos to a shared event gallery.
• Privacy Controls: Users control their visibility and face data.

🗳️ Interactive Polls & Chat

• Real-time Polls: Create polls for food choices, dates, or activities.
• Wall Chat: A dedicated space for event chatter, announcements, and excitement.
• Multimedia Messaging: Share images and updates in real-time.

👤 Profile & Social

• Custom Profiles: Set your avatar, bio, and app theme (Midnight, Sunset, Ocean, etc.).
• Privacy Settings: Toggle online status and public visibility.
• Data Export: Full control to download your personal data.

🛠️ Tech Stack

• Frontend: React, Vite, TypeScript
• Styling: TailwindCSS, Framer Motion (for smooth animations)
• Backend/Database: Supabase (PostgreSQL, Realtime, Storage, Edge Functions)
• Auth: Supabase Auth (Google & Email)
• Mobile: Capacitor (iOS & Android support)
• AI: face-api.js (Client-side face recognition)
• Icons: Lucide React

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v18+)
• npm
• A Supabase project

Installation

1. Clone the repository

   git clone https://github.com/yourusername/encore-events.git
   cd encore-events

2. Install dependencies

   npm install

3. Configure Environment Variables Create a .env.local file in the root directory and populate it with your keys:

   # Supabase Configuration
   VITE_SUPABASE_URL=your_supabase_project_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
   
   # Google Integration (Auth & YouTube)
   VITE_GOOGLE_CLIENT_ID=your_google_client_id
   VITE_GOOGLE_API_KEY=your_google_api_key
   VITE_YOUTUBE_CLIENT_ID=your_youtube_client_id
   
   # Spotify Integration
   VITE_SPOTIFY_CLIENT_ID=your_spotify_client_id
   VITE_SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
   
   # SMS / 2Factor (Optional)
   2FACTOR_API_KEY=your_2factor_key
   SMS_TEMPLATE_NAME=EncoreEvents
   
   # OAuth Redirect
   VITE_REDIRECT_URI=http://localhost:3000

4. Setup Database Run the SQL migrations in your Supabase dashboard or via CLI to set up the tables and security policies. The migration files are located in supabase/migrations/.

5. Run Development Server

   npm run dev

📱 Mobile Build (Capacitor)

To build for mobile devices:

# Build the web app
npm run build

# Sync with Capacitor
npx cap sync

Open Android Studio or Xcode to build the native app from the android or ios directories.