haraya

Wedding planning platform for Filipino couples.

Overview

Haraya is a full-stack wedding planning app built for couples in the Philippines. It covers vendor discovery across 300+ vendors in 8 categories, planning tools (checklist, budget tracker, guest list), a celebration website builder, and an AI planning assistant with Filipino wedding knowledge. The platform is inclusive of all couple types and ceremony traditions.

Features

• Vendor directory with filtering by category, location, and price range
• Matchmaker quiz for personalized vendor recommendations
• Planning dashboard with a 44-task checklist, budget tracker, and guest list
• Celebration website builder with 4 themes and RSVP collection
• Kasa AI assistant (OpenAI) trained on Filipino wedding customs
• Guest list with RSVP tracking and dietary requirement management
• Photo gallery with guest upload support
• Gift section with GCash, Maya, and bank QR code display

Stack

Technology	Purpose
React 19 + TypeScript	Frontend UI
Vite	Build tooling
Tailwind CSS 4	Styling
Supabase (PostgreSQL + Auth)	Database and authentication
React Router 7	Client-side routing
OpenAI API	Kasa AI planning assistant
QR code generation	Payment QR codes for gift section
Vercel	Hosting

Getting Started

Prerequisites

• Node.js 18+
• npm

Setup

git clone https://github.com/heymervin/haraya.git
cd haraya
cp .env.example .env.local
npm install
npm run dev

Environment Variables

Variable	Description
VITE_SUPABASE_URL	Supabase project URL
VITE_SUPABASE_ANON_KEY	Supabase anonymous key
OPENAI_API_KEY	OpenAI API key for Kasa AI assistant

Project Structure

everaftr-app/          # Main application code
└── src/
    ├── pages/         # 21 route-level page components
    ├── components/    # Shared UI components
    ├── lib/           # API clients and utilities
    ├── types/         # TypeScript type definitions
    └── data/          # Vendor and static data
api/                   # Serverless API routes
supabase/              # Database migrations and config