Mexico Paradise Vacations - Travel Certificate Platform

A comprehensive Next.js application for Mexico vacation certificate sales with payment plans, client portal, and admin dashboard.

Features

🏠 Landing Page

• Beautiful hero section with Mexico destination imagery
• Email capture with phone number collection
• Payment plan integration ($39/month for 18 months)
• Destination showcase (Cancun, Cabo, Rivera Maya, Puerto Vallarta)
• Customer testimonials and FAQ section
• "Hour to Paradise" program information

💳 Payment System

• Integration with Maverick Payments API
• Monthly payment plan processing ($39/month x 18 months = $702 total)
• Real-time payment status tracking
• Automatic certificate issuance upon successful payment
• Refund processing capabilities

👥 Client Portal

• Vacation certificate viewing and management
• Booking instructions and information
• Payment plan tracking and management
• Travel resources and destination guides
• 24/7 support contact information

🛠️ Admin Portal

• Dashboard with key metrics (signups, revenue, destinations)
• Manage vacation package signups
• Track monthly payments and revenue
• Process refunds with one-click functionality
• Certificate management and issuance
• Destination popularity analytics

🔐 Authentication

• Role-based access control (Admin/Client)
• Secure login system
• Protected routes

Business Model

"Hour to Paradise" Program

• Offer: 5 Days, 4 Nights All-Inclusive Mexico Vacation
• Price: $39/month for 18 months ($702 total value)
• Savings: Over $800 compared to regular pricing ($1,500+)
• Requirement: 90-minute resort presentation about vacation ownership
• No Obligation: Customers are not required to purchase anything

Destinations Available

• Cancun: Pristine beaches & vibrant nightlife
• Cabo San Lucas: Dramatic cliffs & luxury resorts
• Rivera Maya: Ancient ruins & turquoise waters
• Puerto Vallarta: Stunning sunsets & culture

Package Includes

• 5 Days & 4 Nights Accommodation
• All Meals & Drinks (including alcoholic beverages)
• Premium Resort Amenities
• Access to Beaches & Pools
• Flexible Booking Dates

Technology Stack

• Framework: Next.js 15 with App Router
• Language: TypeScript 5
• Styling: Tailwind CSS 4 with shadcn/ui components
• Database: Supabase (PostgreSQL)
• Payment: Maverick Payments API
• Authentication: Custom auth system
• State Management: React hooks
• UI Components: shadcn/ui with Lucide icons

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn

Installation

1. Clone the repository

2. Install dependencies:

   npm install

3. Set up environment variables:

   cp .env.example .env.local

   Configure the following variables:

   • NEXT_PUBLIC_APP_URL: Your application URL
   • MAVERICK_API_URL: Maverick Payments API URL
   • MAVERICK_API_KEY: Your Maverick API key

4. Run the development server:

   npm run dev

5. Open http://localhost:3000 in your browser

Database Setup

The application uses Supabase as the database. The following tables are included:

• users - User accounts and roles
• signups - Vacation package signups with payment plan details
• payments - Payment transactions (initial, monthly, refunds)
• certificates - Issued vacation certificates with destination details

API Endpoints

Public Endpoints

• POST /api/signup - Create new vacation package signup
• POST /api/payment/create - Create initial/monthly payment
• POST /api/payment/confirm - Confirm payment status

Admin Endpoints

• POST /api/admin/refund - Process refund

Demo Access

Client Portal

• Email: any email
• Password: demo123

Admin Portal

• Email: any email
• Password: demo123

Project Structure

src/
├── app/
│   ├── api/                 # API routes
│   │   ├── admin/          # Admin endpoints
│   │   ├── payment/        # Payment endpoints
│   │   └── signup/         # Signup endpoint
│   ├── admin-portal/       # Admin dashboard
│   ├── client-portal/      # Client dashboard
│   ├── payment/            # Payment pages
│   └── page.tsx           # Landing page
├── components/
│   ├── ui/                 # shadcn/ui components
│   ├── auth-guard.tsx     # Authentication wrapper
│   └── login-modal.tsx    # Login modal
├── lib/
│   ├── auth.ts            # Authentication utilities
│   ├── maverick.ts        # Payment API integration
│   ├── supabase.ts        # Database client
│   └── utils.ts           # Utility functions
└── hooks/                 # Custom React hooks

Key Features Implementation

Payment Flow

1. User fills signup form with name, email, and phone
2. Creates signup record with payment plan details
3. Initiates first monthly payment via Maverick API
4. Redirects to payment checkout
5. On successful payment, creates user account and certificate
6. User can access client portal to manage vacation and payments

Admin Refund Process

1. Admin views active payment plans
2. Clicks refund button on any customer
3. Confirms refund amount
4. Processes refund via Maverick API
5. Updates payment and signup status
6. Notifies user via email (future enhancement)

Certificate Management

• Automatic certificate generation on first payment completion
• Destination-specific certificates with resort details
• Downloadable PDF certificates
• 18-month validity period
• Booking instructions included

Development

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint

Database Operations

• npm run db:push - Push schema to database
• npm run db:generate - Generate Prisma client
• npm run db:migrate - Run database migrations

Security Features

• Role-based access control
• Protected API endpoints
• Input validation and sanitization
• Secure payment processing
• HTTPS enforcement in production

Business Benefits

For Customers

• Affordable luxury vacations ($39/month)
• Flexible payment plans
• Access to premium resorts
• No obligation to purchase timeshare
• Excellent customer support

For Business

• Recurring revenue model
• High customer lifetime value
• Low acquisition costs through presentations
• Scalable business model
• Comprehensive admin tools

Future Enhancements

• Email notifications and reminders
• Advanced analytics dashboard
• Mobile app for customers
• Integration with calendar systems
• Automated payment processing
• Multi-language support (Spanish/English)
• Additional destinations

Support

For support and questions, please contact:

• Email: support@mexicoparadise.com
• Phone: 1-800-MEXICO
• 24/7 Travel Support Available

License

This project is licensed under the MIT License.