meta/immersive-web-sdk

Letzte erfasste Quellaktivität: 22. Oktober 2026 um 23:59

SkillsMP-Katalog aktualisiert: 9. November 2026 um 14:22

gesammelte Skills: 28

GitHub-Stars: 349
GitHub-Forks: 72

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/meta/immersive-web-sdk.

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

<h1 align="center">Immersive Web SDK</h1> <p align="center"> <a href="https://www.npmjs.com/package/@iwsdk/core"><img src="https://badgen.net/npm/v/@iwsdk/core/?icon=npm&color=orange" alt="npm version" /></a> <a href="https://www.npmjs.com/package/@iwsdk/core"><img src="https://badgen.net/npm/dt/@iwsdk/core" alt="npm download" /></a> <a href="https://www.typescriptlang.org/"><img src="https://badgen.net/badge/icon/typescript/?icon=typescript&label=lang" alt="language" /></a> <a href="https://raw.githubusercontent.com/facebook/immersive-web-sdk/main/LICENSE"><img src="https://badgen.net/github/license/facebook/immersive-web-sdk/" alt="license" /></a> </p> <p align="center"><strong>Where every webpage can become a world.</strong></p> The **Immersive Web SDK** makes building immersive web experiences as approachable as traditional web development. It's a complete collection of frameworks and tools built on **Three.js** with a high-performance **Entity Component System**, **developer-first workflow** with one-command setup and built-in emulation, and **production-ready systems** for grab interactions, locomotion, spatial audio, physics, and scene understanding. **Same code, two experiences**: Run immersively in VR/AR headsets and automatically provide mouse-and-keyboard emulation on desktop browsers. No browser extensions, no special setup—anyone with a laptop can develop for the immersive web. ## Getting Started Create a new project with a single command: ```bash npm create @iwsdk@latest ``` Or install into an existing project: ```bash npm install @iwsdk/core three@npm:super-three@0.185.0 ``` Keep the exact `three` alias at the application root and override transitive resolutions so the app and IWSDK share one runtime. npm reads the override from `package.json`: ```json { "dependencies": { "@iwsdk/core": "^1.0.0", "three": "npm:super-three@0.185.0" }, "overrides": { "three": "npm:super-three@0.185.0" } } ``` pnpm 10 and 11 read root overrides from `pnpm-workspace.yaml`: ```yaml packages: - '.' overrides: three: npm:super-three@0.185.0 ``` ## Documentation For guides, concepts, and API reference, visit: **[https://iwsdk.dev](https://iwsdk.dev)** ## Packages | Package | Description | | ---------------------------------------------------- | ------------------------------------------------- | | [@iwsdk/core](./packages/core) | Core SDK with ECS, systems, and WebXR integration | | [@iwsdk/create](./packages/create) | CLI for scaffolding new projects | | [@iwsdk/locomotor](./packages/locomotor) | Locomotion engine for Three.js WebXR | | [@iwsdk/xr-input](./packages/xr-input) | WebXR input system for Three.js | | [@iwsdk/vite-plugin-dev](./packages/vite-plugin-dev) | XR emulation, AI agent tooling, and dev browser | ## Development ```bash # Use the pinned Node major, install dependencies, and build runtime/tooling packages nvm use corepack pnpm@10.18.3 run bootstrap # Build every workspace package, including the generated reference corpus corepack pnpm@10.18.3 run build:all # Build all packages as tgz files (for examples to consume) npm run build:tgz # Type-check every example as a fresh consumer of locally built tgz packages corepack pnpm@10.18.3 run typecheck:examples # Run an example (fresh install from local tgz packages) cd examples/locomotion && npm run fresh:dev # Lint and format corepack pnpm@10.18.3 run lint corepack pnpm@10.18.3 run format # Build a specific package corepack pnpm@10.18.3 --filter @iwsdk/core build ``` `bootstrap` is also the repair command for a partial or stale source build. It uses the lockfile, builds runtime and tooling packages in dependency order, and generates WebXR input profiles from the pinned npm asset package instead of making a separate CDN request. It deliberately leaves out the producer-only `@iwsdk/reference-assets` package. `build:all` includes that package by running its full ingest pipeline, which downloads the pinned embedding model on a fresh machine. Run `corepack pnpm@10.18.3 run doctor` for environment, proxy, and generated-output checks. For a network-restricted checkout whose pnpm store is already warm, use `corepack pnpm@10.18.3 run bootstrap:offline`. Initial dependency installation still needs registry access (and honors standard npm/pnpm proxy configuration), but subsequent profile generation and builds are offline-safe. A directory-linked `@iwsdk/cli` now keeps a stable launcher; if its `dist` is missing, it prints the exact package build command instead of leaving a broken executable link. ### Development Workflow The examples use `file:` dependencies pointing to `.tgz` files built from local packages. This simulates how end-users will consume the packages from npm. 1. **`npm run build:tgz`** - Builds all packages in dependency order and creates `.tgz` archives 2. **`npm run fresh:dev`** (in example) - Cleans `node_modules`, reinstalls from tgz files, and starts dev server This ensures examples always test against the latest local build. `typecheck:examples` applies the same boundary to every TypeScript example: it rebuilds development tarballs, removes each example's ignored install state, installs from those tarballs, and invokes that example's local TypeScript binary. ## License IWSDK is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details. ## Contributing Contributions are welcome! Please review our [Contributing Guidelines](./CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) before submitting issues or pull requests. ## Developer Terms - [Open Source Terms of Use](https://opensource.fb.com/legal/terms) - [Open Source Privacy Policy](https://opensource.fb.com/legal/privacy)

