Dialupフレームワークの使用方法について解説するガイド集です。 Dialup の二本柱は、WebSocket-first の人間向け UI と、UI 宣言から自動生成される HTTP MCP API です。
ガイド一覧
はじめに
- Getting Started - インストールから最初のアプリ作成まで
- Fullstack Example - Ecto・PubSubを使ったフルスタックアプリの作成例
基本概念
- Routing - ファイルベースルーティング（静的・動的・クエリパラメータ）
- State Management - session / assigns / params の管理
- Lifecycle - ライフサイクル（layout.mount / page.mount / handle_event / handle_info / render）
- Events - WebSocket-first UI のイベント処理（ws-event, ws-submit, handle_info, redirect）
AI エージェント / MCP
- HTTP MCP API - UI 宣言から自動生成される
tools/list/tools/call - Agent-native App Development - エージェント対応アプリの設計・実装
- Session tokens - ライブセッションへのトークン発行と接続
- Agent pitfalls - コーディングエージェントが陥りやすい誤解（layout.css の共有、ws-change など）
機能別ガイド
- Authentication - ユーザー認証（
mix dialup.gen.auth、MCP権限連携、シーケンス図） - File Upload - ファイルアップロード（HTTP POST経由 / 署名付きURL経由）
- Helpers - 便利なヘルパー関数の使い方
- Deployment - 本番環境へのデプロイ
外部ライブラリとの連携
- Ecto - DBアクセス（Fullstack Exampleを参照）
- Phoenix.PubSub - リアルタイム通信（Fullstack Exampleを参照）
APIリファレンス
cd /path/to/dialup
mix docs --open
メンテナ向け
Dialup フレームワークの新バージョンを Hex に公開するときは、Cursor の publish-new-version skill
（.cursor/skills/publish-new-version/SKILL.md）を使う。公開前に次を必ず確認する:
- mix docs —
mix.exsのdocs.extras、lib/の moduledoc、guides/が実態と一致しているか - dialup-site —
site/lib/app/docs/の Getting Started / Architecture / Reference が実態と一致しているか
公式サイトの /docs は guides/ や HexDocs とは別ソースなので、片方だけ直すとドリフトする。
補足資料
- GitHub - ソースコード
- dialup-framework.org - ライブ MCP デモ