貢献する

私たちは、Yamada UIが誰にとっても楽しく、教育的になるようなコミュニティを目指しています。

Yamada UIへの貢献に興味をもってくれて、ありがとうございます😎 あなたは素晴らしいです！！！

オープンソースへの貢献は、いくつかの方法で行うことができ、すべてが価値あるものです。これらは、あなたが貢献を準備する際に役立つガイドラインです。

セットアップ

以下の手順で、Yamada UIへの貢献を始められるようになります。

  1. リポジトリをフォークします。

  2. あなたのローカルにクローンします。

git clone https://github.com/<your_github_username>/yamada-ui.git

cd yamada-ui

  1. pnpm installを実行して、すべての依存関係とパッケージをセットアップします。このコマンドは、依存関係をインストールします。

  2. pnpm www devを実行してローカルサーバーを起動します。

開発手段

開発プロセスを快適するために、ツールとシステムを用意しています。

ツール

  • Next.js ドキュメントサイトのフレームワーク。

コマンド

  • pnpm install: すべての依存関係とパッケージをセットアップします。
  • pnpm www dev: ローカルサーバーを起動します。
  • pnpm www start: プロダクションサーバーを起動します。
  • pnpm www build: サイトを構築します。
  • pnpm www format: フォーマットの問題をチェックします。
  • pnpm www lint: コードの問題をチェックします。
  • pnpm www typecheck: 型の問題をチェックします。

Visual Studio Code

拡張機能を正しく動作させるために、.vscode/setting.jsonに以下の設定を追加してください。

{
  "typescript.tsdk": "node_modules/typescript/lib",
  "prettier.requireConfig": true,
  "eslint.workingDirectories": ["www"]
}

ドキュメントを更新する

コミット規約

プルリクエストを作成する前に、あなたのコミットがこのリポジトリで使用されているコミット規約に準拠しているかどうかを確認してください。

コミットを作成する際は、次のタイプのいずれかを使用しながら、コミットメッセージで規約タイプ: あなたのコミットメッセージに従うことをお願いします。

  • feat / feature: 完全に新しいコードや新機能を導入した場合
  • fix: バグを修正した変更の場合（可能であれば、詳細も記述する）
  • refactor: fixでもfeat / featureでもない、コード関連の変更をした場合
  • docs: 既存のドキュメンテーションの変更や新しいドキュメンテーションを作成した場合（例：READMEやJSDocを記述）
  • build: ビルドに関する変更、依存関係の変更、新しい依存関係の追加をした場合
  • test: テストに関する変更をした場合（新しいテストの追加や既存のテストの変更）
  • ci: 継続的インテグレーションの設定に関する変更をした場合（例：github actions、CIシステムなど）
  • chore: 上記のいずれにも当てはまらないリポジトリへの変更をした場合

詳しい仕様については、Conventional Commitsを確認するか、Angular Commit Message Guidelinesを確認してください。

プルリクエストの手順

  1. リポジトリをフォークし、クローンします。

  2. mainブランチから新しいブランチを作成します。[タイプ/スコープ]という命名規則に従います。例えば、fix/accordion-hookやdocs/menu-typoなどです。タイプはdocs、fix、feat、buildなどの標準的なコミットタイプのいずれかです。スコープは作業範囲を表す短い言葉です。

  3. 変更を行い、コミット規約に従ってコミットします。

  4. 上記の全てのタスクを完了したら、変更をプッシュしてください。プッシュ後、プルリクエストのURLが生成されます。テンプレートに従ってリクエストを提出してください。また、プルリクエスト内のチェックを確認し、ビルドが正常に完了していることを確認してください。問題がある場合、このプルリクエストはマージされません。

ライセンス

Yamada UIのGitHubリポジトリにコードを寄贈することで、あなたの寄贈するコードはMITライセンスの下でライセンス付けされることに同意します。