他のつくったもの(全3件)
project-generator / OVERVIEW
@ciderjs/gasbombe
GAS用に最適化されたTypeScriptプロジェクトを生成できるCLIツール
このページの内容
背景と解決したかった課題
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)から対話モードですぐに実行できます。
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の仕様は、導入ガイド(公式ドキュメント)を参照してください。