Skip to content

Microsoft Bot Framework Template — Getting Started

Install template

When the installer NuGet is published for your pipeline, install and scaffold (short name is connectsoft-microsoft-bot-framework):

dotnet new install <ConnectSoft.MicrosoftBotFrameworkTemplate.Installer-or-equivalent>
dotnet new connectsoft-microsoft-bot-framework -n MyBotService

Confirm package identity and flags in the repo .template.config/template.json and template/microsoft-bot-framework.template.extend.json; merged metadata may differ from the checked-in stub.

Submodule

After cloning the template repository (not only from dotnet new output), initialize Layer 2:

git submodule update --init --recursive

Run locally

From the repository or generated tree, build and run the Application project (exact path matches your solution name), configure appsettings and Microsoft Bot Framework per repo docs/Microsoft Bot Framework.md:

dotnet run --project src/ConnectSoft.MicrosoftBotFrameworkTemplate.Application/ConnectSoft.MicrosoftBotFrameworkTemplate.Application.csproj

(Replace with your scaffolded project name if different.)

Docker

  • Single image: src/ConnectSoft.MicrosoftBotFrameworkTemplate.Application/Dockerfile — build context is the repository root.
  • Compose: ConnectSoft.MicrosoftBotFrameworkTemplate.DockerCompose — see repo README for context paths and Visual Studio F5 notes.

Next