他のつくったもの(全3件)

project-generator / OVERVIEW

@ciderjs/gasbombe

GAS用に最適化されたTypeScriptプロジェクトを生成できるCLIツール

GASTypeScriptCLI
このページの内容

背景と解決したかった課題

Google Apps Script(GAS)のローカル開発は @google/clasp の普及で一般的になりましたが、実際にTypeScriptやReact・Vueを使った開発環境を一から整えようとすると、毎回多くの設定作業が発生します。

  • GASランタイムの制約に合わせたバンドラ(Rolldown / Vite)の選定と設定
  • グローバル関数として認識させるためのビルド出力調整と tsconfig.json の構成
  • @types/google-apps-script の導入や、ローカルで単体テストを回すためのVitest設定
  • リンター・フォーマッター(Biome)やGitHub Actionsによる自動デプロイ構成

新しいGASツールを作りたいだけなのに、こうした環境構築だけで何時間も費やしてしまう課題を解決するため、コマンドひとつでベストプラクティス構成を展開できるCLIジェネレーター @ciderjs/gasbombe を開発しました。

クイックスタート

パッケージを事前インストールすることなく、npx(または pnpm dlx)から対話モードですぐに実行できます。

.sh
npx @ciderjs/gasbombe

プロジェクト名、利用するパッケージマネージャー(npm / pnpm / yarn)、用途に応じたテンプレートを選択すると、初期設定済みのディレクトリが生成されます。

主な特徴と収録テンプレート

  • 用途に応じたテンプレート選択:サーバーサイド専用のTypeScript構成(server-ts, server-ciderjs)から、React・Vue 3を用いた単一HTMLバンドル構成(react-ciderjs, vue-ciderjs)まで幅広く対応しています。
  • CiderJSエコシステムとの統合:サーバー・クライアント間を型安全につなぐ @ciderjs/gasnuki、GAS用ファイルベースルーター @ciderjs/city-gas、Vitest用モック @ciderjs/vitest-plugin-gas-mock などを最初から組み込んだ構成を選択できます。
  • テスト・CI/CD・AIエージェント対応:ローカルでのVitest単体テスト、Biomeによるコードチェック、AIコーディングエージェント向けのルール定義ファイル(.agents)まで初期状態で同梱しています。

詳細なCLIオプションやプログラマティックAPIの仕様は、導入ガイド(公式ドキュメント)を参照してください。

関連する技術記事