Getting Started

Getting Started

Install

In Xcode, choose File > Add Package Dependencies... and use:

https://github.com/ChiefVenzox/SwiftBlocks.git

Then import the package:

import SwiftUI
import SwiftBlocks

Open the Workspace

#Preview {
    SwiftBlocksWorkspaceView()
}

The workspace includes Blocks, Canvas, Inspector, Tokens, Templates, Craft, and Export tabs. It opens on Craft by default, so you can generate native SwiftUI component code from prompts, component types, and styles, then press Add to Canvas.

Open the live canvas directly

#Preview {
    EDKDesignCanvas()
}

The canvas includes a palette, an iPhone-sized design surface, and an inspector. Drag blocks from the palette, tap to select, drag to move, and use the resize handle to change dimensions.

Open Auto Craft

#Preview {
    SwiftBlocksCraftWindow()
}

Use the craft panel to choose a block type, color, and radius. Press Craft to create two suggestions, then drag either suggestion onto the canvas.

Craft is fully local and deterministic. It uses Swift presets and templates only, so there is no API key, no server, and no internet requirement.

Use the Xcode Library

After adding SwiftBlocks as a package dependency, open Xcode's Library with the + button and search for SwiftBlocks.

Available library items:

• SwiftBlocks Workspace
• SwiftBlocks Button
• SwiftBlocks Glass Card
• SwiftBlocks Canvas
• SwiftBlocks Auto Craft

Drag SwiftBlocks Workspace into code or the SwiftUI preview canvas for the full builder. Use the other items for focused component examples.

Use components directly

EDKButton("Continue", style: EDKComponentStyle(variant: .primary)) {
    print("Continue")
}

EDKSurface(style: EDKComponentStyle(variant: .glass, cornerRadius: 14)) {
    Text("Liquid Glass surface")
}