voltra

Voltra

これを Voltra スキルの単一のエントリーポイントとして使用してください。製品全体に関する信頼できる情報はここにまとめ、必要に応じて references/ からリファレンスを読み込んでください。

Voltra 全体に関する信頼できる情報

• Voltra のタスクでは、ネイティブプラットフォームの UI コードを生成しないでください。Voltra JSX と Voltra JS API を使用してください。
• ユーザーが既存の Voltra 対応 Android ウィジェットプレビュー XML ファイルの編集を明示的に求めている場合を除き、Swift、Kotlin、Java、Objective-C、プラットフォーム XML を生成しないでください。
• Voltra のタスクは、常にまず Voltra JavaScript または TypeScript API、JSX コンポーネント、Expo config plugin を使って解決してください。
• ネイティブコードが必要と思われるタスクでは、まず Voltra に JS API または設定オプションがすでに用意されているか確認してください。その方法を優先してください。
• ネイティブ拡張コードを手動でスキャフォールディングしないでください。ネイティブターゲットのセットアップは Voltra の config plugin が管理します。
• Voltra がレンダリングするツリー内で、プレーンな React Native プリミティブを使用しないでください。ライブアクティビティや Android ウィジェットのコンテンツには、View、Text、Pressable、TouchableOpacity などの RN UI プリミティブを使用しないでください。
• iOS アプリのコードでは、@use-voltra/ios から Voltra を、@use-voltra/ios-client からランタイム API をインポートしてください。
• Android アプリのコードでは、@use-voltra/android から VoltraAndroid を、@use-voltra/android-client からランタイム API をインポートしてください。
• ユーザーが共有抽象化を明示的に求めている場合を除き、iOS と Android の実装経路は分けてください。
• 登録に依存する UI コードを書く前に、設定を更新してください。
• 画像はネイティブコードの関心事ではなく、Voltra の関心事として扱ってください。Voltra の画像 props、Voltra アセットディレクトリ、Voltra のプリロード API を優先してください。
• ガイダンスが競合する場合は、まずこのスキルの内部リファレンスを優先し、次に use-voltra.dev のホストされたドキュメントを参照してください。
• より詳細なドキュメントが必要な場合は、https://use-voltra.dev のホストされたドキュメントを使用してください。

リファレンスの参照先

現在のタスクに必要なリファレンスだけを読んでください。

• セットアップ、インストール、Expo Dev Client、expo prebuild：references/setup.md
• React Native CLI プロジェクトと voltra apply：references/react-native-cli.md
• app.json、app.config.*、プラグインキー、ウィジェット登録、groupIdentifier、enablePushNotifications：references/app-config.md
• プラグインの正確なフィールドとウィジェット登録スキーマ：references/plugin-schema.md
• iOS ライブアクティビティ、Dynamic Island、ロック画面のバリエーション、補助アクティビティファミリー：references/ios-live-activities.md
• ライブアクティビティの各バリエーションの正確な形状：references/variant-shapes.md
• iOS ホーム画面ウィジェット、アクセサリーウィジェット、スケジュール済みウィジェット、ウィジェットタイムライン、ウィジェットファミリー、VoltraWidgetPreview、updateWidget、scheduleWidget、reloadWidgets、getActiveWidgets：references/ios-widgets.md
• iOS ウィジェットファミリーの正確な種類とフォールバック動作：references/widget-families.md
• iOS ウィジェット、ライブアクティビティ、Android ウィジェット向けのチャート：references/charts.md
• Android ウィジェット、Android ウィジェットプレビュー、事前レンダリング、ウィジェットの更新：references/android-widgets.md
• Android 継続通知、通知チャンネル、バックグラウンドタスクによる更新：references/android-ongoing-notifications.md
• サーバー駆動ウィジェット、serverUpdate、ウィジェットのポーリングフロー、createWidgetUpdateHandler、setWidgetServerCredentials、clearWidgetServerCredentials：references/server-driven-widgets.md
• Android コンポーネントの選択肢とウィジェット API チェックリスト：references/component-mapping.md、references/runtime-api-checklist.md
• APNS、プッシュトークン、プッシュ開始、チャンネル ID、サーバーでレンダリングされるライブアクティビティのペイロード：references/ios-server-updates.md および通常は references/ios-live-activities.md
• APNS フローの詳細：references/push-flow.md
• Voltra サーフェス向けの画像処理：references/images.md と対象サーフェスのリファレンス

作業スタイル

1. まず対象のプラットフォームと表示箇所を特定します。
2. 正しい Voltra 名前空間と JS エントリーポイントを確認します。
3. タスクにチャートが含まれる場合は、コードやドキュメントを書く前に、公開されている JSX のプロパティとプラットフォームの動作を確認します。
4. 登録に依存する UI コードを書く前に、設定を更新します。
5. タスクに必要なドメインのリファレンスのみを読みます。
6. 新たな抽象化を考案する前に、リポジトリにすでに存在する Voltra API を使用します。
7. 回答を依頼されたプラットフォームの範囲に限定します。

リファレンス一覧

• references/source-of-truth.md
• references/images.md
• references/setup.md
• references/react-native-cli.md
• references/app-config.md
• references/plugin-schema.md
• references/ios-live-activities.md
• references/variant-shapes.md
• references/ios-widgets.md
• references/widget-families.md
• references/charts.md
• references/android-widgets.md
• references/android-ongoing-notifications.md
• references/server-driven-widgets.md
• references/component-mapping.md
• references/runtime-api-checklist.md
• references/ios-server-updates.md
• references/push-flow.md