Skip to content

RiversideValley/Toolkit

Repository files navigation

Important

CubeKit is a new era for the previous CrimsonUI, GlowUI and Toolkit options. The second version of CubeKit (formerly Crimson Toolkit) brings together all your favourite toolkits into one repository, with styles from GlowUI and Crimson and useful controls and utilities.

GlowUI Economy

Get it from Microsoft Get it from GitHub


Introducing CubeKit, the ultimate toolkit for building modern apps on .NET. CubeKit is a set of versatile, platform-agnostic APIs that enable you to build apps for multiple platforms using .NET. Using a custom multi-target solution called Alloy, it exposes APIs that are suited to the project you install the aggregate package on, allowing you to build apps for UWP, WinUI and .NET Core.

CubeKit is the new name for its various predecessors including CrimsonUI (now merged with GlowUI), GlowUI (GlowUI is still used to refer to the styles, but it is included as part of CubeKit as a whole), Crimson Toolkit and Riverside.Toolkit. It is built using custom tooling to target all versions of .NET.


Using CubeKit

NuGet is a standard package manager for .NET applications which is built into Visual Studio. When you open solution in Visual Studio, choose the Tools menu > NuGet Package Manager > Manage NuGet packages for solution…

You can install all recommended helpers and controls using the aggregate package which automatically installs all the appropriate helpers for your target platform (.NET Core, WinUI and UWP .NET 9). You can see examples of using APIs on the documentation page.

The root namespace for CubeKit is as follows:

  • Riverside.Toolkit.*: Main CubeKit components and helpers
  • Riverside.GlowUI.*: Related to styles and GlowUI
  • Riverside.Extensions.*: Various collections of .NET helpers and rewrites

CubeKit also contains controls from WCT 7.x that didn't make it to 8.x, such as DropShadowPanel.

Building from source

It's recommended to read Sergio's blog post on UWP .NET 9 to make yourself familiar with UWP .NET 9 NativeAOT and the limitations.

1. Prerequisites

2. Clone the repository

git clone https://github.com/RiversideValley/Toolkit

This will create a local copy of the repository.

3. Build the project

To build CubeKit for development, open the CubeKit.sln item in Visual Studio. Right-click on the project you want to build and press 'Build'.

Contributing

We're always looking for a helping hand, look for open issues here or create a fork of the repo to try or build new features. Even just improving our docs and samples for existing components here, or adding new tests can be a huge help!

Check out our documentation page to learn more about the project and how to contribute to it.

If you have a new idea for CubeKit, please write a feature request! However if your idea is quite large and requires extra tracking, please start a discussion! Any ideas for APIs, controls and styling suggestions are appreciated. No contribution is too big or too small.


Package Latest Description
Riverside.Toolkit The main aggregate package for CubeKit.
Riverside.Toolkit.Flyouts Flyouts manifest package from Fluent Flyouts 3 (obsolete)
Riverside.Toolkit.Controls Controls and user controls from CubeKit.
Riverside.Toolkit.Converters Converters from CubeKit to reduce need for writing them in your own apps (part of the One Toolkit effort)
Riverside.Toolkit.Helpers A collection of useful static helpers for building modern apps. Shared with the Riverside.Extensions package.
Riverside.Toolkit.Icons A collection of resources for using fluent icons in WinUI/UWP apps. It is obsolete now but still kept as it is used by GlowUI.
Riverside.GlowUI The GlowUI styles package.
Riverside.GlowUI.Materials Materials for use in GlowUI apps such as Bloom and Aurora.
Riverside.Extensions This package previously contained runtime agnostic helpers that are now part of the main toolkit package. This namespace is now used for rewrites of other packages and helpers.

CubeKit is used in many production apps, including United Sets, Protecc, Clippy, Flowboard, Darksky and way more!

United Sets Protecc Flowboard
image image image

GlowUI Economy