From meta-vr
Guides end-to-end Meta Quest and Horizon OS app submission to Meta Horizon Store: build validation, VRC compliance, asset preparation, upload, and tracking. Use for Quest app publishing prep.
npx claudepluginhub meta-quest/agentic-tools --plugin meta-vrThis skill is limited to using the following tools:
Guide the end-to-end process of submitting a Meta Quest application to the Meta Horizon Store. This skill covers build validation, VRC compliance checking, store asset preparation, upload, and submission tracking.
Validates Meta Quest and Horizon OS apps against VRC store publishing requirements. Checks project config, entitlements, manifest, permissions for Quest Store submission prep.
Routes App Store submission tasks to specialist skills: pre-submission checklists, rejection diagnosis, metadata specs, privacy manifests, age ratings, export compliance, and appeals.
Checks iOS app readiness for App Store submission and drives asc CLI release flow, fixing first-time issues for availability, IAP, subscriptions, Game Center, and App Privacy.
Share bugs, ideas, or general feedback.
Guide the end-to-end process of submitting a Meta Quest application to the Meta Horizon Store. This skill covers build validation, VRC compliance checking, store asset preparation, upload, and submission tracking.
Use this skill when you need to:
This skill references the hz-vrc-check skill for detailed VRC validation. If hz-vrc-check is installed, invoke it for thorough compliance testing before proceeding to submission.
The full submission process follows this order:
1. Build Validation → Verify APK is correctly signed, targets ARM64, meets packaging requirements
2. VRC Compliance → Run through VRC checklist, fix any violations
3. Asset Preparation → Prepare store listing images, videos, descriptions, metadata
4. Dashboard Setup → Create app on developer.meta.com, configure pricing, age rating
5. Upload → Upload the build to the platform
6. Submission → Submit for review
7. Tracking → Monitor review status, respond to feedback
Before uploading, validate the APK meets basic packaging requirements.
The release APK must be signed with an Android keystore. Debug-signed APKs will be rejected.
# Verify the APK is signed (not debug-signed)
hzdb adb shell "pm dump <package> | grep -i signature"
The signing key must remain consistent across updates. Changing the signing key requires a new app entry.
# Install the APK on a connected device to test
hzdb app install path/to/release.apk
# Verify it launches correctly
hzdb app launch <package>
# Check the manifest for required fields
hzdb adb shell "dumpsys package <package> | head -50"
Required manifest elements:
android:targetSdkVersion >= 32android:minSdkVersion >= 29com.oculus.intent.category.VR intent categoryRun the app on a Quest device and verify:
# Monitor frame rate
hzdb adb logcat --tag VrApi | grep FPS
# Check thermal state
hzdb device battery
# Watch for thermal warnings
hzdb adb logcat --tag ThermalService --level W
Run through the VRC checklist. If the hz-vrc-check skill is installed, invoke it for a detailed walkthrough. Key VRC categories:
Common VRC rejection reasons:
| Rejection Reason | Fix |
|---|---|
| Crash during review | Fix the crash. Run hzdb adb logcat --buffer crash to investigate. |
| Frame rate below threshold | Optimize rendering. Profile with Perfetto or OVR Metrics Tool. |
| Missing store assets | Ensure all required images are uploaded at correct dimensions. |
| Disallowed permissions | Remove permissions not needed by the app (e.g., CALL_PHONE, SEND_SMS). |
| Text in unsafe zone of hero art | Keep text within the inner 80% safe area of hero images. |
The Meta Horizon Store requires specific assets for the store listing.
| Asset | Dimensions | Format | Notes |
|---|---|---|---|
| App icon | 1024 x 1024 px | PNG or JPEG | Square, no rounded corners (system applies them) |
| Hero art (landscape) | 2560 x 1440 px | PNG or JPEG | Main store listing image. Keep text in inner 80% safe area. |
| Screenshots | 2560 x 1440 px | PNG or JPEG | Minimum 3 screenshots. Captured from the app, not mockups. |
| Small landscape (optional) | 1280 x 720 px | PNG or JPEG | Used in some store placements |
Upload the signed release APK through the developer dashboard or via CLI:
# The dashboard upload is preferred for first submissions.
# For subsequent builds, you can use the ovr-platform-util CLI:
ovr-platform-util upload-quest-build --app-id <APP_ID> \
--app-secret <APP_SECRET> \
--apk path/to/release.apk \
--channel STORE
After upload, verify the build appears in the dashboard with the correct version code and architecture.
Plan for a review period of approximately 1-2 weeks. Submit at least 2 weeks before your target launch date.
After submission:
Post-approval: