モバイルプロジェクトの作成

このページでは、Accel CLI（@intra-mart/accel）でモバイルプロジェクトを作成する手順を解説します。 Accel CLI の基本的な使い方は、新規プロジェクトの作成を参照してください。

必要な環境

項目	内容
Accel CLI	2.0.0 以降。`bunx @intra-mart/accel` で実行すると最新版が使われます
Bun	Accel CLI の実行と、アプリの依存の管理に使います（ツールのインストール）
Node.js / npm	v22 以上。Expo のツールの実行に使います。パッケージマネージャに Bun を使う場合も必要です
Git	create-expo による初回コミットと、Expo 公式 skills の導入に使います
ネットワーク	npm レジストリと GitHub に接続できること

iAP のユーザモジュールの開発で使う Java（JDK）と Maven は、モバイルプロジェクトでは使いません。

アプリを実機やエミュレータで動かすには、このほかに次のどちらかを用意します。詳しくは AIネイティブ開発の流れを参照してください。

ローカルでビルドする場合：Android Studio（Android）、Xcode（iOS。macOS のみ）
EAS でビルドする場合：Expo のアカウント

新規プロジェクトの作成

任意のディレクトリ（例: ~/projects）に移動してから、次のコマンドを実行します。

bunx @intra-mart/accel init my-app

my-app の部分は作成したいプロジェクト名に置き換えてください。実行すると、CLI が対話形式で設定を尋ねてきます。画面の案内に従って選択してください。

プロジェクトの種別

モバイルプロジェクト（Expo + smartlime） を選択します。

o  プロジェクトの種別を選択してください
|  iAP のモジュール開発か、iAP と連携するモバイルアプリ（Expo + smartlime）の開発かを選びます
|  モバイルプロジェクト（Expo + smartlime）

プロジェクト名

プロジェクト名を指定します。英小文字・数字・@ . _ - が使え、先頭は英小文字か数字にします。

o  プロジェクト名を入力してください
ディレクトリ名と、アプリの名前（create-expo が設定）に使われます
英小文字・数字・@ . _ - が使え、先頭は英小文字か数字です（例: field-report）
|  my-app

連携する iAP のバージョン

アプリが連携する iAP のバージョンを選択します。呼び出せる API に合わせて、配備される資材の内容が変わります。

o  連携する iAP のバージョンを選択してください
|  アプリが連携する iAP のバージョン。呼び出せる API に合わせて資材の内容が変わります
|  2026 Autumn (8.0.40)

Expo SDK

アプリの Expo SDK を選択します。smartlime が対応している SDK だけが選択肢に表示されます。

o  Expo SDK を選択してください
|  create-expo のテンプレートと、配備する資材が対象とする SDK です。smartlime が対応する SDK だけが選択肢に出ます
|  Expo SDK 56

利用するエージェント

開発で利用するエージェントを選択します。Claude Code / OpenAI Codex から選択できます。複数選択することも可能です。

o  エージェントを選択してください
|  選択したエージェント向けの指示書や skills を配備します
|  Codex を選ぶと、Expo 公式 skills も導入できます
|  claude-code, codex

GitHub Copilot について

モバイルプロジェクトでは、GitHub Copilot は選択できません。

Expo 公式 skills の導入

エージェントに Codex を選んだ場合に表示されます。Yes を選ぶと、Expo が公開している Expo 公式 skills を .agents/skills/ に導入します。

o  Expo 公式 skills を導入しますか？
|  Codex 向けに github.com/expo/skills から取得し、.agents/skills に配置します
|  実行するコマンド: ...
|  Yes

Claude Code では、Expo 公式の Claude Code プラグインを有効にする設定が配備されるため、この確認はありません。

設定の確認

最後に、入力した設定と、実行するコマンドの一覧が表示されます。内容を確認して Yes を選ぶと、プロジェクトの作成が始まります。

o  配備設定 ─────────────────────────────╮
|                                       |
|  プロジェクト名: my-app                |
|  連携先 iAP バージョン: 2026-autumn    |
|  Expo SDK: 56                         |
|  エージェント: claude-code, codex      |
|  ...                                  |
|                                       |
|  実行するコマンド:                     |
|    ...                                |
|                                       |
├───────────────────────────────────────╯
o  この内容でプロジェクトを作成しますか？
|  Yes

