---
updatedAt: 2025-06-19T12:22:33.000Z
agentTools:
  projectIndex: https://developers.directscale.com/llms.txt
---

# Getting started with the Client Extension

Learn how to configure and enable the client extension

> 📘 Steps to get started with the Client Extension
>
> The following steps must be completed prior to [Building the Client Extension](https://developers.directscale.com/docs/building-the-client-extension) and [Deploying A Build Version](https://developers.directscale.com/docs/deploying-a-build-version)
>
> 1. [Create a GitHub Repository](#create-a-github-repository)
> 2. [Configure the Extension Settings](#configure-the-extension-settings)

> 👍 Recommended tools for developing the Client Extension
>
> These tools will be referenced throughout the Client Extension articles. These are not required and you may use other IDE's and Web Debugging tools.
>
> * IDE: Microsoft **Visual Studio 2019** or **2022** - *Here is[Microsoft's Tutorial: Visual Studio IDE Docs](https://docs.microsoft.com/en-us/visualstudio/ide/)* to get started.
>   * Install the .NET Core 3.1, .NET 5 or .NET 6 Runtime Component
> * Debug Tool: **Ngrok** - *Here is[Ngrok's Tutorial: Getting Started](https://ngrok.com/docs)*

<br/>

# Create A GitHub Repository

***

Currently, GitHub is the only supported Git platform for the Client Extension.

> 📘 New to GitHub?
>
> Here is the [GitHub: Quickstart Guide](https://docs.github.com/en/github-ae@latest/get-started/quickstart)

> 👍 Best Practice for creating and managing your repository
>
> It is recommended that a client creates their repository from an [Organization](https://docs.github.com/en/github-ae@latest/organizations/collaborating-with-groups-in-organizations/about-organizations) account and then adds users to the organization. This allows for better management of users that can collaborate with the repository. See [Types of GitHub accounts](https://docs.github.com/en/github-ae@latest/get-started/learning-about-github/types-of-github-accounts) to understand the differences between an Organization and a Personal account.
>
> If you are using a Personal account you can always [Transfer the Repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository) to an Organzation account

## Initialize Repository From A Template

Want to get started quickly? Create your repository from our [Template Repo](https://github.com/DS-Partners/ClientExtension) on GitHub that has a ASP.NET 5 MVC Web Application project with the Directscale Nuget Package already referenced. Learn how by reading [GitHub's Tutorial: Creating a repository from a template](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)

> 👍 It's recommended that you update the reference to the [Directscale Client Library](https://www.nuget.org/packages/DirectScale.Disco.Extension.Abstractions/) to the latest version after creating a Repository from our template. See how to [Update a package](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio#update-a-package) with Microsoft Visual Studio

## Initialize Repository Manually

Want to set up the repository yourself instead of using our [template](#initialize-repository-from-a-template)? Follow the steps below to make sure everything is set up properly for [Building the Client Extension](https://developers.directscale.com/docs/building-the-client-extension).

> 📘 View the source code for the [ACME Client Extension](https://github.com/DS-Partners/AcmeClientExtension) to reference as an example.

### Add A Web Application Project

Add an ASP.NET Core Solution with one Web App Project to the GitHub Repository by following [Microsoft's Tutorial: Get started with C# and ASP.NET Core in Visual Studio](https://docs.microsoft.com/en-us/visualstudio/get-started/csharp/tutorial-aspnet-core?view=vs-2022)

> 🚧 Make sure to leave the *"Place solution and project in the same directory"* setting shown in Figure 1 below unchecked so the project will be configured properly for [Building the Client Extension](https://developers.directscale.com/docs/building-the-client-extension)

<Image title="csharp-name-your-aspnet-app.png" alt={1014} width="80%" src="https://files.readme.io/cc18c2b-csharp-name-your-aspnet-app.png">
  Figure 1: An image displaying a setup modal where the project is named.
</Image>

### Add The Directscale Client Library

Reference [Getting Started with the Library](https://developers.directscale.com/docs/getting-started-with-the-c-sharp-library) to see how to add the Client Library to The Web Application project.

> 🚧 The following configurations must be followed for the Client Extension to build properly.
>
> * Must use one of the following versions of .NET. (.NET Core 3.1, .NET 5, or .NET 6) and have one Web Application project in the Solution.
> * The *Web Application Project* folder must be a top-level folder in the repository.
> * The .csproj file must be located in the Web App Project Folder
> * The .dll file built from the web application project must be the same name as the project
>
> ```
> 📂 ACMEClientExtension (Repository Name)
>    |--- 📂 .git
>    |--- 📂 ACMEClientExtension (Web Application Project)
>    |        |--- ACMEClientExtension.csproj
>    |        |--- 📂 bin
>    |        |        |___ 📂 Release
>    |        |                 |___ 📂 net5.0
>    |        |                          |___ACMEClientExtension.dll
>    |        |                          |___...
>    |        |___...
>    |--- ACMEClientExtension.sln
>    |___ .gitignore
> ```

<br/>

# Configure the Extension Settings

***

## API Keys

Once the GitHub Repository has been successfully created, you can begin the Client Extension configuration process by configuring the API Keys. API keys are used to secure the communication between Directscale and the Client Extension. Learn how by reading [Configuring API Keys](https://developers.directscale.com/docs/configuring-api-keys).

## Invite The Directscale GitHub User

Directscale requires access to the GitHub repository to [Build the Client Extension](https://developers.directscale.com/docs/building-the-client-extension). This is done by inviting the [DS-Partners](https://github.com/DS-Partners) GitHub User to the repository.

* Read how: [GitHub: Inviting Collaborators to a Personal Repository](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository)
* If you have an organization GitHub account, then you have more control over what permissions you grant DirectScale: [GitHub: Permission Levels for an Organization](https://help.github.com/en/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization)

> 📘
>
> The DS-Partners user needs permission to clone the repo and add Git Tags for the client extension to work properly.

## Github Extension Settings

> 👍 Unable to view Github Extension Settings?
>
> [Contact Customer Care](https://help.directscale.com/hc/en-us/requests/new) for additional assistance with enabling this feature.

Before [Building the Client Extension](https://developers.directscale.com/docs/building-the-client-extension), you must grant DirectScale access to your GitHub Repository by completing the GitHub Extension Settings in **<Glossary>Corporate Admin</Glossary>**. Here, you can provide the applicable repository details and accept the GitHub invitation on behalf of DirectScale.

1. Log into your **<Glossary>Corporate Admin</Glossary>**.
2. Navigate to Tools > Developer Tools > Extension Settings.
3. Complete the following fields:
   * Repository URL - The URL of the GitHub Repository (*ex:<https://github.com/DS-Partners/AcmeClientExtension>*)
   * Default Branch (*likely "main"*)
   * Web App Project Name

> 📘 The Web App Project Name must match the name of the subfolder created within your Github Repository.\
> *Ex: If the[Client Extension template](https://developers.directscale.com/docs/getting-started-with-the-client-extension#initialize-repository-from-a-template) was utilized, then the Web App Project Name will be "ClientExtension"as shown in the folder structure below.*
>
> ```
> 📂 YourRepositoryName (Repository folder)
>    |--- 📂 .git
>    |--- 📂 ClientExtension (Web App Project Name) <--- **Enter the name of this subfolder**
>    |        |--- ClientExtension.csproj
> ```

<Image title="CA-DevTools-GitHubExtensionSettings.png" alt={513} src="https://files.readme.io/288e382-CA-DevTools-GitHubExtensionSettings.png">
  Figure 2: An image displaying GitHub Extension Settings configuration.
</Image>

> 🚧 The fields above are case-sensitive. All entries are required and must be complete. Failure to do so may cause an error when [Building the Client Extension](https://developers.directscale.com/docs/building-the-client-extension).

4. Click the Refresh button to automatically search and locate the invitation extended to DirectScale.

<Image title="CA-DevTools-GitHubExtensionInvitation.png" alt={678} src="https://files.readme.io/cebb625-CA-DevTools-GitHubExtensionInvitation.png">
  Figure 3: An image displaying the DirectScale GitHub invitation.
</Image>

> 👍 An invitation will not display if the Repository URL is blank or incorrect.

5. Click 'Accept' to accept the GitHub invitation and save the configuration settings.