> For the complete documentation index, see [llms.txt](https://docs.gapvelocity.ai/webmap-for-blazor-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gapvelocity.ai/webmap-for-blazor-documentation/blazor-ai-migrator/developer-initial-setup.md).

# Developer Initial Setup

1. #### **Core Environment & Infrastructure**

* IDE: Visual Studio 2022 is the required standard for this project.
* VPN Connection: You must be connected to the VPN to view GAP packages and open the DCP (Development Control Plane).
* Account Syncing: Your local machine account must be linked/configured with your GAP account to ensure seamless access to NuGet packages.
* Helpdesk Permissions: Ensure you request all necessary permissions from HelpDesk before starting the setup.

2. #### **Telerik Configuration**

* GAP Email Registration: You must create a Telerik account using your GAP email address.
* Authentication: This account is mandatory; the system will prompt for these credentials whenever it attempts to resolve or restore Telerik packages.

3. #### **Code Quality & SonarQube**

* SonarCloud Access: Log in to [sonarcloud.io](http://sonarcloud.io/) using your GAP credentials.
* SonarLint Extension: To identify *Code Smells* in real-time, install the [SonarLint for Visual Studio 2022](https://marketplace.visualstudio.com/items?itemName=SonarSource.SonarLintforVisualStudio2022) extension.\
  \&#xNAN;*Note: Contact Carlos Chevez to assist with the binding configuration.*

4. #### **Alpha Generation & Unit Testing**

* Mandatory Testing: You cannot generate Alphas in the Blazor DCP or the HTML Generator without Unit Tests.
* SonarQube Coverage: Any Alpha build must meet the code coverage threshold required by SonarQube; otherwise, the build process will fail.

5. #### **NuGet Packages & Pipelines**

* Manual NuGet Generation: The Blazor DCP does not generate NuGets automatically. You must navigate to the Pipeline, trigger a manual run, and select the required branch.
* HTML Generator: This tool handles Alphas but shares the same dependency: no Alpha will be created without Unit Tests.

6. #### **The Migrator (Special Requirements)**

* Framework Dependency: You must have .NET Framework 4.6 installed specifically for the Migrator to function.
* README Compliance: Strictly follow the steps outlined in the README file.
* Build Folder Programs: You must run two programs located in the `build` folder.\
  \&#xNAN;*Critical Note:* These programs point to a filesystem/folder that is only accessible via a Mobilize account.

7. DCP Solution Compilation Requirements

* Local NuGet Feed: Because the Telerik v12 packages are in [.zip](https://drive.google.com/file/d/17ChquKL4aZ1-VCqrCQnVhahNL_RaMUlB/view?usp=sharing) format, you must extract them to a local folder and add that folder as a Package Source in Visual Studio (Tools > NuGet Package Manager > Package Manager Settings > Packages Sources).

<figure><img src="/files/icIrg34viBEXjfyQa45T" alt=""><figcaption></figcaption></figure>

Steps to manually install Telerik v12 packages in Visual Studio, follow this steps to configure as local source:

* Click on 'Package Source' to view all available sources.
* Click the '+' (plus) button to add a new package source.
* Click the ellipsis button '...' to browse to the folder where you extracted the packages. Once selected, you can rename it for easier identification.
* Verify that the path points to the local folder and click 'Ok'.

Or you can follow Telerik download and installation from [Download](https://drive.google.com/file/d/1liBf26R58XQZSqtqLeiVBAQDEj7U-A8u/view?usp=sharing) to install DevExpress version 21, proceed by installing the Trial version.
