Back to versions

Monday, August 10, 2026

0.5.0-beta

cover

More than a year ago, I made the first public release of FreakUI.

At that time, it was a very early version of the framework I had been building while designing and improving my own applications. Since then, FreakUI has grown together with those products. I have rebuilt its foundations, reconsidered many of its components, and learned much more clearly what should belong to a UI framework and what should always remain inside the application.

Today, I am taking the next step and making FreakUI open source.

FreakUI is now open source:

FreakUI 0.5.0-beta is available on GitHub as a Swift source package under the MIT License. You can install the exact release directly with Swift Package Manager, inspect the complete implementation, and use it in your own applications.

Why open source?

FreakUI started as a practical solution for my own work. I wanted one consistent way to handle themes, typography, spacing, controls, data presentation, charts, feedback, layout, and navigation across iOS and macOS.

But a framework becomes much easier to trust when you can see how it works.

You should be able to open a component, understand its decisions, check how it behaves on each platform, and decide whether it belongs in your application. You should also be able to learn from it, modify it, and use only the parts that are valuable for your product.

Making FreakUI open source gives it a much more honest foundation. The package is no longer something you receive through a separate access or download flow. It is available directly from its public repository, with its source, documentation, license, and release history in one place.

I also believe that sharing the work is the right way for FreakUI to become useful outside my own applications. If another developer finds a component helpful, notices a problem, or has a better idea, the source is there to explore and discuss.

What's inside FreakUI 0.5.0-beta?

1. A Complete Swift Source Package

FreakUI is distributed through Swift Package Manager and has no external package dependencies.

Add the public repository in Xcode:

https://github.com/valzubkov/FreakUI.git

Select the exact 0.5.0-beta release, add the FreakUI library product to your target, and import the module where you need it.

2. Consistent Design Foundations

Coming from a design background, I still believe that consistency is one of the most important parts of a good interface.

FreakUI gives you semantic colors, separate text and number typography, tokenized padding, heights and radiuses, and one shared component-size scale. You can configure the application theme once and use the same visual language throughout your interface.

Sizing is also explicit. Components can hug their content, fill the space provided by a parent, or use a fixed dimension when the product genuinely requires it.

3. Components for Real Application Interfaces

The package includes actions, menus, inputs, selectors, toggles, counters, sliders, titles, tags, badges, categories, indicators, data rows, dashboard cells, tables, lists, alerts, callouts, empty states, toasts, containers, sections, and navigation helpers.

These components are intentionally domain-neutral. FreakUI provides the interface contract and presentation, while your application continues to own its models, data, permissions, business rules, and navigation state.

4. Data Presentation and Charts

FreakUI includes typed display values and locale-aware formatting for numbers, dates, times, and durations.

It also includes progress indicators, goal progress, proportion bars, pie and donut charts, and styling for client-owned Swift Charts. Your application owns the data and chart marks; FreakUI helps them follow the same visual system as the rest of the interface.

5. Native Apple Platform Behavior

FreakUI supports iOS 17 and macOS 14 or later with Swift 6.2.

Where Apple already provides the correct interaction, the framework keeps it native. Menus, alerts, confirmation dialogs, toolbar placement, navigation behavior, focus, and platform conventions remain owned by SwiftUI and the operating system.

FreakUI adds its visual language around those behaviors instead of replacing them with custom imitations.

6. Documentation Next to the Source

Every public component is documented inside the package and on this website.

The website provides the larger structure, examples, tokens, and component catalogue. Xcode Quick Help provides exact parameters and defaults at the place where you are writing code. Because the package is open source, you can always go one step further and inspect the implementation itself.

If you used the alpha

The beta is a breaking redesign, not a compatibility update for the version I released more than a year ago.

If you used 0.5.0-alpha, treat 0.5.0-beta as a new package integration. Remove the previous package or local download, add the public GitHub repository, pin the exact beta release, and rebuild your interface against the current documentation and compiler guidance.

The alpha represented an earlier stage of FreakUI. The current documentation and Xcode Quick Help describe the framework as it exists in this release.

Try FreakUI

You can explore the source, read the documentation, and install the exact release from the FreakUI repository.

If you are building an application for iOS or macOS and care about keeping its interface consistent, I encourage you to try FreakUI and see which parts are useful for your own work.

Good luck and happy coding!

View the 0.5.0-beta release