Creating Your First Widget in WidgetCraft: Templates, Community, Blank Canvas

The short answer

WidgetCraft gives you three ways to make a widget: start from one of more than 200 preset templates, import one from the community, or build from a blank canvas. Whichever you pick, the same editor applies — containers, text, images, shapes, charts, data bindings and effects, dragged into place and previewed live. Six sizes are available: Home Small, Home Medium, Home Large, Lock Circular, Lock Rectangular and Lock Inline. No account is required to create a widget, and the core editing and preview work offline.

Two things are worth knowing before you start. First, WidgetCraft is free but limited: one widget per size, and designs badged VIP are locked. Pro lifts both limits. Second, your first widget reaching the Home Screen takes an iOS detour that surprises everyone — you save the design in the app, then add the widget through the system widget gallery. If you just want it on the screen, WidgetCraft is on the App Store and the full product page is at agentsmesh.app/products/widgetcraft.

Why the first widget is the hard one

Nobody searches for this because creating a widget is difficult. It is difficult because of what sits around it.

Every design tool that can express everything is intimidating to someone who just wants a clock on their screen. The first session is where a tool shows whether it can be learned at all: do you open it and understand it, or do you open it and back out. WidgetCraft's own onboarding is a clue to how it thinks about this — it starts with a playable 2048 widget on the first run, because a widget you can tap is easier to understand than a widget you can only look at.

The second wall is the one people actually hit. On iOS, a widget design is not a wallpaper you drag onto the screen. It is a design document stored by the app, and iOS only surfaces it when you add the widget through the Home Screen edit mode. So the sequence is always: design in the app, save, then long-press the Home Screen, tap the top-left +, search for WidgetCraft, and pick a size. Skip the second half and you conclude your widget vanished. It did not — it is saved, just not added yet.

Picking a starting point

A template is the fastest route and the one most first widgets should take. The preset library runs past 200 designs, organised by scenario — weather, calendar, photos, countdowns, health, productivity, decorative — and each one can be used as-is or opened in the editor. The shipped presets span more than a hundred widgets: clocks, weather, calendar and agenda styles, countdowns, photo galleries, step and fitness trackers, battery and system info, and forty Lock Screen designs. Templates are editable at every level, so a template you pick can become anything.

A community import is the right choice when something close to what you want already exists. Widgets are shared as QR codes or .widgetdoc files, and WidgetCraft scans or imports them straight into My Widgets, where they become ordinary widgets you can edit. Importing is also how you get someone else's paid design without redrawing it.

A blank canvas gives you the most control and the most work. From an empty design, the layer system is a real design tool: container layers (stacks and a grid), content layers (text, arc text, image, GIF, date, chart, click action, spacer) and shape layers. Each layer takes its own background — static, system-adaptive, gradient or image — plus opacity, corner radius and border style, and its effects tab covers blur, scale, shadow, rotation and 3D rotation, brightness, contrast, saturation, grayscale, hue rotation, invert, multiply, blend mode and per-layer animation. Text layers take font, size, weight, colour (static, adaptive or gradient), alignment, line count, underline and strikethrough. Theme mode is per widget: follow the system, force light, or force dark.

AI-assisted generation is a fourth option rather than a third starting point. Describe or generate a design and edit the result. It is the one part of the app that needs a network connection; everything else — templates, editor, community, preview — works offline.

What the editor actually changes

The part that trips people up is the data layer, not the styling. A text or number layer does not have to hold literal text: it can be bound to a source, and once bound it updates itself. The sources are system time, a data provider, an HTTP API of your own, a conditional provider that picks between values, a script, or literal text. The providers:

• Weather, fetched over the network and cached for an hour
• Apple Health, read-only: activity rings, steps, distance, active energy and sleep. Every widget that reads it is labelled "Data from Apple Health" before iOS asks for permission
• Calendar events, countdowns, device information, now-playing music, a library query, and your own HTTP API

Permissions follow from the data: Health, calendar, photo library, camera, Bluetooth and location each prompt once, the first time a widget that needs them is added. Nothing is written back to Health. A weather widget still needs a network connection, because its data comes from a weather service rather than from the device. Tappable layers are part of the same model: a click action can open another app, play a sound, or open a URL.

What is free, and where the limits actually are

The free tier keeps one widget per size — one Home Small, one Home Medium, and so on — and templates, the editor, previews, community import and data bindings all work within it. Designs badged VIP are locked, and Pro lifts both the slot limit and the VIP designs. Pricing at release: $4.99 monthly, $19.99 yearly, or $49.99 once for lifetime access, adjusted by local pricing in other territories.

This is the honest limit for a first widget, and it is a strange one: you can design as many widgets as you like in the editor, but the free tier will only keep one of each size on your screens. Plan your first widget as the one you will actually keep.

From template to Home Screen

The whole first-widget sequence, end to end:

1. Pick a template, scan a community QR code, or start a blank widget in the size you want.
2. In the editor, change the background, the text and the data sources. The preview updates as you go.
3. Tap Save to My Widgets. The design is stored; it is not on any screen yet.
4. Long-press the Home Screen, tap + at the top-left, search for WidgetCraft, choose small, medium or large, and pick your design.
5. Back on the Home Screen, if the widget shows the version from before your last edit, that is iOS's widget cache, not a bug. Wait a few seconds and refresh, or remove and re-add it.

Two details people miss: the free slot per size means you cannot keep a small and a medium version of the same design at once without Pro, and a saved widget can be deleted from the editor only after it has been removed from My Widgets.

What WidgetCraft does differently

WidgetCraft is not a gallery of pictures you can set as a wallpaper — it is a widget runtime with a design editor attached. Three things follow from that, and none of them are true of the obvious alternatives:

• Playable widgets. More than twenty of the shipped presets are games — 2048, Sudoku, Chess, Match, Reversi among them — that respond to taps on the widget itself. Apple's own widget gallery has no equivalent, and neither does a Shortcut.
• A real layer system. Per-layer opacity, blend modes, 3D rotation and animation, with the widget's data sources bound to layers rather than fixed inside a template. Shortcuts can put live data on the Home Screen but cannot draw a custom layout around it.
• Live data that refreshes on iOS's schedule. Widgets bound to time, weather or Health update themselves; the default refresh budget is 15 minutes, and bound data sources cache on their own terms — weather for an hour, now-playing for a minute.

Where it is more limited, honestly:

• It requires iOS 18.0 or later, on iPhone or iPad.
• Widgets run entirely locally except for network-backed data; the widget itself never needs a connection, but weather, your own HTTP API and AI generation do.
• Apple Health access is read-only, so a health widget shows what the system already knows.
• Custom widgets are your own design, so iOS's glanceable-widget rules do not apply. A design that reads well in the preview can be hard to read on a busy wallpaper. The preview is the best check available, not a guarantee.

The decision you can now make

If you want one good-looking widget on your screen today, take a template, change one colour and one data source, and save it — that is the shortest path from opening the app to a widget you actually use. If you want widgets that show something live rather than something static, check which data sources you will use and what permission each asks for before you design, because that is the part you cannot change afterwards. And if you only want live data with no design at all, a Shortcut is still the lighter choice.

If you want all of it — every preset, unlimited widgets in every size, and the community's — the Pro tier is where WidgetCraft stops being a one-widget experiment. Download WidgetCraft on the App Store, or read how the template library and the editor fit together before you start.