Skip to content

DynamicsCrm.DevKit.Config.json

PhuocLe edited this page Jun 20, 2026 · 4 revisions

DynamicsCrm.DevKit.Config.json is a VSIX configuration file stored in the Visual Studio solution root. It is separate from the connection file DynamicsCrm.DevKit.json and the CLI profile file DynamicsCrm.DevKit.Cli.json.

The VSIX uses this file for two local solution features:

  • Web resource mappings: a local file path mapped to a Dataverse web resource.
  • Custom T4 templates: user-edited template bodies used by item-template customization dialogs.

Schema

{
  "WebResources": [
    {
      "File": "src\\entities\\account.ts",
      "WebResource": "new_/entities/account.js",
      "WebResourceId": "00000000-0000-0000-0000-000000000000",
      "IsManaged": false,
      "SolutionUniqueName": "devkit"
    }
  ],
  "CustomTemplates": [
    {
      "Type": "Plugin",
      "Title": "Default - Plugin",
      "Body": "<custom t4 body>",
      "IsDefault": true
    }
  ]
}

WebResources

WebResources is updated by VSIX commands such as deploy web resource, deploy new web resource, deploy TypeScript release, and deploy new TypeScript release.

Field Description
File Local file path selected in Visual Studio.
WebResource Dataverse web resource unique name, for example new_/js/account.js.
WebResourceId Dataverse web resource ID cached after lookup or creation.
IsManaged Whether the selected Dataverse web resource is managed.
SolutionUniqueName Solution unique name used when creating or adding the web resource.

Once a mapping exists, DevKit can deploy the same local file again without asking the user to select the Dataverse web resource every time.

CustomTemplates

CustomTemplates is updated by the T4 customization UI used by item templates.

Field Description
Type Item type, such as Plugin, Workflow, CustomApi, CustomAction, DataProvider, LateBound, JsForm, or TsForm.
Title Template display name in the customization dialog.
Body Saved T4 template body.
IsDefault Whether this custom template should be selected by default for the item type.

Default template names are reserved by the VSIX and cannot be duplicated by a custom template title.

Relationship To Other Files

File Purpose
DynamicsCrm.DevKit.json Saved Dataverse connections.
DynamicsCrm.DevKit.Cli.json CLI command profiles.
DynamicsCrm.DevKit.Config.json VSIX web resource mappings and custom T4 templates.

Related pages:

Clone this wiki locally