Changelog Support Author Profile

License & System Updates

SpotVibe features a built-in Auto-Upgrade system and License Activation Gate. Administrators can verify their Envato purchase code and perform automated system updates directly from the Admin Panel under Settings > Version & Update.

1. Feature Overview

The Auto-Upgrade utility simplifies code updates by allowing administrators to upload the official release ZIP file directly through the web interface, bypassing manual SSH or FTP file transfers.

2. Server & Environment Requirements

For the update system to function correctly, ensure your server meets the following requirements:

⚠️ PHP UPLOAD LIMITS: Because release ZIP packages typically exceed default PHP upload restrictions, you must ensure your server's PHP configuration has sufficient upload capacities. We recommend modifying your server's php.ini configuration as follows: 
upload_max_filesize = 256M
post_max_size = 256M
memory_limit = 512M

3. License Activation (Verify Purchase Code)

To unlock system updates, administrators must activate the system with a valid Envato Purchase Code. If you bypass the installation wizard during setup, you can verify your purchase code directly from this page:

  1. Retrieve your Envato Purchase Code from the Envato Downloads page.
  2. Navigate to **Admin Panel > Settings > Version & Update**.
  3. Under the License Activation card, input your purchase code (e.g., 84869c9b-6484-4861-b924-d9bc5740be84).
  4. Click the green Verify License button.
🔒 Permanently Locked License: Once verified successfully, your purchase code and verification token are saved to settings. For security, the input field will be permanently locked (read-only) and the button will change to Check for Updates.
Admin Portal - License Activation & Update Check

4. Automated System Upgrade Steps

Perform updates in a few simple steps directly within the panel:

  1. Backup Database: Make a complete database backup via cPanel, phpMyAdmin, or your preferred tool. Always backup database data before upgrading!
  2. Download Package: Download the latest SpotVibe release package ZIP (named like SpotVibe-v1.1.0.zip) from your Envato Downloads page.
  3. Upload Package: Drag and drop the entire downloaded ZIP file directly into the upload zone on the **Version & Update** page. Do not unzip the file locally. The system is designed to automatically process the Envato zip package, locate the internal Source_Code/ folder, and extract only the necessary code files to execute the upgrade.
  4. Confirm Backup: Check the confirmation box acknowledging you have backed up the database.
  5. Start Upgrade: Click the Start Upgrade button. The system will automatically execute the following steps in the background:
    • Put the application into Maintenance Mode.
    • Locate and extract the update contents from the internal Source_Code/ directory.
    • Overwrite the core codebase files safely.
    • Execute database migrations (php artisan migrate).
    • Clear system caches (config, routes, views, app cache).
    • Take the application out of Maintenance Mode.
    • Clean up temporary ZIP and extraction files.
Admin Portal - Automated Upgrade Process

5. File Overwrites & Preservations (File Mapping)

The update system is designed to overwrite only core system files while completely preserving your custom configurations, database files, and uploaded user assets:

Overwritten & Replaced (Core Files) Preserved & Untouched (User Data)
app/ — Controllers, models, service components .env — System environment configurations
config/ — Global configuration maps database/database.sqlite — Local SQLite database (if used)
resources/ — Global views, assets, and design layouts storage/ — User uploads, invoices, avatars, and log files
routes/ — Route definitions public/storage — Physical directory containing your media uploads
database/migrations/ — Schema migration files
public/ — Compiled system CSS/JS assets
lang/ — Localized translation dictionaries
version.json — Active version identifier file

6. Troubleshooting & Upgrade FAQs