テンプレート

テンプレートはフォーク可能なスターターパッケージです。それぞれが実際に 形になったアプリであり、marketplace からワンクリックでインストールするか、 CLI でクローンして拡張可能な TypeScript コードベースを取得できます。

テンプレートが存在する理由は 2 つあります。

1. 語るより見せる — 動作するマルチオブジェクトのアプリは、ドキュメントよりも 素早く理解できます。
2. エンジニアリングチームに出発点を提供する — DB に AI 生成のメタデータがある だけでなく、ソース管理下にコードを置きたい場合に役立ちます。

デフォルトカタログに含まれるもの

ソース: github.com/objectstack-ai/templates。 Apache-2.0。許可なくフォークしてください。

30 秒でインストール（コード不要）

Console で:

1. Marketplace を開く → テンプレートを検索する。
2. Install をクリックする。
3. 更新する — 新しいアプリがナビゲーションに表示されます。

完了です。レコード、ビュー、フロー、権限 — すべて稼働しています。

コードベースとしてフォークする（エンジニア向け）

pnpm dlx @objectstack/cli create my-app --template todo
cd my-app
pnpm install
pnpm dev          # http://localhost:4002

クローンは自己完結型の pnpm パッケージで、編集、lint、テスト、コミットが可能な *.object.ts、*.view.ts、*.flow.ts ファイルで構成されています。準備が できたら:

pnpm build
os package publish   # → your marketplace

あなたのフォークをインストールした顧客は、あなたのブランドとあなたの 変更内容を受け取ります。

テンプレート憲章（ソーシャルコントラクト）

すべてのテンプレートは、そのスコープと厳格な制限を宣言する CHARTER.md を 備えています。典型的には、ビジネスオブジェクト 6 個以下、src/ 配下のコード 2,500 行以下、アプリ 1 つ、デフォルトロケール 1 つです。憲章が存在するのは、 テンプレートが未完成の製品ではなく、テンプレートであり続けるためです。 フォークがこれらの制限を超えて成長した場合は、新しいテンプレートとして公開し、 既存のものを肥大化させないでください。

ファイルサフィックスのプロトコル（*.object.ts、*.state.ts、*.hook.ts など）、 オーサリングの順序（objects → state → hooks → views → flows → …）、および 再発明せずに再利用すべきポリモーフィックなプラットフォームサービス （sys_comment、sys_attachment、sys_audit_log）については、上流の TEMPLATE_GUIDE.md を参照してください。

出発点を選ぶ

AI Builder とテンプレートを組み合わせる

テンプレートをフォークしても、その上で 引き続き AI Builder を使用できます。 helpdesk をインストールしてから、次のように指示します。

「hd_ticket に範囲 1〜5 の csat_score 整数フィールドを追加し、クローズ時に 入力を求めて。」

AI はインストール済みのパッケージをその場で拡張します。os package export で 変更をソースリポジトリにプッシュしてください。

次に進む先

• AI Builder — チャットで任意のテンプレートを拡張する
• Packages — テンプレートとは実際には何か
• Marketplace — あなたのフォークを配布する
• Quickstart — 開発者パスのエンドツーエンド全体