JanUI.WinForms 1.1.0

.NET 6.0

dotnet add package JanUI.WinForms --version 1.1.0

NuGet\Install-Package JanUI.WinForms -Version 1.1.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="JanUI.WinForms" Version="1.1.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="JanUI.WinForms" Version="1.1.0" />
                    

                            Directory.Packages.props

<PackageReference Include="JanUI.WinForms" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add JanUI.WinForms --version 1.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: JanUI.WinForms, 1.1.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package JanUI.WinForms@1.1.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=JanUI.WinForms&version=1.1.0
                    

                            Install as a Cake Addin

#tool nuget:?package=JanUI.WinForms&version=1.1.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

JanUI — WinForms Control Library

A modern, Bootstrap 5-inspired WinForms control library for .NET 6 and .NET 8. 21 fully custom-painted, theme-aware controls — no OS chrome, no native widget artifacts.

Screenshot

✨ Features

21 custom-painted controls — every control owns its GDI+ paint logic
3-layer theming system — user overrides → scheme tokens → JanTheme global
8 built-in colour schemes — Primary, Success, Danger, Warning, Info, Secondary, Light, Dark
VS2022 designer support — full Property Grid integration, ShouldSerialize/Reset pairs
Bootstrap 5-inspired — familiar API for web developers moving to desktop
Multi-target — net6.0-windows and net8.0-windows

📦 Installation

# NuGet Package Manager
Install-Package JanUI.WinForms

# .NET CLI
dotnet add package JanUI.WinForms

Requirements:

.NET 6+ or .NET 8+ (Windows only)
Add <UseWindowsForms>true</UseWindowsForms> to your .csproj
Target must include -windows suffix (e.g. net8.0-windows)
Visual Studio 2022 recommended

📘 Documentations & Demo | 👉 <a href="https://msujan.netlify.app/projects/janui/docs"> Visit Website</a>

🚀 Quick Start

using JanUI.WinForms.Controls;
using JanUI.WinForms.Themes;

// Apply a global theme to all Default-scheme controls
JanTheme.Apply(ThemePreset.Dark);

// Theme a single button
myButton.ThemeScheme = ColorScheme.Success;

// Show a toast notification
JanAlert.Show(this, "Saved successfully.", JanAlertType.Success, autoDismissMs: 3000);

// Collect user input
string? name = JanInputDialog.ShowText("Enter your name:");

// Load a data table
janTable1.Columns = new List<string> { "ID", "Name", "Status" };
janTable1.LoadData(GetRows());

🎨 Theming

Every colour resolves through three layers — first non-null wins:

Priority	Layer	How to set
1 (highest)	User — per-instance explicit override	`button.BackgroundColor = Color.Red`
2	Scheme — full palette via ThemeScheme	`button.ThemeScheme = ColorScheme.Danger`
3 (fallback)	JanTheme — application-wide global	`JanTheme.Apply(ThemePreset.Dark)`

Built-in colour schemes

button.ThemeScheme = ColorScheme.Primary;    // Bootstrap blue
button.ThemeScheme = ColorScheme.Success;    // Bootstrap green
button.ThemeScheme = ColorScheme.Danger;     // Bootstrap red
button.ThemeScheme = ColorScheme.Warning;    // Bootstrap amber
button.ThemeScheme = ColorScheme.Info;       // Bootstrap cyan
button.ThemeScheme = ColorScheme.Dark;       // Dark surface

🧩 Controls

Feedback & Notifications

Control	Description
`JanAlert`	Bootstrap-style inline alert + floating toast with auto-dismiss
`JanInputDialog`	Modal input dialog — Text, Number, Decimal, Password types
`JanLoaderControl`	Animated loading spinner overlay
`JanProgressBar`	Custom progress bar with sliding value label

Input Controls

Control	Description
`JanButton`	Flat-style button with hover/active states
`JanCheckBox`	Custom-painted checkbox with rounded corners
`JanComboBox`	Dropdown with single and multi-select + badge chips
`JanDatePicker`	Date selector with custom themed calendar popup
`JanDropdownMenu`	Fully-themed context menu with 8 colour schemes
`JanRadioButton`	Custom-painted radio button
`JanTextBox`	Text input with placeholder, password mask, underline style
`JanToggleButton`	On/off toggle switch

Control	Description
`JanCard`	Gradient card container with shadow and hover effect
`JanPanel`	Rounded panel with gradient background
`JanSidebar`	Expandable navigation sidebar with header, nav, footer sections
`JanSidePanel`	Panel with independent per-corner radius

Data Display

Control	Description
`JanChart`	Chart control — Bar, Line, Spline, Area, Pie, Donut
`JanTable`	Full-featured data table with search, sort, pagination, filters

Decorative & Utilities

