App Manifest

Every SkyScript app requires a manifest.yaml file in its root folder. This file defines metadata and behavior for the app.

Example

name: My App
hide_addressbar: true
framerate: 20

Fields

Field	Type	Default	Description
name	string	folder name	Display name shown in the Plugins menu.
url	string	—	URL to load. If omitted, SkyScript loads the local index.html. Alias: homepage.
hide_addressbar	boolean	false	Hide the built-in address bar. Recommended for apps that provide their own navigation.
audio_muted	boolean	false	Mute all audio from this app's browser.
framerate	integer	25	CEF rendering frame rate (FPS). Lower values reduce CPU usage.
minimum_width	integer	0	Minimum window width in pixels. 0 means no minimum.
scroll_speed	integer	5	Scroll sensitivity multiplier.
user_agent	string	(default Chrome UA)	Custom User-Agent header sent with every request.
forced_language	string	(auto-detected)	Override the browser language. Format: en-US,en or fr-FR,fr.
width	integer	1024	Initial window width in pixels.
height	integer	768	Initial window height in pixels.
console_logging	boolean	true	Forward console.log/warn/error to X-Plane's Log.txt. Set to false for noisy apps.
default	boolean	false	Default apps appear after a separator in the menu. Used for built-in apps like "About SkyScript".

Minimal Manifests

Local app (with index.html)

name: My App

URL-only app (no build step)

name: Navigraph Charts
url: https://charts.navigraph.com
hide_addressbar: true

A URL-only app needs only manifest.yaml — no package.json, no build step, no index.html.

How Apps Are Discovered

On aircraft load (or when Reload configuration is triggered), SkyScript scans the apps/ directory inside the plugin folder. Each subfolder containing a manifest.yaml is registered as an app.

The app's ID is derived from the folder name, prefixed with app-. For example:

Folder	App ID
apps/hello-world/	app-hello-world
apps/navigraph/	app-navigraph

This ID is used in dataref and command paths (e.g. skyscript/app-hello-world/toggle).