Deployment Guide

The "Zero-to-Hero" guide to setting up your projects locally. No experience? No problem.

1. The Toolkit

Think of this as gathering your ingredients before cooking. You need two main tools to turn your computer into a mini-server.

XAMPP Control Panel

This acts as your server. It handles PHP (the logic) and MySQL (the data).

Get XAMPP

WinRAR or 7-Zip

Most projects come as a .zip file. You need a tool to extract them into your server folder.

Get WinRAR

2. Setting Up the Server

01

Install XAMPP

Run the installer. If you see a warning about UAC, just click OK. Install it in the default path: C:\xampp.

02

Ignite the Engines

Open the XAMPP Control Panel. You need to click "Start" for two things:

Apache
MySQL

Wait until the names turn Green. If they don't, check the troubleshooting section.

3. Extracting the Project

01

Download your Zip

Click the download link provided after your selection. This will take you to a Google Drive folder. Download the .zip file to your computer.

02

Navigate to htdocs

Open your File Explorer. Navigate to C:\xampp\htdocs. This folder is magical—anything inside it can be accessed through your browser.

IMPORTANT: Move your downloaded .zip file into this htdocs folder before extracting.

03

Right-Click & Extract

Right-click the zip file and choose "Extract to [Project Name]\". This will create a clean folder with all your code inside.

You should now have a path like C:\xampp\htdocs\your-project-folder.

4. The Brain (Database)

01

Open phpMyAdmin

Open your browser (Chrome or Edge) and type localhost/phpmyadmin in the address bar. Press Enter.

02

Create a New Database

  • • Click on the "New" button in the left sidebar.
  • • Under "Database name", type the name of your project (use only lowercase letters and underscores, no spaces!).
  • • Click "Create".
03

Import the SQL File

Every project comes with an .sql file (usually inside a folder named db or database).

  • • Click on your newly created database in the left sidebar.
  • • Click the "Import" tab at the top.
  • • Click "Choose File" and find the .sql file inside your project folder.
  • • Scroll to the bottom and click "Go" or "Import".

5. Connecting the Dots

Now you need to tell the code where the database is.

01

Find the Config File

Open your project folder. Look for app/Config.php or config/db.php. Open it with NotePad or VS Code.

02

Update Credentials

In XAMPP, the default credentials are always:

PHP Config
'DB_HOST' => 'localhost',
'DB_USER' => 'root',      // XAMPP Default User
'DB_PASS' => '',          // Leave this empty!
'DB_NAME' => 'your_db_name_here'
                            

Save the file (Ctrl + S).

6. Ready to Launch!

The moment of truth. Open your browser and type:

Browser URL
http://localhost/your-project-folder/

Congratulations!

You've just deployed a full-stack application on your own machine. You're officially a developer!

Common Hiccups

Apache "Ports in Use" Error?

Usually, Skype or VMware stole the 80 port. Close them and try starting Apache again.

404 Not Found on Sub-Pages?

Make sure the project root directory contains the .htaccess file. If sub-pages fail, your Apache might need AllowOverride All enabled in its configuration.

Database Connection Error?

Did you start "MySQL" in XAMPP? Is your database name spelled exactly the same in phpMyAdmin and the config file?

Still feel like things are exploding?

Raise Support Ticket Chat on WhatsApp