@banzamel/mineralui

中文文档
2.9.2发布于 2026/11/07MITTypeScriptESM + CJS近 30 天下载 2015

Modern React UI component framework with mineral dark aesthetic

原始使用文档
文档目录6 节
  1. Installation
  2. What MineralUI Basic includes
  3. Quick Start
  4. Popular grouped imports
  5. Documentation
  6. Basic vs Pro

MineralUI

Modern React UI framework with a sharp admin aesthetic, theming system, and production-ready components.

  • npm: @banzamel/mineralui
  • version: 2.9.2
  • peer dependencies: react >= 19, react-dom >= 19
  • repository: https://github.com/Banzamel/mineralui-react
  • homepage: https://mineralui.io

Installation

npm install @banzamel/mineralui

No separate CSS import is required.

What MineralUI Basic includes

  • production-ready React UI components for dashboards, admin panels, forms, and internal tools
  • theming with CSS variables and dark/light mode support
  • layout primitives, overlays, inputs, feedback components, media, cards, and utilities
  • tree-shakeable grouped subpath exports
  • bundled styles with automatic runtime injection

Quick Start

import {MThemeProvider, MCard, MCardHeader, MCardBody, MInput, MButton} from '@banzamel/mineralui'

export function Example() {
    return (
        <MThemeProvider mode="dark">
            <MCard>
                <MCardHeader title="Workspace settings" />
                <MCardBody>
                    <MInput label="Workspace name" placeholder="Banzamel Studio" fullWidth />
                    <MButton>Save changes</MButton>
                </MCardBody>
            </MCard>
        </MThemeProvider>
    )
}
import {MButton, MCheckbox} from '@banzamel/mineralui/controls'
import {MCard, MCardBody} from '@banzamel/mineralui/cards'
import {MDataTable} from '@banzamel/mineralui/data'
import {MThemeProvider} from '@banzamel/mineralui/theme'

Documentation

  • website: https://mineralui.io
  • docs: https://mineralui.io/docs

Basic vs Pro

This package is the public Basic edition of MineralUI. Premium components, templates, package access, and installation tooling are distributed separately in MineralUI Pro.

版本与发布记录

@banzamel/mineralui 共发布 71 个版本,首次发布于 2026/03/18;过去 12 个月发布了 71 个版本。

版本发布日期距今
2.9.2latest2026/11/07今天
2.9.02026/11/071 天前
2.8.32026/11/062 天前
2.8.22026/11/062 天前
2.8.12026/11/062 天前
2.8.02026/11/062 天前

关于 @banzamel/mineralui 的常见问题

@banzamel/mineralui 是什么?

Modern React UI component framework with mineral dark aesthetic

如何安装 @banzamel/mineralui?

在项目目录运行 npm install @banzamel/mineralui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.2.4)、react-dom(^19.2.4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@banzamel/mineralui 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@banzamel/mineralui 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@banzamel/mineralui 可以商用吗?

@banzamel/mineralui 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@banzamel/mineralui 的下载量有多少?

根据 npm 官方下载统计,@banzamel/mineralui 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,015 次,日均约 67 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@banzamel/mineralui 还在维护吗?

最新版本 2.9.2 发布于 2026/11/07(今天);至今共发布 71 个版本,其中过去 12 个月发布了 71 个;首次发布于 2026/03/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。