App Store

Apps are not bundled into the library. They live in a registry, and you copy the ones you want into your own project with the react-ui-os CLI. The files land in your codebase, so you own them and can edit them after install.

Each app is a React component tree plus a small App descriptor. Installing one copies its source files and lists @react-ui-os/core and @react-ui-os/desktop as dependencies; nothing else is pulled in.

Calculator

utilities

A macOS-style calculator with a real arithmetic engine: keyboard input, percent, and sign flip.

3 files View source

npx @react-ui-os/cli add calculator

Calendar

productivity

A month-view calendar with persisted events. Click a day to add, edit, or remove an event.

3 files View source

npx @react-ui-os/cli add calendar

Clock

utilities

World clock, stopwatch, and timer in one window, each its own tab.

5 files View source

npx @react-ui-os/cli add clock

Notes

productivity

A two-pane plain-text notes app with persistence. The first line of each note becomes its title.

2 files View source

npx @react-ui-os/cli add notes

Reminders

productivity

A checklist app with persistence. Add items, check them off, and clear the completed ones.

3 files View source

npx @react-ui-os/cli add reminders

Sketch

creative

A canvas drawing pad with a brush, eraser, color swatches, and adjustable stroke width.

5 files View source

npx @react-ui-os/cli add sketch

Terminal

developer

A small command shell with a working command set, history, and tab completion.

3 files View source

npx @react-ui-os/cli add terminal

After installing

add copies the files, then prints the dependencies to install and how to register the app. The last step is to import its App descriptor and pass it in the apps array.

import { Desktop } from "@react-ui-os/desktop";
import { macosTheme } from "@react-ui-os/theme-macos";
import { notesApp } from "./os-apps/notes";

export function App() {
  return <Desktop apps={[notesApp]} theme={macosTheme} />;
}

That single object lights up the dock, the menu bar, Spotlight, and the keyboard shortcuts. From there the code is yours: rename it, restyle it, or strip out the parts you do not need.

Other commands

npx @react-ui-os/cli list                  # show every app in the registry
npx @react-ui-os/cli add calculator clock  # add more than one at once
npx @react-ui-os/cli add notes --dir app/desktop-apps
npx @react-ui-os/cli add notes --force     # overwrite existing files

Build your own

Apps are not limited to this list, and they do not have to live in this repo. You can host your own registry and install from it:

npx @react-ui-os/cli add weather --registry https://you.example/registry.json

Publish an app walks through authoring an app, adding it to a registry, and hosting that registry yourself.