init コマンドは、次の順に処理します。

Expo 公式の create-expo を実行して、アプリのひな形を作成します。依存のインストールと Git の初回コミットも create-expo が行います。
smartlime 用のスキルセットや AGENTS.md などの資材を配備します。
Codex で Expo 公式 skills の導入を選んだ場合は、.agents/skills/ に導入します。

外部パッケージの利用について

モバイルプロジェクトの作成では、Accel CLI が create-expo などの外部パッケージを内部で実行します。使用するバージョンは Expo SDK に合わせて自動で決まります。各パッケージの動作は、それぞれの提供元の仕様に従います。

作成後の作業

配備した資材は、未コミットの変更として残ります。内容を確認してコミットしてください。

cd my-app
git add -A
git commit -m "Add Accel assets"

プロジェクトの内容

モバイルプロジェクトは、create-expo が作成したファイル一式に、Accel CLI が配備する資材が加わった構成になります。

my-app
   ├ src
   │  └ app               - 画面（Expo Router のルート）を配置するディレクトリ
   ├ assets               - アイコンや画像
   ├ app.json             - アプリの設定（名前、URL scheme など）
   ├ package.json         - 依存ライブラリと start などのスクリプトを定義
   ├ .accel
   │  └ settings.json     - Accel CLI のプロジェクト設定
   ├ AGENTS.md            - エージェント向けの規約ファイル
   ├ CLAUDE.md            - Claude Code を選択した場合に生成（AGENTS.md を読み込む）
   ├ .claude              - Claude Code を選択した場合に生成
   │  ├ settings.json     - Expo プラグインを有効にする設定
   │  └ skills            - smartlime のスキルセット
   ├ .agents              - Codex を選択した場合に生成
   │  └ skills            - smartlime のスキルセットと Expo 公式 skills
   └ .codex               - Codex を選択した場合に生成
      └ config.toml       - Expo MCP サーバの設定

各ファイルの役割はスキルセットを参照してください。

既存の Expo プロジェクトに資材を配備する

すでにある Expo のプロジェクトに、モバイルプロジェクトの資材だけを配備することもできます。プロジェクトのルートディレクトリで attach コマンドを実行します。

cd my-existing-app
bunx @intra-mart/accel attach

package.json の expo のバージョンから Expo SDK を判定します。expo を使っているプロジェクトでは、プロジェクトの種別の既定値がモバイルプロジェクトになります。

資材の更新

資材を最新にするには、プロジェクトのルートディレクトリで update コマンドを実行します。編集したファイルの扱いは、iAP のプロジェクトと同じです（テンプレートの更新）。

bunx @intra-mart/accel update

update は資材だけを更新します。アプリの Expo SDK は更新しません。
アプリの Expo SDK を上げた後に update を実行すると、資材を新しい SDK 用に切り替えるか確認されます。
Expo 公式 skills は Accel CLI の管理対象ではありません。更新は npx skills update で行ってください。

iAP のプロジェクトとの違い

コマンド	モバイルプロジェクトでの扱い
`init` / `attach`	create-expo を使って作成する。iAP 専用の設定（モジュール、機能、データベース、アーティファクト ID など）は尋ねられない
`update`	資材を更新する。Expo SDK は更新しない
`switch` / `preset`	エージェントだけを切り替えられる
`deploy`	利用できない（アプリは iAP にデプロイするものではないため）

オプションの詳細について

非対話モードで実行する場合のオプションなどの詳細は、Accel CLI の README の「モバイルアプリ開発（Expo + smartlime）」を参照してください。

必要な環境​

新規プロジェクトの作成​

プロジェクトの種別​

プロジェクト名​

連携する iAP のバージョン​

Expo SDK​

利用するエージェント​

Expo 公式 skills の導入​

設定の確認​

作成後の作業​

プロジェクトの内容​

既存の Expo プロジェクトに資材を配備する​

資材の更新​

iAP のプロジェクトとの違い​