Architecture

Architecture

SwiftBlocks is split into three layers.

Theme

EDKTheme contains semantic colors, spacing, radius, and typography scales. The default palette follows Bootstrap-style intent names such as primary, success, warning, and danger.

Components

EDKButton and EDKSurface are the first production-facing blocks. They read from the SwiftUI environment and support semantic variants, size scales, and iOS 26 Liquid Glass where available.

Canvas

EDKDesignCanvas is the visual builder. It uses:

• EDKPaletteItem for draggable palette entries
• EDKDesignCanvasStore for observable editor state
• EDKDesignDocument for Codable layout persistence
• EDKDesignNode for individual blocks

The document model is intentionally separate from SwiftUI views so future code generation, import/export, and persistence can evolve without rewriting the UI.

Workspace

SwiftBlocksWorkspaceView is the tabbed builder surface for package users. It exposes the complete workspace flow:

• Blocks
• Canvas
• Inspector
• Tokens
• Templates
• Craft
• Export

Craft

Craft is local component generation for SwiftUI structures. It uses SwiftBlocksCraftRequest, SwiftBlocksCraftComponentType, SwiftBlocksCraftStyle, and SwiftBlocksCraftGenerator to produce deterministic SwiftBlocksCraftResult values.

The first generator implementation is template-driven. It produces previewable SwiftUI code for common components such as buttons, cards, form rows, hero sections, and settings cells. No API key, server, internet access, or external AI service is required.

Legacy compact craft surfaces still return EDKCraftedBlock, so generated blocks can be added to the same canvas document model safely.