Metadata-Version: 2.4
Name: nativehtmlkit-appshell
Version: 0.1.1
Summary: Development preview (not stable, not production-ready): NativeHTMLKit AppShell, a minimal Python desktop application with native package extensions
Author: NativeHTMLKit contributors
License-Expression: MIT
Project-URL: Homepage, https://nativehtmlkit.github.io/status/
Project-URL: Documentation, https://nativehtmlkit.github.io/
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nativehtmlkit<0.2,>=0.1.2
Requires-Dist: nativehtmlkit-ui<0.2,>=0.1.1
Dynamic: license-file

# NativeHTMLKit AppShell (Python edition)

> **Development preview: not stable and not production-ready.** NativeHTMLKit development is
> currently focused on Core. AppShell is under development: its contracts and commands can change
> without notice and it is not supported. For supported use, build on the NativeHTMLKit
> [Python SDK](https://nativehtmlkit.github.io/sdk/python/) directly. Project status: <https://nativehtmlkit.github.io/status/>

A small native desktop shell built with [NativeHTMLKit](https://nativehtmlkit.github.io/).
Extensions are ordinary Python packages; each one runs in its own uv environment and worker process.
No PowerShell, browser, web server or Node.js is involved.

Requires Python 3.10+ and [`uv`](https://docs.astral.sh/uv/) on `PATH` (AppShell creates one private
environment per extension). Linux (KDE Plasma Wayland) and Windows are qualified.

```bash
uv tool install nativehtmlkit-appshell
appshell generate python --id org.example.hello --output ./hello-extension
appshell stage add ./hello-extension     # applied on the next start
appshell run
```

Other commands: `appshell list`, `appshell doctor`, `appshell enable|disable|remove ID`,
`appshell run --safe-mode`, `appshell restore` (last-known-good configuration, with AppShell closed).
Pinned sources: `appshell stage add package==1.2.3` or `git+https://github.com/owner/repo@<40-hex-sha>`.
You can also copy an extension project or `.whl` into `$APPSHELL_HOME/extensions/` (shown on the
Extensions page) and restart.

Extensions run with your user permissions; install only code you trust. Write commands ask for
confirmation, and a write whose worker crashed or timed out is reported as an unknown outcome and never
retried. The contract, recovery rules and verification evidence are not public while AppShell is
in development.
