hz-store-pwa

Package web apps as PWAs or TWAs for the Meta Quest Store.

176|17|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/meta-quest/agentic-tools --skill hz-store-pwa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hz-store-pwa
Source: https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-store-pwa
Command: npx skills add https://github.com/meta-quest/agentic-tools --skill hz-store-pwa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill guides developers through the entire process of packaging and shipping a web app to the Meta Quest and Horizon OS Store, ensuring it is properly configured as a Progressive Web App (PWA) or Trusted Web Activity (TWA).

Core Features & Use Cases

  • End-to-End Process: Walks through building, deploying, and uploading a web app as a PWA/TWA for both 2D and immersive experiences.
  • Mode Selection: Assists in choosing between 2D windowed panels and immersive WebXR/VR experiences.
  • Build, Deploy, and Upload: Provides detailed instructions for each step, including building the web app, deploying to Vercel, creating a PWA manifest, packaging as an APK, and uploading to the Store.
  • Troubleshooting: Offers guidance on common issues like mode mismatches, signing key management, and deployment errors.

Quick Start

Use the hz-store-pwa skill to deploy your web app to the Meta Horizon Store as a PWA/TWA.

Frequently Asked Questions about hz-store-pwa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a web app to the Meta Quest Store as a PWA?

To publish a web app to the Meta Quest Store as a PWA, you must build the web application, deploy it to a hosting service like Vercel, create a PWA manifest, package it into an APK, and upload it to the Horizon OS Store.

What is the difference between 2D windowed panels and immersive WebXR experiences on Horizon OS?

The difference between 2D windowed panels and immersive WebXR experiences on Horizon OS lies in user interaction: 2D panels function as flat windows within the VR environment, while WebXR provides fully immersive VR content rendered into the headset.

Can I deploy my existing PWA to Horizon OS using Vercel?

Yes, you can deploy your existing PWA to Horizon OS using Vercel by hosting the web assets on Vercel, generating a PWA manifest, and then packaging the hosted application into an APK for the Meta Quest Store.

How do I package a TWA for Meta Quest?

To package a TWA for Meta Quest, you need to configure your web app's manifest, use the appropriate tooling to generate an APK from the Trusted Web Activity URL, and ensure the signing key is properly managed before uploading.

Why does my Meta Quest PWA open in the wrong display mode?

A Meta Quest PWA may open in the wrong display mode due to a mode mismatch in the app manifest or configuration, which requires adjusting the settings to explicitly select either a 2D windowed panel or an immersive WebXR experience.

Do I need an APK to upload a web app to the Meta Horizon Store?

Yes, you need an APK to upload a web app to the Meta Horizon Store because the system requires the web application to be packaged as an Android application bundle using PWA or TWA standards before submission.