NextUI Framework

Next 世代的独立 UI 应用框架与设计系统。

NextUI 不仅仅是一个组件库，它是一套完整的企业级应用工程体系，旨在通过 Token 驱动、组件化 和 跨端一致性，帮助开发者快速构建高质量的 Blazor (Web)、.NET MAUI (Hybrid) 以及 纯 HTML 应用。

🏗️ 核心架构

核心引擎 (Core & Foundation)

  • src/NextUI.Tokens: 全局设计变量定义 (Color, Spacing, Typography, Shadows)。
  • src/NextUI.Assets: 共享静态资源 (Standard Fonts, Icons)。
  • src/NextUI.Core: 底层逻辑引擎，处理主题切换、多语言 (i18n) 以及跨平台适配逻辑。

组件与视图 (Components & Views)

  • src/NextUI.Blazor: 基于 Fluent UI 规范的标准 Blazor 组件库。
  • src/NextUI.App: (新增) 提供标准的应用级组件，如设置中心 (SxSettingsView)、系统诊断 (SxDiagnosticView) 等。

开发与预览 (Developer Experience)

  • workbench/NextUI.Workbench: 交互式组件实验室（类库形式）。
  • workbench/NextUI.Workbench.Host: (新增) Workbench 的独立 Web 预览环境。
  • docs/: 组件库 API 指南、设计规范以及技术债跟踪。

🚀 快速开始

1. 环境准备 (Prerequisites)

本仓库依赖本地 NuGet 仓库进行组件分发。

  • 在本仓库的 父目录 下创建一个名为 local-nuget 的文件夹。
  • 所有的编译依赖将通过根目录下的 NuGet.Config 自动指向 ../local-nuget。

2. 编译与分发

使用 Nx 统一命令行工具进行构建和发布：

# 自动执行：编译 -> 测试 -> 打包 -> 推送到本地仓库 -> 清理缓存
./nx publish

3. 运行示例

  • 环境诊断: ./nx doctor
  • Workbench: ./nx run workbench (或继续使用 workbench/restart-app.sh)
  • MAUI Hybrid: ./nx run maui
  • Web App: ./nx run web

📦 项目脚手架 (Project Templates)

我们提供了基于 dotnet new 的项目模板，支持一键创建标准项目结构：

  1. 安装模板包：

    dotnet new install [path-to-nupkg]/NextUI.Templates.1.2.*.nupkg

  2. 创建项目：

    • 后台管理系统：dotnet new nextui-web-admin -n MyAdminApp
    • 公共门户网站：dotnet new nextui-public-site -n MyPortal

🛠️ 开发指南

  1. 文档即真理 (Single Source of Truth)：任何代码修改前，必须先同步更新 docs/components/*.md。
  2. 基类强制：所有 UI 组件必须继承 SxComponentBase。
  3. 设计解耦：严禁硬编码颜色或间距，必须使用 DesignTokens CSS 变量。
  4. API 稳定性：核心组件的 [Parameter] 一旦发布，严禁随意重命名或删除。

© 2026 NextUI Team. All rights reserved.