1. Download & Install Android Studio

1. Open the official Android Studio download page: https://developer.android.com/studio.
2. Choose the build for your OS (Windows / macOS / Linux) and download the installer.
3. Run the installer and follow the setup wizard. Select the default options (Android SDK, Android SDK Platform, and Android Virtual Device) unless you have custom needs.
4. After installation, open Android Studio and complete the first-run setup (SDK download and recommended components).

2. Unzip the Project ZIP

1. Download the ZIP file from the link provided in the video description (or from https://me.friendvilla.in).
2. Right-click → Extract All (Windows) or double-click to extract (macOS). You can use tools like 7-Zip, WinRAR, or Finder.
3. Note about protected files: Free sample zips may be password-protected. The password is shown in the project's YouTube video — check the video description or pinned comment for the exact password.
4. After extraction you should have a folder named like YourProjectName with subfolders such as app/, README.md, LICENSE.txt, admin_panel/ (if included), etc.

3. Open the Project in Android Studio

1. Open Android Studio → File > Open (or Open an existing Android Studio project on the launcher).
2. Navigate to the extracted project folder and select the project root (the folder that contains build.gradle or settings.gradle), then click OK or Open.
3. Android Studio will sync Gradle. If prompted to update Gradle plugin or SDK, follow the prompts (or ask for guidance if unsure).
4. Wait for Gradle sync to finish and resolve dependencies. If any dependency fails, open the Event Log to read the error.

4. Change Basic App Details (App name, Logo, Package, Theme Color)

1. Change App Name (strings.xml)

   <!-- Open: app/src/main/res/values/strings.xml -->
   <string name="app_name">Your App Name</string>

2. Change App Icon / Logo
   1. Replace the files in app/src/main/res/mipmap-* or res/drawable with your icons.
   2. Or use Android Studio: Image Asset → Launcher Icons to generate icons from a PNG or SVG.
3. Change Package Name (safe method)
   1. Right-click the Java/Kotlin package in Project view > Refactor > Rename > select Rename package > follow prompts.
   2. After refactor, update applicationId in app/build.gradle if needed:

   android {
       defaultConfig {
           applicationId "com.yourcompany.yourapp"
       }
   }

   3. Clean & Rebuild Project.
4. Change Theme / Primary Color

   Open: app/src/main/res/values/colors.xml
   <color name="colorPrimary">#0B84FF</color>

   Update styles in res/values/styles.xml if the project uses MaterialTheme.

5. Admin Panel (cPanel) — Setup & Database

If the project includes an admin panel, follow these cPanel-based steps.

1. Create MySQL Database
   1. Login to your cPanel → MySQL® Databases.
   2. Create a new database (e.g., me_project_db).
   3. Create a database user and set a strong password. Add the user to the database with All Privileges.
2. Import Database (SQL)
   1. Open phpMyAdmin in cPanel.
   2. Select the newly created database > Import > choose the provided SQL file (usually db.sql) > Run.
3. Upload Admin Panel Files
   1. In cPanel, open File Manager > public_html (or a subfolder) > Upload the admin panel files/extract the admin zip there.
4. Edit Database Config (config.php or connection.php)

   Open the admin folder > includes/config.php or includes/connection.php and update DB credentials:

   <?php
     $hostname = 'localhost';
     $username = 'db_user';
     $password = 'db_pass';
     $database = 'me_project_db';
     // optional: define a base url constant
     define('BASE_URL', 'https://yourdomain.com/admin/');
   ?>

5. Collect Base URL for the App

   Note the admin panel base URL (for example: https://yourdomain.com/admin/) — this will be used inside the Android app as the API base URL.

6. Connect App → Admin Panel (Set Base URL in App)

1. Open the app's config file. Common filenames used in these projects:
   • app/src/main/java/.../Config.java or Constants.kt
   • app/src/main/res/values/strings.xml sometimes contains API URLs
2. Example Java Constant (Config.java):

   public class Config {
       public static final String BASE_URL = "https://yourdomain.com/admin/";
       public static final String API_LOGIN = BASE_URL + "api/login.php";
   }

3. Example PHP config that the app expects (server-side):

   <?php
     // includes/connection.php
     $link = mysqli_connect('localhost','db_user','db_pass','me_project_db');
     if (!$link) { die('DB connection error'); }
   ?>

4. After editing, rebuild the Android app and test API calls (Login, Fetch lists, Uploads) on a physical device or emulator connected to internet.

7. Common Troubleshooting

• Gradle sync errors → Check SDK versions & update Gradle plugin.
• Missing dependencies → Open build.gradle and add required libs or update repositories.
• API 401/403 → Verify BASE_URL, DB credentials, and API endpoints.
• Image / Media path issues → Check folder permissions on server and correct upload paths in config.

8. Notes & Best Practices

• Never commit production secrets (API keys / passwords) into public repos.
• Use .env.example locally and fill real secrets during deployment.
• Always keep a README with the required SDK and plugin versions.