@charcoal-ui/icons-cli NPM

`@charcoal-ui/icons-cli`

Figma からアイコンの SVG をダウンロードし、GitHub に自動で更新の Pull Request を作成します。

GitLab にも対応しています。

npm

npm i --save-dev @charcoal-ui/icons-cli

yarn

yarn add -D @charcoal-ui/icons-cli

yarn icons-cli figma:export

必要な環境変数は以下です。

名前	必須	説明
FIGMA_FILE_URL	yes	Figma の URL です。node-id を含んでいる場合、その子孫のコンポーネントのみダウンロードします。
FIGMA_TOKEN	yes	Figma API のアクセストークンです
OUTPUT_ROOT_DIR	yes	svg をダウンロードするディレクトリです（例: `packages/icon-files`）

Figma 内のコンポーネントは以下の命名規則に従います（例: 16/Add Inline/Add ）。

yarn icons-cli svg:optimize --color "#000" --ignoreFile ./misc/icons-cli-denylist

SVG ファイルに SVGO による最適化をかけつつ、指定した色を currentColor に置換します。 ignoreFileでは、処理から除外する SVG ファイルの一覧を記したファイルを指定することができます。fast-globのパターンを使用できます。

必要な環境変数は以下です。

名前	必須	説明
OUTPUT_ROOT_DIR	yes	svg ディレクトリが存在するディレクトリです（例: `packages/icon-files`）

yarn icons-cli files:generate

必要な環境変数は以下です。

名前	必須	説明
OUTPUT_ROOT_DIR	yes	svg ディレクトリが存在するディレクトリです（例: `packages/icon-files`）

yarn icons-cli github:pr

必要な環境変数は以下です。

yarn icons-cli gitlab:mr

必要な環境変数は以下です。

名前	必須	説明
GITLAB_PROJECT_ID	yes	GitLab のプロジェクト ID（数値）です
GITLAB_ACCESS_TOKEN	yes	GitLab のアクセストークンです
GITLAB_HOST	no	GitLab のホスト名（セルフホスティング版の場合は自身のサーバーのホスト名）です
GITLAB_DEFAULT_BRANCH	no	リポジトリのデフォルトブランチです（例: main ）