Bithead OS aka BOSS

BOSS allows you to make web apps look like a native 2bit Mac OS applications.

• Launch apps from the Applications menu
• Uses familiar UI language
• Easily install apps on your server from Applications
  • If there's interest, I may add a Web App Store

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.

How can I test the OS?

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.

Documentation

• Development Installation Instructions
• 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

Testing

This comes with a Selenium Python testing library with an abstraction layer to easily interact with BOSS components. We use this library to test our own apps.

Please find Selenium tests in test. Refer to Installation for more direction.