All work

FocusOS

A time container for the day you planned and the hour you are in.

macOS says “damaged”? Install notes

Design & build · xyc design 2026 macOS · Windows Electron · React · TypeScript v1.0.0

FocusOS focus view: 24:18 over a photograph, the current task and the cycle dots
Overview

Planning and doing, in one window.

Every pomodoro app I tried solved half the problem. Timers knew nothing about my calendar; task managers knew nothing about the hour I was in.

FocusOS puts both in one window. A 220-pixel sidebar holds the plan; the rest of the screen holds the one thing I am doing.

It is also a constraint exercise: one person, two platforms, zero UI, chart or native dependencies.

“Design the timer as a place, not a widget.” Working note, 2025
Screens

Six ways of seeing a day.

Every screen below is a capture of the running app. Same window, six jobs: run the timer, plan the day, read the week, empty the inbox, look back, tune the machine.

FocusOS focus view with a countdown ring over a photo background

01Focus view

One number, one ring, one task. Put a photograph behind it and the controls fade when the mouse rests; the countdown stays the only bright thing.

FocusOS day timeline with plan blocks between 08:00 and 17:00

02Day timeline

A 24-hour canvas. Tasks expand into 25-minute plan blocks, the current hour is marked, and the whole day can be dragged into a different shape.

FocusOS week view: seven columns on the same hour scale

03Week view

Seven columns on one hour scale, today tinted. Tomorrow's work is visible without opening a second app, and the footer counts the pomodoros already banked.

FocusOS inbox with seven unscheduled tasks and the quick-add bar

04Tasks & inbox

Type “3pm tomorrow meeting 1 hour #work” and it becomes a dated, timed, tagged task. Everything unplanned waits in the inbox until it has an hour.

FocusOS insights: habit check-ins, metric cards and a 14-day bar chart

05Insights

Habit check-ins, pomodoros, focus hours and completion rate, then a 14-day chart, an hour heatmap and a category share — all drawn by hand, no chart library.

FocusOS settings: theme, language, appearance and background controls

06Settings

Six panes — theme, timer, schedule, notifications, data, about. Background mode lives here too: scrim, blur, vignette and whether the text should flip colour with the photo.

Architecture

The main process owns time.

Remaining time is always endsAt − now(). The renderer never counts — it only draws.

Main processNode
Timer engineendsAt · catch-up replay
Schedulerplans · conflicts
Storeatomic JSON
IPC
Preloadbridge
window.apityped · promise-based
Eventstick · theme · tray
Isolationno Node in renderer
window.api
RendererReact
Viewsfocus · day · week
Storesdata · UI · theme
DrawSVG charts · icons

AuthorityTimer state lives only in the main process. A UI reload cannot disturb a running phase.

DurabilityTemp file, then rename. 500 ms throttle, schema migrations, automatic backup on corruption.

PortabilityPlatform chrome is measured once and injected as CSS variables. Components never branch on OS.

Craft

A small system, held to a strict standard.

No component library — so every token, every size and every contrast ratio had to be written down.

Colour · dark themetokens.css

#1c1c1e
#2c2c2e
#3a3a3c
#53a9ff
#30d158
#ff9f0a
#ff8079
#f2f3f7

Type scaletokens.css

Focus, 25:0020 / h1
Today’s timeline17 / h2
A scheduled task card13 / body
Metadata and tags12 / sm
Install

Getting it open on macOS.

If macOS says it is damaged

The build is not notarised, so Gatekeeper blocks it. Drag FocusOS into Applications, then run these two lines in Terminal — once is enough.

Only removes the quarantine flag from the app on this machine.
$ xattr -dr com.apple.quarantine /Applications/FocusOS.app
$ open /Applications/FocusOS.app
Nº 03 · In progress

The best is yet to come.