Aiursoft.UiStack
11.0.0
dotnet add package Aiursoft.UiStack --version 11.0.0
NuGet\Install-Package Aiursoft.UiStack -Version 11.0.0
<PackageReference Include="Aiursoft.UiStack" Version="11.0.0" />
<PackageVersion Include="Aiursoft.UiStack" Version="11.0.0" />
<PackageReference Include="Aiursoft.UiStack" />
paket add Aiursoft.UiStack --version 11.0.0
#r "nuget: Aiursoft.UiStack, 11.0.0"
#:package Aiursoft.UiStack@11.0.0
#addin nuget:?package=Aiursoft.UiStack&version=11.0.0
#tool nuget:?package=Aiursoft.UiStack&version=11.0.0
Aiursoft UiStack
Aiursoft UiStack is a front-end framework for Aiursoft projects based on ASP.NET Core. It provides a set of common components and styles for Aiursoft projects. It is designed to be simple and easy to use, and can be used to quickly build a front-end for Aiursoft projects.
Frontend sources are maintained in UIStack.js and MarkdownUI.js. This repository consumes the published UIStack assets.
UiStack 11 requires both packages. Add the Aiursoft.UiStack NuGet package for the .NET components and shared Razor layout, and install @aiursoft/uistack from npm for the CSS, JavaScript, fonts, and images. The NuGet package no longer ships those assets. See Usage for the application setup.
Overview
What is UiStack?
Aiursoft UiStack is a front-end framework for Aiursoft projects based on ASP.NET Core. It provides a set of common components and styles for Aiursoft projects. It is designed to be simple and easy to use, and can be used to quickly build a front-end for Aiursoft projects.
Try
Try a running demo here.
Install with Docker
Run the installer with the desired port (omit it to choose an available port):
curl -fsSL https://raw.githubusercontent.com/aiursoftweb/uistack/master/install.sh | sudo bash -s -- 8080
Installation starts after three seconds; press Ctrl+C to cancel. Then open http://localhost:8080.
Run manually
Requirements about how to run
- Install .NET 10 SDK and Node.js.
- Execute
dotnet run --project src/Aiursoft.UiStack.Demoto build and run the demo, including the npm assets. - Use your browser to view http://localhost:5000.
Run in Microsoft Visual Studio
- Open the
.slnfile in the project path. - Press
F5to run the app.
Run in Docker
First, install Docker here.
Then run the following commands in a Linux shell:
image=aiursoft/uistack
appName=uistack
docker pull $image
docker run -d --name $appName --restart unless-stopped -p 5000:5000 -v /var/www/$appName:/data $image
That will start a web server at http://localhost:5000 and you can test the app.
The docker image has the following context:
| Properties | Value |
|---|---|
| Image | aiursoft/uistack |
| Ports | 5000 |
| Binary path | /app |
| Data path | /data |
| Config path | /data/appsettings.json |
Usage
Open the application at the URL selected in the installation or run steps above.
To use UiStack 11 in an existing ASP.NET Core app:
Reference the
Aiursoft.UiStack11.x NuGet package in the web project.From the directory containing the app’s
package.json, install the browser package used by the demo:npm install "@aiursoft/uistack@^2.0.25"Include the package’s
distfolder in the published application underwwwroot/node_modules/@aiursoft/uistack/dist/. Enable ASP.NET Core’s standardapp.UseStaticFiles()middleware. The shared layout loads its CSS and JavaScript from/node_modules/@aiursoft/uistack/dist/.If upgrading from UiStack 10, remove the
app.UseUIStack()call and update any direct references to/UIStack/dist/in custom views and scripts.
See the demo project for an example that prepares and publishes the npm assets during a .NET build. Node.js and npm are needed to build the assets into the application. The published application serves the prepared files without Node.js.
Configuration
The application defaults are defined in src/Aiursoft.UiStack.Demo/appsettings.json. The Docker image initializes /data/appsettings.json on its first start and keeps it for later starts; persist /data. Override nested values with double-underscore environment variables, such as Logging__LogLevel__Default.
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}
Shared settings
Logging:LogLevelcontrols application and framework verbosity.
How to contribute
There are many ways to contribute to the project: logging bugs, submitting pull requests, reporting issues, and creating suggestions.
Even if you with push rights on the repository, you should create a personal fork and create feature branches there when you need them. This keeps the main repository clean and your workflow cruft out of sight.
We're also interested in your feedback on the future of this project. You can submit a suggestion or feature request through the issue tracker. To make this process more effective, we're asking that these include more information to help define them more clearly.
License
Licensed under the MIT License.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Aiursoft.WebTools (>= 10.0.22)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Aiursoft.UiStack:
| Package | Downloads |
|---|---|
|
Aiursoft.Translate
Nuget package of 'Translate' provided by Aiursoft |
|
|
Aiursoft.EmployeeCenter
Nuget package of 'EmployeeCenter' provided by Aiursoft |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 11.0.0 | 0 | 11/18/2026 |
| 10.0.59 | 48 | 11/18/2026 |
| 10.0.58 | 52 | 11/17/2026 |
| 10.0.57 | 71 | 11/17/2026 |
| 10.0.56 | 136 | 11/16/2026 |
| 10.0.55 | 99 | 11/15/2026 |
| 10.0.54 | 100 | 11/15/2026 |
| 10.0.53 | 116 | 11/15/2026 |
| 10.0.52 | 133 | 11/14/2026 |
| 10.0.51 | 106 | 11/14/2026 |
| 10.0.50 | 103 | 11/14/2026 |
| 10.0.49 | 93 | 11/13/2026 |
| 10.0.48 | 105 | 11/13/2026 |
| 10.0.47 | 119 | 11/13/2026 |
| 10.0.46 | 122 | 11/13/2026 |
| 10.0.45 | 128 | 11/12/2026 |
| 10.0.44 | 118 | 11/12/2026 |
| 10.0.43 | 124 | 11/12/2026 |
| 10.0.42 | 122 | 11/11/2026 |
| 10.0.41 | 131 | 11/11/2026 |