Clone Repository

A personal ppl-app GitHub repository is created for every customer. Instructions for creating a GitHub account (if you don’t have one) as well as getting access to the repository, will be provided upon request.

It is highly recommended to use Visual Studio Code as your code editor. Visual Studio Code is ideal for cloning repositories, making changes to existing files, and adding or removing files. It is also useful for running your applications on a local machine, allowing you to troubleshoot or test newly developed applications.

Follow the instructions below to set up Visual Studio Code and clone the ppl-app repository.

Install Git

Before you begin, ensure that Git is installed on your computer, as it is required for cloning repositories.

Show For Windows

1. Open Web Browser

   Open your web browser and navigate to the Git official website.

2. Download Git

   Click on the Download for Windows button.

3. Install Git

   Once the download is complete, open the installer.

4. Follow Installation Instructions

   Follow the installation instructions, selecting the default options unless you have specific preferences.

Show For macOS

1. Open Terminal

   Open your Terminal (you can find it using Spotlight search).

2. Check Git Installation

   Type git --version and press Enter.

   • If Git is not installed, you’ll be prompted to install it. Follow the on-screen instructions.
   • Alternatively, you can download Git from the Git official website.

Install Visual Studio Code

1. Open Visual Studio Code

   Open your web browser and navigate to code.visualstudio.com.

2. Download Visual Studio Code

   Click on the Download button on the homepage.

3. Select Version

   Select the version that matches your operating system (Windows, macOS, or Linux).

4. Install Visual Studio Code

   Once the download is complete, open the installer and follow the on-screen instructions to install Visual Studio Code.

Log in to GitHub

1. Open GitHub

   Open your web browser and navigate to github.com.

2. Sign In

   Click on Sign in at the top right corner of the page.

3. Enter Credentials

   Enter your GitHub username or email address, followed by your password.

4. Access Account

   Click Sign in to access your GitHub account.

Get Repository URL

1. Search Repositories

   Once logged in, locate the search bar at the top of the GitHub page.

2. Search Direct Energy Partners

   Type “Direct Energy Partners” into the search bar and press Enter.

3. Find Repositories

   Browse through the list of repositories shared by Direct Energy Partners. You should see two repositories:

   • ppl-app
   • ppl-base
4. Select Repository

   Click on the ppl-app repository.

5. Get Repository URL

   On the repository page, click the green Code button.

6. Select HTTPS

   Ensure “HTTPS” is selected.

7. Copy URL

   Copy the URL provided.

Clone the Repository

1. Open Visual Studio Code

   Open Visual Studio Code on your local machine.

2. Clone Repository

   On the welcome screen or in the side menu, find and click on the Clone Repository option.

3. Enter Repository URL

   You’ll be prompted to enter a repository URL.

4. Paste Repository URL

   Paste the copied URL into the field that prompts for the repository URL.

5. Clone Repository

   Click Clone.

6. Choose Location

   You’ll be asked to choose a location on your computer where the repository files will be saved.

7. Download Repository

   After selecting the location, Visual Studio Code will start downloading the repository.

Alternatively, you can watch the instructional video with detailed steps here:

Once the repository is cloned, Visual Studio Code will automatically open the project for you. You can now start working on the files, make changes, and push them back to GitHub when you’re ready.