togo-framework/os-example

A live demo of the togo os desktop shell.

os-example — the togo OS desktop, end to end

A generated togo app that boots straight into a macOS-style desktop: a wallpapered lock/login screen, a desktop with draggable icons, a dock, Launchpad, Spotlight, a notification center, and draggable / resizable / snappable windows — all responsive down to a phone (windows go full-screen, iOS-style).

It ships three self-contained OS apps (each a togo plugin under plugins/ packaged with UI + backend + MCP + Claude agent):

App	What it shows
Settings	macOS System Settings clone — live theme (8 themes), wallpaper, lock screen; changes persist via /api/os/session
Notes	a simple CRUD app in a window
Weather	proxies open-meteo, with a graceful fallback

Run

togo generate && togo migrate && togo serve
# API → :8091 (or :8080)   ·   Web → :3091 (or :3000)

Log in with Continue as developer (the auth-dev plugin) to land on the desktop.

How it's built

• Desktop shell — an app-local DesktopShell (web/src/components/os: wallpaper, top bar, draggable icons, dock, windows) built on the Nasaq UI kit (@fadymondy/nasaq).
• Backend — the os plugin (session + app registry) plus auth, settings, plugin-host, notification-center.
• Apps — added with togo make:os-app <name>; each calls os.RegisterApp(...).

This repo is part of the flat togo-framework workspace checkout: its go.mod uses a replace for the sibling os module during local development. To start your own OS app from scratch, run togo new <app> --frontend os.

---

Premium sponsors

ID8 Media  ·  One Studio

_{Support togo — become a sponsor.}