Epic Travel & Expeditions - Complete Package
🌍 Overview
Epic Travel & Expeditions is a full-stack travel booking website with admin dashboard, available in two deployment versions:
- Python/MongoDB - For modern cloud platforms (Vercel, Railway, Render, etc.)
- 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
-
Travel Agency Website
- Showcase destinations
- Manage bookings
- Special promotions
-
Tourism Board
- Promote local attractions
- Visitor information
- Travel guides
-
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
- Check relevant installation guide
- Review troubleshooting section
- Check error logs
- 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
-
php-cpanel.zip (790 KB)
- Frontend production build
- PHP backend
- MySQL database schema
- Setup scripts
- Complete documentation
-
python-cloud.tar.gz (781 KB)
- Frontend source & build
- Python FastAPI backend
- MongoDB schemas
- Docker configuration
- Deployment guides
Documentation
INSTALLATION_PHP.md- cPanel/FTP installationINSTALLATION_PYTHON.md- Cloud deploymentMIGRATION_GUIDE.md- MongoDB to MySQL migrationPACKAGE_INFO.md- Complete package detailsPRD.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
-
Choose Your Deployment Method:
- PHP/cPanel for traditional hosting
- Python/Cloud for modern platforms
-
Read Installation Guide:
- Follow step-by-step instructions
- Complete setup in 15-30 minutes
-
Customize Content:
- Update destinations
- Add your branding
- Configure contact info
-
Launch:
- Test all features
- Set up SSL
- Go live!
🌟 Getting Started
- Extract this package
- Choose deployment method (PHP or Python)
- Follow the appropriate installation guide
- Customize for your needs
- 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!