# ⚡ Instagram Booster SMM panel by Pendu Coder

Instagram Booster is an automated, high-converting social media marketing reseller storefront explicitly tailored for selling Instagram services (followers, likes, views, comments, and bundles) on complete autopilot. Built on **Laravel 11** and **Livewire 3**, it connects to SMM panel providers to fulfill client orders instantly.

This product is ready for listing and deployment, customized specifically for **penducoder.store**.

![Instagram Booster Mockup](public/uploads/instagram_booster_mockup.png)

---

## 🌟 Key Features

- **Dynamic Profile Preview**: Fetches real Instagram avatars, follower metrics, and verification badges before checkout using a private API or a public HTML fallback.
- **SMM Panel API Reselling**: Seamless integration with API providers using the v2 API structure (e.g., key, action, service, link, quantity).
- **Profit Margin Safety Net**: Monitors upstream SMM cost changes via cron and automatically disables storefront packages if your profit margin falls below the defined `min_profit_margin`.
- **Flexible Gateways**: Paytm QR integration with automated redirection, alongside custom manual payment gateways (UPI, Bank, Crypto) with client Transaction ID validation.
- **Admin Control Dashboard**: Total control over SMM provider accounts, client orders, categories, custom packages, payment method active status, and cron histories.
- **Livewire 3 & Tailwind Architecture**: Extremely fast, fluid, single-page application feel with a mobile-responsive interface.

---

## 🛠️ Tech Stack & Requirements

- **PHP**: `>= 8.2` (with JSON, Curl, OpenSSL, and PDO extensions enabled)
- **Database**: SQLite (default configuration), MySQL 8.0+, MariaDB, or PostgreSQL
- **Dependency Manager**: Composer
- **Zip Release**: Contains pre-compiled `vendor` modules and public assets, allowing simple cPanel extract-and-go installation.

---

## 🚀 Installation & Quick Start

For a visual, step-by-step interactive setup guide, open the [install-guide.html](install-guide.html) file in your browser.

### Easy Host Setup (cPanel / Shared Hosting)
1. **Upload & Extract**: Upload `Instagram Booster.zip` to your cPanel file manager and extract it. Ensure your domain points to the `/public` directory.
2. **Environment Configuration**: Copy `.env.example` to `.env` and fill in your APP_URL and DB credentials.
3. **Database Setup**: Open the cPanel Terminal or SSH, then run:
   ```bash
   php artisan key:generate
   php artisan migrate --force --seed
   php artisan storage:link
   ```
4. **Permissions**: Set `storage` and `bootstrap/cache` directories write permissions to `775` or `755`.

---

## 🔑 Admin Portal Credentials

After migrating with the `--seed` flag, the following administrator account is generated:

- **Login URL**: `https://yourdomain.com/login`
- **Email**: `admin@example.com`
- **Password**: `password123`

> [!WARNING]
> Access the profile settings page immediately upon logging in and change the default email and password credentials for security.

---

## 🔄 Cron Job Configuration

To automate pricing updates and order status tracking, configure cron tasks on your web server:

### HTTP Trigger (Best for Shared Hosting/cPanel)
In cPanel Cron Jobs, schedule web requests using `curl` once every 30-60 minutes (protect them by setting `CRON_KEY` in your `.env`):
```bash
# Sync SMM provider prices once every hour
curl -s "https://yourdomain.com/cron/sync-prices?key=your_cron_key"

# Sync active order statuses every 10 minutes
curl -s "https://yourdomain.com/cron/sync-orders?key=your_cron_key"
```
