meta/immersive-web-sdk

آخر نشاط مصدر مسجل: ٢٢ أكتوبر ٢٠٢٦ في ٢٣:٥٩

آخر تحديث لفهرس SkillsMP: ٩ نوفمبر ٢٠٢٦ في ١٤:٢٢

skills مجمعة: ٢٨

نجوم GitHub: ٣٤٩
تفرعات GitHub: ٧٢

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

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

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

<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 للمستودع…

Skills في هذا المستودع

التصنيف قيد الانتظار

skill

المهنة

الوصف

آخر تحديث

iwsdk-glasses-test

غير مصنف

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…

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-ray

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-ui

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-dev

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-compose-scene

غير مصنف

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…

لغة النص الأصلي: الإنجليزية

2026-10-22

test-environment

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-10-22

click-target

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-10-22

test-all

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-10-22

test-grab

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-10-22

test-interactions

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-10-22

xr-mode-test

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-dev

غير مصنف

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…

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-grab

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-10-22

iwsdk-ui-panel

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-09-23

iwsdk-native-xr-test

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-09-23

test-ecs-core

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-09-21

test-level

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-09-21

test-physics

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-build-model

غير مصنف

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,…

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-pwa-packaging

غير مصنف

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,…

لغة النص الأصلي: الإنجليزية

2026-09-21

test-audio

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-09-21

test-locomotion

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-09-21

test-ui

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-migrate-0-5

غير مصنف

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…

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-debug

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-depth-occlusion

غير مصنف

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

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-physics

غير مصنف

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.

لغة النص الأصلي: الإنجليزية

2026-09-21

iwsdk-hosting

غير مصنف

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…

لغة النص الأصلي: الإنجليزية

2026-09-04

عرض ٢٨ من أصل ٢٨ skills مجمعة.