@galaxy-io/dls

中文文档
2.13.5发布于 2026/11/05UNLICENSEDTypeScriptES Module近 30 天下载 2505

银河设计语言系统

中文使用文档
文档目录5 节
  1. 安装
  2. 快开始
  3. 文档
  4. 从 1.x 移动
  5. 克劳德的技巧

@galaxy-io/dls (英语)

Galaxy Design Language System:一个用于Filament的React组件库,GX应用程序和每个Galaxy React表面. 单色,稠密,发线-静音;预编Linaria CSS通过CSS自定义属性来读取,因此一个主题开关从此不再重发应用程序.

NPM Version

安装

pnpm add @galaxy-io/dls

22,反应18或19,无害环境管理。 重型单一组件库(图表、表格、代码编辑器、代码突出显示器、Markdown、克龙和颜色输入、3D和动画品牌标记)是可选的同位素; 正在启动 列出需要哪个子路径.

快开始

一个命令中的新应用程序:Vite与 DLS Linaria 预设,Biome与 DLS 规则, 三样式表, GalaxyProvider,和一个薄的 Filament 形状的应用程序:文件路由, ConnectRPC 在模拟运输上的查询,帧和两页.

pnpm create @galaxy-io/galaxy-app my-app

--template blank 仅写提供者和一页. 正在启动 列出选项; 任何 Galaxy 应用程序的根都是这样:

// Once, at the app root: component styles, tokens, fonts.
import "@galaxy-io/dls/styles.css";
import "@galaxy-io/dls/tokens.css";
import "@galaxy-io/dls/fonts.css";

import { PlusIcon } from "@phosphor-icons/react";
import Button, { ButtonVariant } from "@galaxy-io/dls/buttons/Button";
import Flex, { FlexDirection } from "@galaxy-io/dls/layout/Flex";
import Text, { TextSize, TextWeight } from "@galaxy-io/dls/text/Text";
import GalaxyProvider from "@galaxy-io/dls/theme/GalaxyProvider";

export function App() {
  return (
    <GalaxyProvider>
      <Flex direction={FlexDirection.COLUMN} gap={16} padding={24}>
        <Text as="h1" size={TextSize.HEADING_MD} weight={TextWeight.MEDIUM}>
          Sources
        </Text>
        <Flex gap={8}>
          <Button label="New source" icon={PlusIcon} />
          <Button label="Import" variant={ButtonVariant.SECONDARY} />
        </Flex>
      </Flex>
    </GalaxyProvider>
  );
}
  • 从自己的子路径导入每个组件;其元件来自同一个模块. 没有枪管.
  • GalaxyProvider 是一根:主题(System / Dark / Light),上叠和土司.
  • 用 Linaria 和符号存取器样式自己的代码 t (单位:千美元)@galaxy-io/dls/theme/tokens/t),设置为 galaxyDls() 从 @galaxy-io/dls/vite与 "extends": ["@galaxy-io/dls/biome"]。 。 。 .

文档

开始安装、 Vite、 样式表、 提供者、 SSR
他们主题和每个标志
构成部分每个组件,何时使用,例
模式银河屏幕的构建方式
无障碍地板和键盘地图
从 1.x 移动代码和自1.6.1以来的每一个变化
捐款致力于建立这一存储库( :一般事务人员(其他职等) (有规则)
故事书两个主题的每个组成部分,道具和状态

从 1.x 移动

npx @galaxy-io/dls-codemod src --report dls-migrate.json

代码重写所有机械设备 并标出其余的 @dls-migrate <id> 评论意见; 文献/地图 解释每一个身份.

克劳德的技巧

skills/galaxy-ui 教克洛德用这个软件包设计、构建和构建 Galaxy 应用程序:应用程序架构 create-galaxy-app 脚手架(堆放,文件和命名,路由和URL状态,ConnectRPC数据层和模拟,屏幕贝壳,形式,可挂载模块),品牌规则,组件决定表,符号,图案和完整的屏幕食谱. 它的 DLS 示例会根据此寄存器进行类型检查( Namepnpm skill:check) (中文(简体) ).

  • 克劳德代码 : 将文件夹复制到您的技能目录 : cp -R skills/galaxy-ui ~/.claude/skills/ (或项目) .claude/skills/) (中文(简体) ).
  • Claude 应用程序 : 运行 pnpm skill:pack 上传 dist-skill/galaxy-ui.zip 作为技能(安置) 能力(技能).

细节 : 技能/银河水/README.md。 。 。 .

版本与发布记录

@galaxy-io/dls 共发布 102 个版本,首次发布于 2026/07/14;过去 12 个月发布了 102 个版本。

版本发布日期距今
2.13.5latest2026/11/0510 天前
2.13.42026/11/0312 天前
2.13.32026/10/3116 天前
2.13.22026/10/2917 天前
2.13.12026/10/2917 天前
2.13.02026/10/2917 天前

关于 @galaxy-io/dls 的常见问题

@galaxy-io/dls 是什么?

银河设计语言系统

如何安装 @galaxy-io/dls?

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

@galaxy-io/dls 支持 TypeScript 吗?

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

@galaxy-io/dls 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@galaxy-io/dls 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@galaxy-io/dls 可以商用吗?

@galaxy-io/dls 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@galaxy-io/dls 的下载量有多少?

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

@galaxy-io/dls 还在维护吗?

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