DesignFoundation

A production-grade SwiftUI design system. Token-based theming, protocol-driven style swapping, first-class Liquid Glass support, and a full component library — one dependency, instantly consistent across every screen.

DesignFoundation mirrors SwiftUI's own ButtonStyle pattern across every component. Inject a DFTheme once at the app root; every component reads its colors, typography, spacing, and radius from the nearest theme in the environment. Override any subtree. Write custom styles by implementing one function. Zero hardcoded values anywhere.

Installation

Xcode

File → Add Package Dependencies, paste the URL below, and choose Up to Next Major from version 1.0.0.

https://github.com/NerdSnipe-Inc/design-foundation

Package.swift

// Package.swift
dependencies: [
    .package(url: "https://github.com/NerdSnipe-Inc/design-foundation", from: "1.0.0")
],
targets: [
    .target(name: "YourApp", dependencies: ["DesignFoundation"])
]

Quick Start

import DesignFoundation

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .dfTheme(DFTheme(colors: DFColorTokens(primary: .indigo)))
        }
    }
}

// In any view:
DFButton("Get Started") { /* action */ }

DFTextField("Email", text: $email)
    .dfTextFieldStyle(.outlined)

DFCard {
    DFText("Hello", style: .headline)
}

DFTheme

A single DFTheme struct propagates through SwiftUI's environment. Inject it once at the root and every component responds automatically. Override at any subtree depth.

ContentView()
    .dfTheme(DFTheme(
        colors: DFColorTokens(
            primary: .indigo,
            surface: Color(.systemBackground)
        ),
        spacing: DFSpacingTokens(md: 20),
        radius: DFRadiusTokens(md: 12)
    ))

Tokens

Every component reads exclusively from these token namespaces — no hardcoded values anywhere in the library.

Colors — theme.colors

Spacing — theme.spacing

Radius — theme.radius

Typography — theme.typography

Style System

Every component exposes a style protocol with a single makeBody(configuration:) method — the same pattern as SwiftUI's ButtonStyle. Styles propagate through the environment, compose with each other, and apply hierarchically.

// Apply a style to an entire section
VStack { ... }
    .dfButtonStyle(.outlined)
    .dfCardStyle(.glass)

// Override for a single component
DFButton("Delete", role: .destructive) { }
    .dfButtonStyle(.ghost)

// Liquid Glass across your whole UI (iOS/macOS 26+)
ContentView()
    .dfButtonStyle(.glass)
    .dfCardStyle(.glass)
    .dfTooltipStyle(.glass)

Writing a custom style means implementing one function. All protocols are open; built-in styles are concrete structs you can copy and fork.

struct MyButtonStyle: DFButtonStyle {
    func makeBody(configuration: DFButtonStyleConfiguration) -> some View {
        configuration.label
            .padding(.horizontal, configuration.theme.spacing.lg)
            .background(configuration.theme.colors.primary)
            .clipShape(Capsule())
            .opacity(configuration.isPressed ? 0.7 : 1)
    }
}

Primitives

Inputs

All input components share DFValidationState (.idle / .valid / .error(String)) for consistent error display.

Layout

Overlays

Navigation

Supplementary

¹ .glass styles require iOS 26+ / macOS 26+.

Add-on Packages

DesignFoundation is the free, open-source foundation. Two commercial packages build on top — blocks for common UI patterns, screens for complete vertical feature sets. All three share the same DFTheme, so a brand color change ripples through everything identically.

Installation

Add whichever packages you need alongside DesignFoundation:

// Package.swift
dependencies: [
    .package(url: "https://github.com/NerdSnipe-Inc/design-foundation", from: "1.0.0"),
    // optional commercial packages
    .package(url: "https://github.com/NerdSnipe-Inc/design-foundation-pro", from: "1.0.0"),
    .package(url: "https://github.com/NerdSnipe-Inc/design-foundation-screens", from: "1.0.0"),
]

Get access →

Platforms

.glass styles require iOS 26+ / macOS 26+. All other styles work on the minimum versions above.

License

MIT © 2026 NerdSnipe Inc. DesignFoundation is free and open-source. View LICENSE →