Skip to main content

Use DevExpress Templates to Create a WPF Viewer Application

  • 4 minutes to read

DevExpress Templates help you create a ready-to-use WPF application with a WPF Dashboard Viewer.

Project Template Kit (Visual Studio, Visual Studio Code, JetBrains Rider)

Use the Cross-IDE Project Template Kit to create a WPF application with a Dashboard Viewer.

Note

The DevExpress Template Kit includes project templates only for .NET 8+ and C#.

To create a WPF application with a Dashboard Viewer, follow the steps below.

  1. Install the DevExpress Project Template Kit extension. Refer to the following sections in the Project Template Kit help topic for instructions depending on the IDE of your choice:

  2. Select WPF or BI Dashboards in the Platforms list. Select the WPF BI Dashboard Viewer Application template:

    Project Template Kit - Application with WPF Dashboard Viewer

  3. Specify additional template options. Click Create Project to generate the project.

.NET CLI Templates

Use CLI Project Templates to create a WPF application with the BI Dashboard component.

Note

.NET CLI DevExpress Templates include project templates only for .NET 8+ and C#.

DevExpress WPF project templates are included in our Unified Component Installer.

You can also install the templates from nuget.org or the DevExpress NuGet Gallery (nuget.devexpress.com). If you are new to NuGet, visit the following page for additional information about package management prerequisites: An Introduction to NuGet.

Ensure that the nuget.org source is enabled. If it is disabled, you may encounter the NU1101: Unable to find package DevExpress.Wpf.ProjectTemplates error. To list sources with their status, run dotnet nuget list source. To enable a source, run dotnet nuget enable source <source name>.

To create a WPF application with a Dashboard Viewer, follow the steps below:

  1. Run the following command to install DevExpress WPF project templates from nuget.org:

    dotnet new install DevExpress.Wpf.ProjectTemplates
    
  2. Create a project with the Dashboard Viewer:

    dotnet new dx.wpf.dashboard -n WpfDashboardViewer
    

    You can use the following parameters to see available command options: -? | -h | --help. For example, execute the following command:

    dotnet new dx.wpf.dashboard --help
    
    Template Options

    The following list contains options you can specify when creating DevExpress WPF BI Dashboard project templates:

    -prerelease, --use-prerelease-dx-version
    A flag that indicates whether to use a pre-release DevExpress package version in the project.
    --framework <TFM>
    Specifies the target framework. It expects a target framework moniker (TFM). Example: net8.0.
    --dx-version <version>
    Specifies DevExpress package version to be used in the project. Examples: 25.2.3, 25.2.*, 25.2.*-*
    --dx-nuget-feed <feed>
    Specifies the NuGet Feed URL. Refer to nuget.devexpress.com to obtain your personal feed URL (available for registered users).
    -mcp, --use-devexpress-mcp
    Installs the DevExpress Documentation MCP Server for the generated solution. GitHub Copilot queries DevExpress documentation through this server to improve response accuracy and reduce model hallucinations. Refer to DevExpress Documentation MCP Server for setup details.

The DevExpress BI Dashboard App Template Gallery contains predefined templates for building the Dashboard Designer and Viewer applications for all supported platforms. All available Dashboard templates are listed in the following topic: Template Gallery.

The steps below show how to use DevExpress Template Gallery to quickly create a ready-to-use WPF Dashboard Viewer application.

Create a New Project

  1. In Visual Studio, create a new project. Select DevExpress v25.2 BI Dashboard App Template Gallery as the project template.

    GettingStarted_NewProject_DXTemplateGallery

    Click Next.

  2. Configure your new project and click Create. The Template Gallery opens.

Configure the Template

  1. In the invoked Template Gallery, select the target framework (.NET Framework or .NET).

  2. Select Dashboard Viewer Application in the WPF section. Specify the framework version and click Create Project.

    Template Gallery - WPF Dashboard Viewer Application

  3. Run the application to see the result.

    WPF Viewer Template - Result

    The WPF Viewer application displays a sample dashboard.

    Use the Visual Studio Designer to change the dashboard or create a new one.

Next Steps

Create Dashboards in the Visual Studio Designer
Describes how to create and configure dashboards in Visual Studio Designer.
WPF Viewer
Describes how to use the DashboardControl control to display a dashboard in a WPF application.
See Also