Design system

The system behind the site.

Apple-grade restraint with a terminal soul: a near-neutral base, one Swift-orange accent used sparingly, a humanist sans for prose and a refined mono for everything technical. Toggle the theme in the nav — every token below adapts.

Color

Dark is the default. Light is a warm off-white companion. The accent is constant across both; status hues shift to keep WCAG AA contrast.

Surfaces & text

--bgpage

--surfacecards

--surface-2elevated / hover

--surface-3chips / inputs

--texthigh-emphasis

--text-mutedbody

--text-dimcaptions

--border-stronghairlines

Accent — Swift orange

orange-300#ff8e75

orange-400hover

orange-500#f05138 · the accent

orange-600active

orange-700deep

Status

--okworks / success

--warnactive / warning

--errerror

--infonote / info

Typography

Two families. Hanken Grotesk for UI and prose; JetBrains Mono for code, terminal output, command names, and micro-labels. Large headings track tight (-0.02em); body breathes at 1.65 line-height.

display · 700Boot. Isolate. Serve.

h1 · 700A real OS in Swift

h2 · 700What works today

h3 · 600Capability security

lead · 400A small trusted core, capability-based isolation, deterministic boot.

body · 400Authority is a token you hold, not a uid you are — no ambient root power, and every privileged action crosses one audited boundary.

mono · 500root@swift-os:~$ id

micro-labelEmbedded Swift · aarch64

Spacing, radius & elevation

Spacing — 4px grid

1 · 4

2 · 8

4 · 16

6 · 32

10 · 64

Radius

xs · 5

sm · 8

md · 12

lg · 16

Elevation

Buttons

Status chips & badges

Works Primary Active hardening Planned Non-goal Blocked Served by swift-os

Code block

Filename chrome, syntax tokens, and a copy button that confirms on click. Code surfaces stay dark in both themes.

Terminal — zsh

$ git clone https://github.com/asaptf/swift-os
$ cd swift-os && make run
# boots in QEMU · AArch64
[ ok ] httpd listening on :80

Callouts

Noteswift-os targets AArch64 only. There is no x86-64 port, and that is by design.

TipFirst login is root / swordfish. Change it before exposing anything.

WarningWrites to /tmp are a tmpfs — they vanish on reboot. Persist deliberately.

Tabs

Apple Silicon is the primary profile — QEMU runs the AArch64 image natively.

Accordion

No. swift-os removes legacy rather than emulating it. There is no Linux ABI and no Unix-compatibility layer.

Embedded Swift gives memory safety and modern ergonomics without a garbage collector or heavy runtime — a good fit for kernel and bare-metal code.

Search field

⌘ K

Glossary tooltip

Hover or focus the dotted terms: the kernel runs at EL1, applications at EL0, and the MMU keeps every process isolated. This is how jargon is explained inline, site-wide.