| name | expo-turso-dev |
| description | Expo + Turso + Drizzle ORMプロジェクトの開発コマンドと依存関係管理。アプリの起動、ライブラリのインストール、マイグレーション生成、キャッシュクリアなど開発コマンドを実行する時、または開発ワークフローについて質問された時に使用。重要:ライブラリインストールには必ずnpx expo installを使用。 |
Expo Turso Dev
Expo + Turso (LibSQL) + Drizzle ORMプロジェクトの開発コマンドと依存関係管理のクイックリファレンス。
開発コマンド
このプロジェクトは@antfu/niを使用してパッケージマネージャー(npm/yarn/pnpm/bun)を自動検出します。
開発サーバーの起動
nr start
nr ios
nr android
nr web
コード品質
nr lint
データベース操作
nr db:generate
キャッシュ管理
npx expo start -c
依存関係のインストール
重要: ライブラリ追加時は必ずnpx expo installを使用してください。
Expoのinstallコマンドは、プロジェクトのExpo SDKバージョン(~54.0.30)に基づいて互換性のあるバージョンを自動的に選択し、さらに使用中のパッケージマネージャー(このプロジェクトではbun)も自動検出します。
正しい方法
npx expo install <package-name>
npx expo install react-native-maps
間違った方法(避けるべき)
npm install react-native-maps
yarn add react-native-maps
bun add react-native-maps
理由: パッケージマネージャーで直接インストールすると、互換性のないバージョンがインストールされ、Expoビルドが壊れたりランタイムエラーが発生する可能性があります。npx expo installコマンドはSDKとの互換性を保証します。
コマンドリファレンス
nr: スクリプト実行(@antfu/ni)- パッケージマネージャーを自動検出してnpm run/bun run等を実行
npx expo: Expo CLI - パッケージマネージャーとSDKバージョンを自動検出
プロジェクトコンテキスト
このプロジェクトで使用している技術:
- Expo Router:
src/app/でのファイルベースルーティング
- Turso (LibSQL): クラウドデータベース同期(オプション、iOS/Androidのみ)
- Drizzle ORM: タイプセーフなデータベース操作
- expo-sqlite: ローカルSQLiteデータベース
データベースは2つのモードで動作:
- ローカルモード: 環境変数不要、SQLiteのみ
- Tursoモード:
EXPO_TURSO_DB_URLとEXPO_TURSO_DB_AUTH_TOKENが設定されている場合、クラウドと同期