fix(starter-assets): update asset paths to use relative paths and improve GitHub Pages deployment

Summary:
- **Asset paths**: Changed all asset URLs from absolute paths (`/gltf/...`, `/ui/...`, `/audio/...`) to relative paths (`./gltf/...`, `./ui/...`, `./audio/...`) for better portability
- **GitHub Actions workflow**: Updated deployment to use official `actions/upload-pages-artifact` and `actions/deploy-pages` instead of third-party action
- **Workflow permissions**: Added explicit permissions for `contents`, `pages`, and `id-token` for secure deployment
- **Manual trigger**: Added `workflow_dispatch` to allow manual workflow runs
- **Documentation cleanup**: Removed references to non-existent chapters 9 and 10 from build guide
- **Code formatting**: Minor formatting improvement in panel.ts early return statement

Reviewed By: zjm-meta

Differential Revision:
D88116986

Privacy Context Container: L1334777

fbshipit-source-id: f48e2e0ee4b40c8c5bd047037f6fe428d7b18e2d

Author: felixtrz

docs/guides/08-build-deploy.md

@@ -138,7 +138,14 @@ name: Deploy to GitHub Pages
 
 on:
   push:
-    branches: [main]
+    branches: ['main']
+
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
 
 jobs:
   build-and-deploy:
@@ -160,12 +167,14 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v4
-        if: github.ref == 'refs/heads/main'
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./dist
+          path: './dist'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
 ```
 
 ## What's Next?
@@ -178,11 +187,6 @@ Throughout this tutorial, you've learned how to:
 - Create professional environments with lighting and backgrounds
 - Build interactive experiences with grabbing and locomotion
 - Develop custom systems and components using ECS architecture
-- Build and deploy optimized WebXR applications
-
-For developers ready to dive deeper into advanced IWSDK development, continue with:
-
-- **Chapter 9**: Advanced Topics - Explore physics simulation, scene understanding, and performance optimization
-- **Chapter 10**: Production Patterns - Learn enterprise-level development practices, testing strategies, and deployment pipelines
+- Build and deploy IWSDK applications
 
 You now have the foundation to create professional WebXR experiences with IWSDK!

packages/starter-assets/starter-template/metaspatial-ar/Composition/Main.scene

@@ -74,7 +74,7 @@ entities:
         com.iwsdk.components.Interactable:
           {}
         com.iwsdk.components.PanelUI:
-          config: /ui/welcome.uikitml
+          config: ./ui/welcome.uikitml
         com.iwsdk.components.ScreenSpace:
           height: 40%
           top: 20px

packages/starter-assets/starter-template/metaspatial-vr/Composition/Main.scene

@@ -106,7 +106,7 @@ entities:
         com.iwsdk.components.Interactable:
           {}
         com.iwsdk.components.PanelUI:
-          config: /ui/welcome.uikitml
+          config: ./ui/welcome.uikitml
         com.iwsdk.components.ScreenSpace:
           left: 20px
           top: 20px

packages/starter-assets/starter-template/src/index.template.ts

@@ -50,18 +50,18 @@ const assets: AssetManifest = {
   // @assets-manual-start
   // @assets-envdesk-start
   environmentDesk: {
-    url: '/gltf/environmentDesk/environmentDesk.gltf',
+    url: './gltf/environmentDesk/environmentDesk.gltf',
     type: AssetType.GLTF,
     priority: 'critical',
   },
   // @assets-envdesk-end
   plantSansevieria: {
-    url: '/gltf/plantSansevieria/plantSansevieria.gltf',
+    url: './gltf/plantSansevieria/plantSansevieria.gltf',
     type: AssetType.GLTF,
     priority: 'critical',
   },
   robot: {
-    url: '/gltf/robot/robot.gltf',
+    url: './gltf/robot/robot.gltf',
     type: AssetType.GLTF,
     priority: 'critical',
   },
@@ -78,7 +78,7 @@ World.create(document.getElementById('scene-container') as HTMLDivElement, {
   },
   features: {} /* @chef:app */,
   /* @template:if kind='metaspatial' */ level:
-    '/glxf/Composition.glxf' /* @template:end */,
+    './glxf/Composition.glxf' /* @template:end */,
 }).then((world) => {
   const { camera } = world;
   /* @template:if mode='ar' */
@@ -127,15 +127,15 @@ World.create(document.getElementById('scene-container') as HTMLDivElement, {
     .addComponent(Interactable)
     .addComponent(Robot)
     .addComponent(AudioSource, {
-      src: '/audio/chime.mp3',
+      src: './audio/chime.mp3',
       maxInstances: 3,
       playbackMode: PlaybackMode.FadeRestart,
     });
 
   const panelEntity = world
     .createTransformEntity()
     .addComponent(PanelUI, {
-      config: '/ui/welcome.json',
+      config: './ui/welcome.json',
       maxHeight: 0.8,
       maxWidth: 1.6,
     })

packages/starter-assets/starter-template/src/panel.ts

@@ -18,15 +18,17 @@ import {
 export class PanelSystem extends createSystem({
   welcomePanel: {
     required: [PanelUI, PanelDocument],
-    where: [eq(PanelUI, 'config', '/ui/welcome.json')],
+    where: [eq(PanelUI, 'config', './ui/welcome.json')],
   },
 }) {
   init() {
     this.queries.welcomePanel.subscribe('qualify', (entity) => {
       const document = PanelDocument.data.document[
         entity.index
       ] as UIKitDocument;
-      if (!document) return;
+      if (!document) {
+        return;
+      }
 
       const xrButton = document.getElementById('xr-button') as UIKit.Text;
       xrButton.addEventListener('click', () => {