Control	Description
`JanCircularPictureBox`	Circular image frame with gradient border
`JanEllipseControl`	Applies rounded corners to any WinForms control via GDI32
`JanScrollBar`	Custom scrollbar (used internally by JanTable and JanSidebar)

📸 Control Gallery

JanButton & JanToggleButton

JanTable

JanChart

1. JanBar Chart - Grouped

2. JanBar Chart - Stacked

3. Jan Line Chart

4. Jan SPLine Chart

5. Jan Area Chart

6. Jan Pie Chart

7. Jan Donut Chart

JanSidebar

JanAlert & JanInputDialog

JanAlert auto dismissible

JanInputDialog

JanComboBox Multi-select & Single-select

JanDatePicker

JanCard

JanCheckBox

JanCircularPictureBox

JanDropdownMenu

JanEllipseControl

JanLoader

JanPanel

JanProgressBar

JanRadioButton

JanScrollBar

JanSidePanel

JanTextBox

💡 Common Patterns

Toast notification

// Success — auto-dismisses
JanAlert.Show(this, "Record saved.", JanAlertType.Success, autoDismissMs: 3500);

// Danger — persistent
JanAlert.Show(this, "Connection failed.", JanAlertType.Danger,
    autoDismissMs: 0, position: JanAlertPosition.TopRight);

var sidebar = new JanSidebar
{
    Dock      = DockStyle.Left,
    BrandText = "MyApp",
    UserName  = "Sujan Perera",
    UserEmail = "sujan@example.com"
};

sidebar.Items.Add(new JanSidebarNavItem { Text = "Dashboard", Key = "home" });
sidebar.Items.Add(new JanSidebarNavItem { Text = "Reports",   Key = "reports" });
sidebar.NavItemClicked += (s, e) => LoadPage(e.Item.Key);
this.Controls.Add(sidebar);

Data table with search and pagination

var table = new JanTable
{
    Dock           = DockStyle.Fill,
    ShowSearch     = true,
    ShowPagination = true,
    StripedRows    = true,
    ResponsiveMode = ResponsiveMode.Fill
};
table.Columns = new List<string> { "ID", "Name", "Role", "Status" };
table.LoadData(GetUsers());
table.RowClicked += (s, e) => OpenUser(e.RowData[0]);
this.Controls.Add(table);

Multi-series chart

var chart = new JanChart { ChartType = JanChartType.Bar, Dock = DockStyle.Fill };

var revenue = chart.AddSeries("Revenue", Color.FromArgb(99, 102, 241));
revenue.Points.Add(new JanChartDataPoint("Q1", 48000));
revenue.Points.Add(new JanChartDataPoint("Q2", 62000));
revenue.Points.Add(new JanChartDataPoint("Q3", 57000));

this.Controls.Add(chart);

📐 Namespace Summary

Namespace	Contents
`JanUI.WinForms.Controls`	All 21 UI controls
`JanUI.WinForms.Themes`	JanTheme, ColorScheme, SchemeToken, JanControlBase
`JanUI.WinForms.Helpers`	Shared enums, drawing utilities, extension methods

📋 Requirements

Requirement	Detail
.NET version	.NET 6+ or .NET 8+ (Windows only)
Windows Forms	`<UseWindowsForms>true</UseWindowsForms>` in `.csproj`
Target suffix	Must target `-windows` (e.g. `net8.0-windows`)
IDE	Visual Studio 2022 recommended
Platform	Windows only

📄 License

MIT License — see LICENSE for details.

Built with ❤️ for the WinForms community JanUI.WinForms.Controls

Product	Compatible and additional computed target framework versions.
.NET	net6.0-windows7.0 is compatible. net7.0-windows was computed. net8.0-windows was computed. net8.0-windows7.0 is compatible. net9.0-windows was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net6.0-windows7.0
- No dependencies.
net8.0-windows7.0
- No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.1.0	143	7/9/2026
1.0.0	137	6/23/2026

v1.0.0 — Initial release. 21 controls across Feedback,
 Input, Layout, Data Display, and Utilities categories.

 v1.1.0
 Added:
 - JanTable.ColumnDefinitions: new design-time column collection (JanTableColumn) with header text, width, sort/filter/resize/editable flags, and per-column color/font overrides. Editable directly from the Properties window via the standard collection editor.

 Changed:
 - JanTable.Rows is now runtime-only (LoadData, AddRow, RemoveRow, ClearRows) and no longer appears in the Properties window or supports design-time serialization, since List<string[]> isn't reliably supported by the WinForms designer's code/resource serializer.

 Note: Existing code using janTable1.Columns and janTable1.Rows directly continues to work unchanged. ColumnDefinitions and Columns are independent — avoid mixing both on the same instance.