README des Repositorys wird geladen…

Skills in diesem Repository

Klassifizierung ausstehend

Skill

Beruf

Beschreibung

Aktualisiert

iwsdk-glasses-test

nicht klassifiziert

Test an IWSDK app for Meta VR Glasses — gaze-and-pinch input, the glasses' narrower field of view, and gaze preview on a Quest without eye tracking. Use when the user targets Meta VR Glasses, asks for gaze or eye-tracking input, or wants to check that content…

Quellsprache: Englisch

2026-10-22

iwsdk-ray

nicht klassifiziert

Verify ray clicks, UIKit selections, and DistanceGrabbable interactions with emulated XR controllers. Use for pointing, selecting, pressing spatial UI, or moving an object through a distance grab.

Quellsprache: Englisch

2026-10-22

iwsdk-ui

nicht klassifiziert

Build or modify manifest-backed IWSDK UIKitML with bounded preview, placement, and runtime verification. Use for spatial panels, browser HUDs, UIKitML layout, fonts, editor previews, and runtime element behavior.

Quellsprache: Englisch

2026-10-22

iwsdk-dev

nicht klassifiziert

Single entry point for IWSDK development. Invoke first for every IWSDK implementation request. Routes fresh builds to an internal planning playbook and bounded changes to an established app to an internal iteration playbook.

Quellsprache: Englisch

2026-10-22

iwsdk-compose-scene

nicht klassifiziert

Compose and review IWSDK scenes from existing manifest assets using scene JSON, placement, scale, contacts, prefabs, patterns, lighting, environment, cameras, and final framing. Does not author geometry or materials; create or repair an individual 3D asset…

Quellsprache: Englisch

2026-10-22

test-environment

nicht klassifiziert

Test environment system (authored DomeGradient and IBLGradient, component schemas) against the poke example using the iwsdk CLI.

Quellsprache: Englisch

2026-10-22

click-target

nicht klassifiziert

Find and click a target object in XR. Use when testing UI interactions, clicking buttons, or verifying interactable elements work correctly.

Quellsprache: Englisch

2026-10-22

test-all

nicht klassifiziert

Parallel test orchestrator. Runs all 9 test suites concurrently via Task sub-agents and the iwsdk CLI. Handles build, example setup, dev servers, agent launch, polling, retries, and result aggregation.

Quellsprache: Englisch

2026-10-22

test-grab

nicht klassifiziert

Test grab system (distance grab, one-hand grab, two-hand grab, hand pinch grab) against the grab example using the iwsdk CLI.

Quellsprache: Englisch

2026-10-22

test-interactions

nicht klassifiziert

Test XR interactions (ray, poke/touch, dual-mode, hand poke, audio, UI panel) against the poke example using the iwsdk CLI.

Quellsprache: Englisch

2026-10-22

xr-mode-test

nicht klassifiziert

Test XR session lifecycle and mode transitions. Use when verifying XR enter/exit behavior, testing mode-dependent features, or debugging session state issues.

Quellsprache: Englisch

2026-10-22

iwsdk-dev

nicht klassifiziert

MUST read this skill BEFORE developing VR/MR/desktop 3D applications using IWSDK (Immersive Web SDK). Covers project scaffolding, headless browser setup, CLI tools, reference system, ECS debugging, XR emulation, verification workflows, deployment, and known…

Quellsprache: Englisch

2026-10-22

iwsdk-grab

nicht klassifiziert

