BikersBuddy is a comprehensive Laravel 10-based motorcycle review and comparison platform designed for motorcycle enthusiasts, dealers, and automotive businesses. This professional PWA (Progressive Web App) script provides everything needed to launch a modern motorcycle review website.

Key highlights include advanced motorcycle browsing by brand, type, and price range, comprehensive comparison tools, user review systems, Q&A functionality, and complete showroom directory integration. The platform features responsive design, SEO optimization, and powerful admin panel for content management.

Perfect for entrepreneurs looking to enter the automotive review market or existing businesses wanting to expand their digital presence in the motorcycle industry.

- PHP 8.1 or higher
- Laravel 10 framework
- MySQL 5.7+ or MariaDB 10.3+
- Apache 2.4+ or Nginx 1.15+
- Composer for dependency management
- Node.js and NPM for asset compilation
- Redis for caching (recommended)
- SSL certificate for HTTPS
- Minimum 2GB RAM and 10GB storage space
- GD or ImageMagick extension for image processing
- cURL extension enabled
- OpenSSL extension for secure connections
- Fileinfo extension for file type detection
- PDO extension for database connectivity
- Mod_rewrite enabled (for Apache)

# Motorcycle Review Website - Installation Guide

## Project Overview
This is a comprehensive motorcycle review and comparison website built with Laravel 10. The website allows users to browse motorcycles, compare specifications, read reviews, find showrooms, and get detailed information about bikes available in Bangladesh.

## System Requirements
- PHP 8.1 or higher
- MySQL 5.7 or MariaDB 10.3
- Composer
- Node.js & NPM (for asset compilation)
- Web Server (Apache/Nginx)
- SSL Certificate (recommended for production)

## Installation Steps

### Step 1: Upload Files to Server
1. First  Unzip the Script that you downloaded from Codecanyon.
2. Then go to “Script” folder you will get a file “Script.zip”
3. Now in your web hosting / cPanel  Click on “File Manager” and go to “public_html” folder. and Upload the “script.zip” file.
4. Finally Unzip the “script.zip” file that you just uploaded.

### Step 2: Database Setup
1. **Create Database:**
   - Go to your hosting control panel (cPanel/DirectAdmin)
   - Navigate to MySQL Databases
   - Create a new database (e.g., `your_domain_motorcycle_db`)

2. **Create Database User:**
   - Create a new MySQL user
   - Set a strong password for the user
   - Grant ALL PRIVILEGES to the user for the created database

3. **Import Database:**
   - Go to phpMyAdmin
   - Select your newly created database
   - Click on "Import" tab
   - Upload the `database.sql` file
   - Click "Go" to import the database structure and data

### Step 3: Environment Configuration
1. **Locate the .env file** in your website root directory
2. **Update Database Configuration:**
   ```
   DB_CONNECTION=mysql
   DB_HOST=localhost
   DB_PORT=3306
   DB_DATABASE=your_database_name
   DB_USERNAME=your_database_user
   DB_PASSWORD=your_database_password
   ```

3. **Update Application URL:**
   ```
   APP_URL=https://yourdomain.com
   ```

4. **Set Application Name:**
   ```
   APP_NAME="Your Motorcycle Website"
   ```

5. **Configure Email Settings (Optional):**
   ```
   MAIL_MAILER=smtp
   MAIL_HOST=your_smtp_host
   MAIL_PORT=587
   [email protected]
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   [email protected]
   ```

### Step 4: Set Permissions
Set the following folder permissions:
- `storage/` folder: 755 or 777
- `bootstrap/cache/` folder: 755 or 777
- All subdirectories in storage: 755 or 777

### Step 5: Verify Installation
1. Visit your website URL in a browser
2. The homepage should load showing motorcycles, brands, and other content
3. Test search functionality
4. Test motorcycle comparison feature
5. Check that all images are loading properly

## Post-Installation Configuration

### SSL Certificate Setup (Recommended)
1. Obtain an SSL certificate from your hosting provider or Let's Encrypt
2. Update APP_URL to use https:// instead of http://
3. Configure your web server to redirect HTTP to HTTPS

### Optimization Settings
1. **Enable PHP OPcache** for better performance
2. **Configure Redis** (if available) for caching:
   ```
   CACHE_DRIVER=redis
   SESSION_DRIVER=redis
   QUEUE_CONNECTION=redis
   ```

### Admin Access
- The admin panel can be accessed at: `yourdomain.com/admin/bb`
- Default admin credentials are provided in the database
- **Important:** Change admin password immediately after installation
- Username: [email protected]
- Password: Fn6HGXZZ3423415iA@f#$d9R32

## Troubleshooting

### Common Issues:

**1. White Screen/500 Error:**
- Check file permissions on storage and bootstrap/cache folders
- Ensure .env file has correct database credentials
- Check error logs in storage/logs/

**2. Database Connection Error:**
- Verify database credentials in .env file
- Ensure database user has proper privileges
- Check if database server is accessible

**3. Missing CSS/JS:**
- Clear browser cache
- Check if files were uploaded properly
- Verify APP_URL is correct

**4. Images Not Loading:**
- Check storage folder permissions
- Verify image paths in database
- Ensure storage is linked properly

## Important Notes

### Script Customization Requirements
This script requires customization for optimal use:

1. **SEO Content Customization:** Each page contains static descriptions and content for SEO purposes. These need to be customized based on your specific requirements and target market.

2. **Content Localization:** The script contains content specific to Bangladesh motorcycle market. You may need to customize this for your target location.

3. **Brand and Model Data:** While sample data is provided, you'll need to add/update motorcycle brands, models, specifications, and images according to your requirements.

4. **Design Customization:** Colors, logos, and styling may need to be customized to match your brand.

### Support and Customization

**Need Help with Customization?**

This script is designed to be functional out-of-the-box, but customization is typically required for:
- Content adaptation to your market
- SEO optimization for your target keywords
- Adding/modifying motorcycle data
- Design and branding changes
- Additional features or modifications

For professional customization services, please contact us at:
**Email:** [email protected]

We provide customization services for an additional charge based on your specific requirements. Our team can help you adapt the script to your needs, add new features, optimize for your market, and provide ongoing support.

## License and Usage
Please refer to the license file included with this script for terms and conditions of use.

---

**Thank you for choosing our Motorcycle Review Website Script!**

For any technical issues during installation, please don't hesitate to reach out to our support team.