aframe-webxr

Create browser-based VR and AR experiences using A-Frame's HTML entity-component architecture.

1|Updated Jun 2, 2026
One-click install
npx skills add https://github.com/ZimriJahdai/HaircutFiveFriends-Full --skill aframe-webxr-zimrijahdai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aframe-webxr
Source: https://github.com/ZimriJahdai/HaircutFiveFriends-Full/tree/main/.claude/.agents/skills/aframe-webxr
Command: npx skills add https://github.com/ZimriJahdai/HaircutFiveFriends-Full --skill aframe-webxr-zimrijahdai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building WebXR applications typically requires deep Three.js and WebGL expertise, making VR and AR development inaccessible to web developers who want to create immersive experiences with familiar HTML patterns. ## Core Features & Use Cases - Declarative 3D Scenes: Build 3D scenes with HTML primitives like a-box, a-sphere, and a-sky using the entity-component-system architecture. - VR Controller Interactions: Implement hand tracking, laser controls, and grabbable objects with hand-controls and custom components. - AR Hit Testing: Place virtual objects on real-world surfaces using the ar-hit-test component with WebXR. - 360° Media Viewers: Create interactive photo and video galleries with sky primitives and gaze-based cursors. - Use Case: Build a cross-platform VR product showroom where users navigate with controllers, grab 3D product models, and view 360° environment images, all from a single HTML file. ## Quick Start Create an A-Frame VR scene with interactive objects, controller support, and a 360-degree sky background.

Frequently Asked Questions about aframe-webxr

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

FAQPage Schema
How do I create a VR scene with A-Frame?

Create an a-scene element containing primitive entities like a-box, a-sphere, and a-sky, then load the A-Frame library from the CDN. The scene automatically injects a default camera with look controls and WASD movement.

How to add VR controller interactions in A-Frame?

Add hand-controls and laser-controls components to entities inside a camera rig, one for each hand. Listen for triggerdown, gripdown, and related events to implement grabbing and manipulation of objects.

Does A-Frame support AR hit testing on mobile?

Yes, A-Frame supports AR hit testing through the ar-hit-test component combined with the webxr system configured with hit-test and dom-overlay optional features. Users tap the screen to place virtual objects on detected real-world surfaces.

A-Frame vs Three.js for WebXR development?

A-Frame provides a declarative HTML layer over Three.js, making it faster for standard VR scenes with minimal JavaScript. Use Three.js directly when you need fine-grained control over rendering pipelines beyond A-Frame's component model.

Why are my A-Frame entities not appearing in the scene?

Entities may be positioned behind the camera, have zero scale, or be added before the scene loads. Wait for the scene's loaded event, verify positions are in front of the camera at negative z values, and check the entity is attached to the scene.

How do I improve A-Frame performance on mobile VR?

Reduce renderer canvas size, use low-poly geometry with fewer segments, limit the number of lights, and pool entities instead of creating and destroying them. Throttle tick functions and use the stats component to monitor frame rates.