Use emulated XR controllers or hands to verify proximity grabbing for OneHandGrabbable and TwoHandsGrabbable objects. Use for pick up, move, release, or regression-test requests involving near-hand grab with the squeeze button or a hand pinch.

Quellsprache: Englisch

2026-10-22

iwsdk-ui-panel

nicht klassifiziert

Create, place, preview, debug, and connect manifest-backed IWSDK UIKitML assets. Use for spatial panels, browser HUDs, UIKitML layout, fonts, editor previews, or runtime element behavior.

Quellsprache: Englisch

2026-09-23

iwsdk-native-xr-test

nicht klassifiziert

Test an IWSDK app in a real Quest immersive session while controlling headset and controller poses through the IWSDK CLI. Use when the user asks to run, automate, or debug an app on a connected Quest rather than in desktop IWER emulation.

Quellsprache: Englisch

2026-09-23

test-ecs-core

nicht klassifiziert

Test ECS core functionality (system registration, components, Transform sync, pause/step/resume, system toggle, entity discovery, snapshots) against the poke example using the iwsdk CLI.

Quellsprache: Englisch

2026-09-21

test-level

nicht klassifiziert

Test level system (LevelRoot, LevelTag, authored environment, scene hierarchy) against the poke example using the iwsdk CLI.

Quellsprache: Englisch

2026-09-21

test-physics

nicht klassifiziert

Test Havok physics system (gravity, rigid bodies, static vs dynamic) against the physics example using the iwsdk CLI.

Quellsprache: Englisch

2026-09-21

iwsdk-build-model

nicht klassifiziert

Build or materially repair one reusable IWSDK 3D model as a glTF or deterministic parentless Three.js Object3D, including geometry, surface-relative detail, materials, semantic hierarchy, isolated inspection, and focused refinement. Does not arrange scenes,…

Quellsprache: Englisch

2026-09-21

iwsdk-pwa-packaging

nicht klassifiziert

Ship an IWSDK app to Meta Quest and the Horizon Store as a PWA/TWA — both immersive WebXR and 2D windowed panel modes. Use for PWA packaging, web app manifest and icons, auto-enter-XR on launch, bubblewrap APK builds, signing keystores, Digital Asset Links,…

Quellsprache: Englisch

2026-09-21

test-audio

nicht klassifiziert

Test audio system (AudioSource loading, playback state, stop, spatial audio) against the audio example using the iwsdk CLI.

Quellsprache: Englisch

2026-09-21

test-locomotion

nicht klassifiziert

Test locomotion system (slide, snap turn, teleport, jump) against the locomotion example using the iwsdk CLI.

Quellsprache: Englisch

2026-09-21

test-ui

nicht klassifiziert

Test UIKitML asset and ScreenSpace UI behavior against the poke example using the iwsdk CLI.

Quellsprache: Englisch

2026-09-21

iwsdk-migrate-0-5

nicht klassifiziert

Migrate an existing IWSDK 0.4.x application to IWSDK 0.5.0. Use when upgrading across the 0.5 boundary, replacing Meta Spatial Editor or GLXF, removing retired Vite plugins, moving UIKitML to runtime-loaded assets, adopting native scene JSON, or resolving 0.5…

Quellsprache: Englisch

2026-09-21

iwsdk-debug

nicht klassifiziert

Diagnose and verify real-time IWSDK behavior with bounded ECS pause, query, snapshot, step, and diff loops. Use for physics, animation, collision, interaction, or state bugs that cannot be proven from a screenshot.

Quellsprache: Englisch

2026-09-21

iwsdk-depth-occlusion

nicht klassifiziert

Add or repair IWSDK WebXR depth sensing and real-world occlusion in AR. Use for DepthSensingSystem, DepthOccludable, occlusion modes, or passthrough depth troubleshooting.

Quellsprache: Englisch

2026-09-21

iwsdk-physics

nicht klassifiziert

Add or repair IWSDK rigid-body simulation, collision shapes, forces, and physics-aware grabbing. Use for gravity, falling, collision, bouncing, kinematic motion, or physics tuning.

Quellsprache: Englisch

2026-09-21

iwsdk-hosting

nicht klassifiziert

Publish an IWSDK app to a public HTTPS origin so it can be installed as a PWA and packaged for the Meta Horizon Store. Use when deploying, hosting, or publishing the app, choosing a host, or when a file (web manifest, icons, .well-known/assetlinks.json) must…

Quellsprache: Englisch

2026-09-04

Es werden 28 von 28 gesammelten Skills angezeigt.