@croquiscom/pds

中文文档
17.0.1发布于 2026/11/04MITTypeScriptESM + CJS近 30 天下载 6568

Design system for Zigzag's Partner Center

原始使用文档
文档目录7 节
  1. 🚀 빠른 시작
  2. 📖 문서
  3. 🤖 AI 도구 설정
  4. Claude Code Skills
  5. 🔗 관련 링크
  6. 👥 기여하기
  7. AI(에이전트) 기여자

npm version

PDS

Partner Design System - 카카오스타일 어드민 서비스들을 위한 React 기반 디자인 시스템 라이브러리

🚀 빠른 시작

npm install @croquiscom/pds @emotion/react @emotion/styled react react-dom
import { Button } from '@croquiscom/pds';

<Button kind='primary' size='medium'>
  저장
</Button>;

📖 문서

  • 시작하기 - 설치 및 기본 사용법 (Storybook)
  • AI 도구 설정 - 아래 섹션 참조

🤖 AI 도구 설정

Claude Code Skills

PDS 패키지 설치 시 .claude/skills/pds에 자동으로 설치됩니다.

자동 설치 조건:

  • .claude 디렉토리가 존재하는 경우
  • PDS_SKIP_CLAUDE_SKILLS=true 환경변수가 설정되지 않은 경우

수동 설치:

npx pds-install-skills

자동 설치 비활성화:

export PDS_SKIP_CLAUDE_SKILLS=true
yarn add @croquiscom/pds

🔗 관련 링크

👥 기여하기

PDS 개발에 참여하려면 **개발자 가이드**를 참고하세요.

AI(에이전트) 기여자

PDS 저장소를 편집하는 AI 에이전트(Claude Code, Codex 등)는 다음을 먼저 읽으세요:

src/ai-skills/SKILL.md는 PDS를 사용하는 다른 앱의 AI를 위한 문서이며, 이 저장소를 편집할 때의 정책 출처가 아닙니다.

版本与发布记录

@croquiscom/pds 共发布 643 个版本,首次发布于 2022/09/14;过去 12 个月发布了 92 个版本。

版本发布日期距今
17.0.1latest2026/11/046 天前
17.0.02026/11/028 天前
16.71.02026/10/2813 天前
16.70.02026/10/1526 天前
16.69.02026/09/301 个月前
16.68.22026/09/211 个月前

其他发布通道:alpha → 3.10.0-alpha.6,rc → 16.0.0-rc.2,next → 16.45.0-next.0,snapshot-worktree-cpfe-17976-typography-h8613c193 → 16.58.1-snapshot-worktree-cpfe-17976-typography-h8613c193.27111582306.1,snapshot-feature-cpfe-18444-h8ad8824a → 16.65.2-snapshot-feature-cpfe-18444-h8ad8824a.31475932770.1,snapshot-joe-cpfe-18444-sync-main-formfield-hef84e93a → 16.65.4-snapshot-joe-cpfe-18444-sync-main-formfield-hef84e93a.31776720371.1。

关于 @croquiscom/pds 的常见问题

@croquiscom/pds 是什么?

Design system for Zigzag's Partner Center

如何安装 @croquiscom/pds?

在项目目录运行 npm install @croquiscom/pds,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18 || ^19)、react-dom(^18 || ^19)、@emotion/react(^11.4.0)、@emotion/styled(^11.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 pds-install-skills,可以用 npx pds-install-skills 直接运行。

@croquiscom/pds 支持 TypeScript 吗?

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

@croquiscom/pds 支持 ESM 还是 CommonJS?

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

@croquiscom/pds 需要什么版本的 Node.js?

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

@croquiscom/pds 可以商用吗?

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

@croquiscom/pds 的下载量有多少?

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

@croquiscom/pds 还在维护吗?

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