Metadata-Version: 2.3
Name: whitebox-plugin-demo-mode
Version: 0.1.5
Summary: Plugin description
License: GNU Affero General Public License v3
Author: Milos
Author-email: hello@klined.org
Requires-Python: >=3.14.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown

# Whitebox Plugin - Demo Mode

This is a plugin for [whitebox](https://gitlab.com/whitebox-aero) that runs the instance in demo mode.

## Installation

Simply install the plugin to whitebox:

```
poetry add whitebox-plugin-demo-mode
```

## Frontend development

In a prepared core backend dev container, use `make test-frontend` for the selected
source suite. Ordinary Python archives contain JSX; core explicitly assembles
the installed separate remote. Follow the shared [frontend package guide](https://docs.whitebox.aero/plugin_guide/#independent-frontend-packages)
and [JSX testing guide](https://docs.whitebox.aero/plugin_guide/#testing-jsx-code)
for prerequisites, assembly/restart lifecycle and private test setup.

In core, demo is an optional `plugins-demo` installation. From the backend
environment, install it with `poetry install --with plugins-demo`, explicitly
assemble with `make prepare-frontend-tools build_federation_modules`, then set
`DEMO_MODE=1` and a valid `DEMO_MODE_FLIGHT_SESSION_ID` for the running backend.
Normal production does not select this group. Installing the service without a
target reports an error. Core's [full application contract](https://gitlab.com/whitebox-aero/whitebox/-/blob/main/frontend/tests/packaged-remotes/README.md)
checks real session loading and playback idempotency separately from source mocks.

## Additional Instructions

- [Plugin Development Guide](https://docs.whitebox.aero/plugin_guide/#plugin-development-workflow)
- [Plugin Testing Guide](https://docs.whitebox.aero/plugin_guide/#testing-plugins)
- [Contributing Guidelines](https://docs.whitebox.aero/development_guide/#contributing)

