The front end framework for correctness: built on Effect, architected like Elm
The front end framework for correctness: built on Effect, architected like Elm (foldkit.dev)
要約
Foldkitは、Effect上に構築されElmのようなアーキテクチャを採用した、正しさを重視する新しいフロントエンドフレームワークです。予測可能な状態管理、明示的な副作用、そしてスケーラビリティに優れた構造化されたアプローチを提供し、設計を通じてバグの防止を目指します。
全文翻訳
より速く構築し、出荷されるものを理解する
FoldkitはEffect上に構築されたTypeScript製フロントエンドフレームワークです。状態と副作用を明示化することで、チームやAIエージェントがより迅速に機能開発を行い、動作を追跡し、変更を自信を持ってテストできるようにします。
npx create-foldkit-app@latest
振る舞いを宣言し、出荷する。繰り返し。
React、Vue、Svelte、Solidはレンダリングを解決し、アーキテクチャは開発者に委ねます。Foldkitはアーキテクチャを提供するため、ドメインに集中できます。
予測可能な状態
一つの不変モデルがアプリケーション全体の状態を保持します。全ての変更は単一の更新関数を通じて流れます。隠れたミューテーション、古いクロージャ、予期せぬ事態はありません。
明示的な副作用
副作用は、ハンドラに埋め込まれた命令的な呼び出しではなく、更新から返される値です。コマンドは、何が起こるべきかを記述します。ランタイムがいつ、どのように処理するかを扱います。
共有構造
50ファイル規模のアプリケーションも、5ファイル規模のアプリケーションと同じModel、Message、update、Command構造を使用します。新しい作業には既知の場所があり、レビューは共有された規約から始まります。
プログラムが思考するのを見る。
DevToolsは全てのMessageをログに記録し、各Modelの状態を検査できます。Messageを選択して何が変更されたかを確認したり、UIをその状態に巻き戻したりできます。
同じランタイムデータがMCP経由でAIエージェントに提供されます。AIは現在のModelを検査し、Message履歴をたどり、UIを過去の状態に巻き戻し、Messageをディスパッチできます。
このサイトはFoldkitで動作しています。このページの右下にあるタブを探して、DevToolsをライブで試してみてください。
Effectで構築。内外共に。
バックエンドが既にEffectを使用している場合、Foldkitは同じツールとパターンをブラウザに持ち込みます。Effectがチームにとって新しい場合、学習曲線の一部となります。
- 全てのFoldkitアプリケーションはEffectです
- Model全体はSchemaによって定義されます
- コマンドはサービス、中断、リソース、並行処理のためにEffectを使用します
理にかなったテスト。
純粋な更新関数は、純粋なテストを意味します。Storyテストはステートマシンをテストします。Sceneテストは、アクセス可能なロケータを使用して、ビュー(ボタンのクリック、入力へのタイピング)を通じて機能をテストします。DOMやモックは不要です。
Storyテスト
Sceneテスト
標準装備。
ルーティング、サーバーレンダリング、UIコンポーネント、コンポジション、ブラウザライフサイクルはすべて同じModelとMessageフローを使用します。
ルーティング
型安全な双方向ルーティング。URLは型付きルートにパースされ、ルートはURLに再構築されます。文字列マッチングや、パースとビルド間の不一致はありません。
サーバーレンダリング
ビルド時に静的HTMLを生成するか、リクエストごとにレンダリングします。どちらのパスも同じinit、view、Modelを使用し、ブラウザでHTMLをハイドレーションします。
UIコンポーネント
アクセス可能なダイアログ、メニュー、タブ、リストボックス、開閉可能な要素など。各ステートフルコンポーネントはThe Elm Architectureに従い、スタイリングとコンポジションに対応しています。
サブモデル
サブモデルは、自身のModel、Messages、update、viewをより大きなプログラムに埋め込みます。ドメインの事実を型付きのOutMessagesとして親に送信します。全てのステートフルなFoldkit UIコンポーネントはサブモデルです。
ブラウザライフサイクル
サブスクリプションは、Modelの条件が満たされている間、イベントをストリームします。ManagedResourcesはWebSocketやAudioContextなどのハンドルを保持します。Foldkitは、Modelがそれらを必要としなくなったときに両方を閉じます。
埋め込み
Runtime.embedを使用して、Foldkitウィジェットを任意のホストアプリケーション内で実行します。ホストはSchema型ポートを通じてデータをプッシュし、値を受け取り、ウィジェットをdisposeで破棄します。
動作を見る。
Messageがupdateを通過してModelに入る様子を観察します。コードはリアルタイムでハイライトされ、各ステップで何が起こっているかを示します。
アーキテクチャの適合性。
FoldkitはThe Elm Architectureを使用します。アプリケーションの状態は、コンポーネントインスタンスやフックのライフサイクルには存在しません。Modelが唯一の真実の情報源であり、全ての遷移はupdate内で可視化されます。
この規律は真のコミットメントです。Foldkitは、チームがアプリケーション全体で単一のアーキテクチャを望み、Effect全体で構築する準備ができている場合に最適です。
強い適合性
-
フロントエンドを必要とするEffect開発者
バックエンドは既にEffectを使用しています。FoldkitはSchema、サービス、Streams、スコープ付きリソースをフロントエンドアーキテクチャに持ち込みます。
-
複雑な状態を持つアプリケーション
認証フロー、リアルタイムデータ、複数ステップのフォームは、ツリー全体に散らばったエフェクトや参照ではなく、明示的な状態と遷移になります。
-
共有規約を望むチーム
状態、副作用、ビューのための単一のパターンは、機能に既知の形状を与え、レビューに共通の語彙を提供します。
慎重に検討すべき場合
-
大規模な既存のReactコードベース
アプリ全体をFoldkitに移行するには書き直しが必要です。Runtime.embedを使用すると、既存のアプリにFoldkitウィジェットを追加できます。
-
Reactエコシステムを必要とするプロジェクト
アプリケーションがReactコンポーネントライブラリ、Next.js、またはそのスタック用に構築されたミドルウェアに依存している場合。Foldkitは異なる基盤を使用します。
-
ほとんどが静的コンテンツのサイト
Astroのようなコンテンツ中心のツールは、ほとんどが文章であるサイトに適しています。Foldkitはサーバーでレンダリングできますが、アプリケーション向けに構築されています。
Reactとの比較React + Effect Atomとの比較
プロジェクトステータス。
Foldkitは1.0未満で、活発に開発中です。以下のリンクは現在のバージョンと、今日利用可能なものを示しています。
-
バージョン
v0.169.0
-
サンプルアプリ
-
本番アプリ
-
変更履歴
エージェントの生産性のために。そして人間の理解のために。
エージェントはFoldkitの一貫したアーキテクチャを使用して、MCPを通じて機能を構築し、実行中のアプリを検査できます。人々は同じModelとMessageフローを追跡して、結果を理解し、レビューし、テストできます。
構築を開始する。
アプリケーションをスキャフォールドし、Modelを定義し、最初の状態遷移を明示します。
更新ループに留まる。
新しいリリース、パターン、そして時折のディープダイブ。