Orbiter SwiftUI Skill

Orbiter SwiftUI Skill is a reusable Codex skill for building polished native SwiftUI productivity apps in a quiet, Linear-like style.

It packages the UI direction extracted from the Fact macOS app: compact navigation, restrained light/dark tokens, hairline panels, SF Symbol controls, dense workflow surfaces, app-level headers, and inspector-friendly management screens.

What It Helps With

• Build native macOS or iPadOS management apps with a Linear-like visual language.
• Refactor existing SwiftUI screens into a calmer, denser, more operational layout.
• Reuse Orbiter design tokens, button styles, badges, panels, sidebars, empty states, and segmented controls.
• Avoid over-nested layouts such as global sidebar + app sidebar + local filter sidebar + editor + inspector.
• Move local modes, locale filters, device filters, and workflow tabs into top app headers or compact content toolbars.

Contents

orbiter-swiftui-ui/
├── SKILL.md
├── agents/openai.yaml
├── assets/
│   ├── OrbiterDesignSystem.swift
│   └── OrbiterShellTemplate.swift
└── references/
    ├── design-language.md
    └── swiftui-implementation.md

Install

Clone the repository, then copy or symlink the skill folder into your Codex skills directory:

git clone https://github.com/voderment/Orbiter-swiftui-skill.git
ln -s "$PWD/Orbiter-swiftui-skill/orbiter-swiftui-ui" "$HOME/.codex/skills/orbiter-swiftui-ui"

If the symlink already exists, remove it first or copy the folder manually.

Usage

In Codex, invoke:

Use $orbiter-swiftui-ui to build a polished Linear-like SwiftUI app surface.

Example requests:

Use $orbiter-swiftui-ui to refactor this macOS settings screen into a compact app-style workspace.

Use $orbiter-swiftui-ui to build a native SwiftUI dashboard with a global sidebar, app header, editor area, and right inspector.

Use $orbiter-swiftui-ui to port the Orbiter design tokens and controls into this project.

Templates

assets/OrbiterDesignSystem.swift contains the reusable SwiftUI tokens and components.

assets/OrbiterShellTemplate.swift contains a starting shell for apps that need:

• one global sidebar
• a main content workspace
• an optional right inspector
• top app headers for local filters, tabs, and workflow actions

Design Principles

• Keep the app quiet, compact, and workflow-first.
• Prefer one global sidebar.
• Put app/workspace context in the top header.
• Use right inspectors for validation, review, and contextual help.
• Use SF Symbols, compact badges, hairline borders, and stable control sizing.
• Avoid decorative gradients, oversized hero layouts, nested cards, and unnecessary sidebars.

License

MIT. You can use this skill and the bundled SwiftUI templates in personal, open source, and commercial products.

See LICENSE.