# Installing for .Net 5 & Above

Bunifu Framework is always pushing ahead in compatibility with newer releases of .NET. As of this writing, we currently support the latest releases of .NET including: 5, 6, 7, 8.

> **IMPORTANT**
>
> For those migrating their projects from .Net Framework to newer releases of .NET (e.g. 8.0), please be advised that we have revamped our licensing architecture from the old .Net Framework standard. Therefore, right after installing any Bunifu UI version from **7.0.0 and above**, please ensure you delete the "**Licenses.licx**" file in **Solution Explorer > Properties** section, then **clean and rebuild your project**. All our releases starting from version 7.0.0 support .NET 5 and above.

&#x20;

## 1. Quick Installation

To install [Bunifu UI](https://www.nuget.org/packages/Bunifu.UI.WinForms/) via NuGet Package Manager Console, run:

```
Install-Package Bunifu.UI.WinForms
```

To install [Bunifu Charts](https://bunifuframework.com/products/buni-charts/), run:

```bash
Install-Package Bunifu.Charts.WinForms
```

## 2. Guided Installation

* Begin by launching [Visual Studio](https://visualstudio.microsoft.com/vs/) (preferably **2019** and above). For this demo, we will use Visual Studio 2022.
* Click on **Create New Project** (You can create a **C#** or **VB.NET** project), then choose your project type:

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FRfu6X69wsDKe4RbWtDkF%2Fvs-create-project-01.png?alt=media&#x26;token=b6593fa8-054b-4124-8515-377eef53cce7" alt=""><figcaption><p>Choosing the project type</p></figcaption></figure>

* Enter your project name and choose the project directory:

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FIQgUyhLYFrszyhXBBjqC%2Fvs-create-project-02.png?alt=media&#x26;token=33ce6440-ba86-40b7-8b92-693dec0fa88e" alt=""><figcaption><p>Editing the project and solution name</p></figcaption></figure>

* Select your project's target framework. As of this writing, you can choose from several options including .NET 5, 6, 7 or 8. In our case, we'll proceed with **.NET 8.0 (Long Term Support):**

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2F2ObQGHABCS4Tx4GLlTzS%2Fvs-create-project-04.png?alt=media&#x26;token=25a2e0d6-8772-46c0-b6fb-5cb539ab50ed" alt=""><figcaption><p>Selecting the target framework</p></figcaption></figure>

* Once done, simply hit enter or click **Create** for Visual Studio to build your project. The project will be created and a window similar to this will be visible:

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FszEVh06if5nSmosC0OhI%2Fvs-create-project-06.png?alt=media&#x26;token=28b75fc5-e2e2-47eb-a429-23a9dba57bbd" alt=""><figcaption><p>New .NET 8 project created</p></figcaption></figure>

* From here, proceed to launching NuGet Package Manager, the package manager which hosts Bunifu UI and that we will use to install the product directly in our new project. To do this, in Visual Studio's menu, go to **Project > Manage NuGet Packages...**

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FpygbP8LQa7IzCpuoApov%2Fvs-create-project-07.png?alt=media&#x26;token=89676f41-4472-4e52-9e03-5239f31c9436" alt=""><figcaption><p>Accessing NuGet Package Manager</p></figcaption></figure>

* In the search input displayed within the *Browse* tab, type "**Bunifu**" and click **Install**:

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FiAmJJy98E3zIQ93OrEzG%2Fvs-create-project-08.png?alt=media&#x26;token=9b944002-abd7-44f8-ae30-ad7ba172a77b" alt=""><figcaption><p>NuGet Package Manager - Installing Bunifu UI</p></figcaption></figure>

* You will then be required to accept the license terms before installing. Ensure you accept them and proceed to finishing the installation process:

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FGfajBLHhH2qMejcdxZ2F%2Fvs-create-project-09.png?alt=media&#x26;token=486ee521-af81-4af4-b50f-abdf7e25bc73" alt=""><figcaption><p>License Acceptance window</p></figcaption></figure>

* Once completed, switch back to your **Form1** Designer and (depending on where your Toolbox is), open the Toolbox to the left panel area of Visual Studio. There you will see the list of UI controls populated for you to start using in your project:

> It may take some few seconds before the controls appear in the Toolbox. However, after a minute or so, in case you happen not to see Bunifu controls appear, close the Toolbox then reopen it by accessing the **View** > **Toolbox** sub-menu. Alternatively, you can use a keyboard shortcut by pressing `Ctrl+Alt+X` having closed the Toolbox. This action will refresh the Toolbox.

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FFhPdgU3NZigJiB9CPrgE%2Fvs-create-project-10.png?alt=media&#x26;token=4daf927b-5476-4729-94f6-e947b469bcfd" alt=""><figcaption><p>Installed Bunifu UI controls in the Toolbox</p></figcaption></figure>

* Now go ahead and **add any control** to your **Form**. This is where you will be required to **provide your license details:**

![License Activation window](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MU9ByzET5Rr2LsECOrN%2F-MUIGDVbn0RjHhBw343l%2Fimage.png?alt=media\&token=c3a62872-8798-4ed1-a53c-4ba1e8dbcf45)

* **Enter your license information** which you received after purchasing your license then *hit 'Enter'*. Once your license is validated and activated for your device, an activation success dialog will popup confirming your license has been **activated:**

![License activated successfully](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MU9ByzET5Rr2LsECOrN%2F-MUIGfiRF3hOb3NQygCK%2Fimage.png?alt=media\&token=147d5ead-308d-4340-a791-51150a823b88)

* If you have an [**Ultimate Bundle License**](https://bunifuframework.com/pricing/) with several products, feel free to select the product(s) as shown below to activate the entire products bundle on your device:

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MU9ByzET5Rr2LsECOrN%2F-MUIHGqvqrrHsfKXTj34%2Fimage.png?alt=media\&token=13d465a7-01a4-4fa3-96d9-546626a11376)

* Once the activation is successful, the control you dragged will successfully be added to your form:

<figure><img src="https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M7fmEPVv4n0I819sdaz%2Fuploads%2FEiCfnBleDoURsWApmQhQ%2Fvs-create-project-11.png?alt=media&#x26;token=729218ae-cb97-477f-af6c-15145cec989b" alt=""><figcaption><p>Newly added Bunifu Button control after license activation</p></figcaption></figure>

## Need Help?

If you face any issues during activation, please don't hesitate to reach out to us using the chat bubble at the bottom right area of our homepage.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs2.bunifuframework.com/docs/getting-started/installation-net5plus.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
