Files

Epic Travel & Expeditions - Complete Package

🌍 Overview

Epic Travel & Expeditions is a full-stack travel booking website with admin dashboard, available in two deployment versions:

  1. Python/MongoDB - For modern cloud platforms (Vercel, Railway, Render, etc.)
  2. PHP/MySQL - For traditional cPanel hosting (FTP upload only)

📦 What's Included

Application Code

epic-travel-complete/
├── frontend/                    # React 19 application
│   ├── src/                    # Source code
│   ├── public/                 # Public assets
│   └── build/                  # Production build
│
├── backend-python/             # FastAPI + MongoDB version
│   ├── routes/                 # API endpoints
│   ├── models/                 # Data models
│   └── server.py              # Main application
│
├── backend-php/                # PHP + MySQL version
│   ├── api/                   # API endpoints
│   ├── includes/              # Core functionality
│   └── index.php              # Main router
│
├── deployment-packages/
│   ├── php-cpanel/            # Ready-to-upload PHP package
│   └── python-cloud/          # Python deployment package
│
└── documentation/
    ├── INSTALLATION_PYTHON.md
    ├── INSTALLATION_PHP.md
    ├── MIGRATION_GUIDE.md
    └── PRD.md

Features

Public Website

  • 🏖️ Travel destinations gallery with 12+ locations
  • 💰 Weekly special offers with discount badges
  • 🔍 Search and filter destinations
  • Customer testimonials
  • 📧 Contact form
  • 📰 Newsletter subscription
  • 📱 Fully responsive design

Admin Dashboard

  • 🔐 Secure JWT authentication
  • Add/Edit/Delete destinations
  • 🖼️ Image upload functionality
  • 🎯 Manage weekly specials
  • 💯 Set discount percentages
  • 📅 Configure offer expiry dates
  • 🔄 Real-time updates

🚀 Quick Start

Option 1: PHP/MySQL (cPanel Hosting)

Best for: Standard shared hosting with cPanel Requirements: PHP 7.4+, MySQL 5.7+, FTP access

1. Extract php-cpanel package
2. Upload via FTP to public_html/
3. Create MySQL database in cPanel
4. Import database_schema.sql
5. Edit config.php with credentials
6. Visit setup_password.php
7. Done! (15 minutes)

📖 See: INSTALLATION_PHP.md

Option 2: Python/MongoDB (Cloud Platforms)

Best for: Modern cloud hosting (Vercel, Railway, Render) Requirements: Python 3.8+, MongoDB, Node.js

1. Clone repository
2. Install dependencies
3. Configure environment variables
4. Deploy frontend to Vercel
5. Deploy backend to Railway/Render
6. Done!

📖 See: INSTALLATION_PYTHON.md

🛠️ Technology Stack

Frontend

  • React 19
  • Tailwind CSS
  • Shadcn UI Components
  • React Router
  • Axios

Backend (Python Version)

  • FastAPI
  • MongoDB + Motor
  • JWT Authentication
  • Bcrypt
  • Pydantic

Backend (PHP Version)

  • PHP 7.4+
  • MySQL with PDO
  • Custom JWT Implementation
  • Password Hashing
  • Object-Oriented Design

📋 Installation Guides

PHP/cPanel (No SSH Required)

Perfect for traditional hosting providers:

  • No command line needed
  • Upload via FTP or File Manager
  • Browser-based setup
  • Works on shared hosting
  • 15-minute installation

Read: deployment-packages/php-cpanel/README.md

Python/Cloud

For modern deployment platforms:

  • Kubernetes ready
  • Docker compatible
  • Auto-scaling support
  • Environment-based config
  • CI/CD friendly

Read: deployment-packages/python-cloud/INSTALLATION.md

🎯 Use Cases

  1. Travel Agency Website

    • Showcase destinations
    • Manage bookings
    • Special promotions
  2. Tourism Board

    • Promote local attractions
    • Visitor information
    • Travel guides
  3. Travel Blog

    • Destination reviews
    • Travel tips
    • Photo galleries

🔐 Default Credentials

Admin Portal: /admin

  • Email: admin@epictravel.com
  • Password: Set during installation

⚠️ Security: Change password immediately after first login!

📞 Contact Information

Company: Epic Travel & Expeditions Email: advisor@epictravelexpeditions.com Phone: +1 (817) 266-2022 Location: Weatherford, Texas 76088

🤝 Support

Documentation

  • Installation guides for both versions
  • Troubleshooting sections
  • API documentation
  • Database schema

Getting Help

  1. Check relevant installation guide
  2. Review troubleshooting section
  3. Check error logs
  4. Contact support

📄 License

This project is provided as-is for deployment and customization.

🎉 Success Stories

This application is production-ready and includes:

  • Security best practices
  • Performance optimizations
  • Comprehensive documentation
  • Two deployment options
  • Sample data included
  • Admin dashboard
  • Image uploads
  • Form validation
  • CORS configuration
  • SSL ready

📦 Package Contents

Deployment Packages

  1. php-cpanel.zip (790 KB)

    • Frontend production build
    • PHP backend
    • MySQL database schema
    • Setup scripts
    • Complete documentation
  2. python-cloud.tar.gz (781 KB)

    • Frontend source & build
    • Python FastAPI backend
    • MongoDB schemas
    • Docker configuration
    • Deployment guides

Documentation

  • INSTALLATION_PHP.md - cPanel/FTP installation
  • INSTALLATION_PYTHON.md - Cloud deployment
  • MIGRATION_GUIDE.md - MongoDB to MySQL migration
  • PACKAGE_INFO.md - Complete package details
  • PRD.md - Product requirements document

Source Code

  • Complete frontend React application
  • Both backend versions (Python & PHP)
  • Database schemas
  • Configuration templates
  • Helper scripts

🚀 Deployment Options

Platform Backend Database Difficulty Time
cPanel Hosting PHP MySQL Easy 15 min
Vercel + Railway Python MongoDB Medium 30 min
AWS/DigitalOcean Either Either Medium 45 min
Kubernetes Python MongoDB Advanced 2 hours

🔧 Customization

Easy to customize:

  • Branding and colors
  • Destination content
  • Contact information
  • Email templates
  • Payment integration
  • Booking system
  • Multi-language support

📈 Performance

  • Frontend: 152 KB gzipped
  • Fast page loads
  • Optimized images
  • Efficient database queries
  • Caching enabled
  • CDN ready

🔒 Security Features

  • JWT token authentication
  • Password hashing (bcrypt)
  • SQL injection prevention
  • XSS protection
  • CORS configuration
  • Input validation
  • Environment variables
  • Secure file uploads

🎨 Design

  • Modern, professional UI
  • Ocean & sky color theme
  • Responsive design
  • Smooth animations
  • Accessible components
  • Mobile-first approach

📝 Next Steps

  1. Choose Your Deployment Method:

    • PHP/cPanel for traditional hosting
    • Python/Cloud for modern platforms
  2. Read Installation Guide:

    • Follow step-by-step instructions
    • Complete setup in 15-30 minutes
  3. Customize Content:

    • Update destinations
    • Add your branding
    • Configure contact info
  4. Launch:

    • Test all features
    • Set up SSL
    • Go live!

🌟 Getting Started

  1. Extract this package
  2. Choose deployment method (PHP or Python)
  3. Follow the appropriate installation guide
  4. Customize for your needs
  5. Deploy and launch!

Questions? Contact advisor@epictravelexpeditions.com


Version: 1.0.0 Created: December 2025 Package Type: Complete Full-Stack Application

🚀 Ready to deploy your travel website? Pick your preferred method and get started!