launch-app

name	launch-app
description	Launch Matrix OS runtime surfaces for validation. Use when Symphony agents need runtime checks for shell, gateway, platform, website, or bundled app changes in this repo.

Launch App

Local Runtime

Matrix OS uses bun for scripts and pnpm for installs.

pnpm install --frozen-lockfile
bun run dev

This starts gateway, proxy, and shell together. For narrower checks:

bun run dev:gateway
bun run dev:shell
bun run dev:platform
bun run dev:www

Bundled Default Apps

First-party apps live under home/apps/** and build to dist/.

node scripts/build-default-apps.mjs home/apps

For one app, run its own build from the app directory:

pnpm --dir home/apps/symphony install
pnpm --dir home/apps/symphony build

Validation

• Canvas is the primary shell surface; verify user-visible shell changes there first.
• Built-in app paths must work in Canvas and Desktop.
• For bundled apps, verify dist/index.html exists before handoff.
• Run the relevant targeted tests, then the repo gates when scope warrants:

  bun run typecheck
  bun run check:patterns
  bun run test