BOSS allows you to make web apps look like a native 2bit Mac OS applications.
- Launch apps from the
Applicationsmenu - Uses familiar UI language
- Easily install apps on your server from
Applications- If there's interest, I may add a
Web App Store
- If there's interest, I may add a
Signalling patterns are inspired by iOS's UIKit. It's a suprisingly good pattern for web apps (delegation and full view lifecycle events).
This is a work in progress. Updates, and tutorials, will be shared on X.com.
You can test the OS by visiting bithead.io.
Tap on the BOSS OS menu (top left icon) and then tap Show tutorial. This will open the Tutorial application, which shows all BOSS UI components and several examples showing how to interact with various parts of the BOSS system.
- Development Installation Instructions Includes GitHub CLI and GH-AXI setup required before development work
- Server Installation Instructions Use this to install BOSS on a Raspberry Pi, multipass VM instance, or AWS arm64 server
- BOSS Project Structure describes the project structure of this repository
- App Structure explains the structure of a BOSS app
- BOSS API lists all BOSS APIs including OS, UI, and Notification APIs
UI tests run in a real browser with Playwright. They live in uitest/, along with a small helper layer for booting the OS and locating windows.
Every UI component is demonstrated in the Tutorial app's Example controller, so the component library can be exercised in a single pass. See uitest/README.md to get set up.