Build a Widget
Everything you need to know to get started.
What Essential Apps is for
Widgets are small, glanceable surfaces for your home screen. The best do one thing well — show a piece of information at a glance, or offer a quick, single-purpose function. Describe what you want in plain language and the agent builds it and deploys it to your device.
Think in 2×2 and 2×4
A widget is a small tile or short strip, not a full app. Keep the idea to what fits that space and the results are far better.
What works well: glanceable displays (weather, next meeting, a countdown), clocks and calendars, reminders and notes, system shortcuts, small games and toys, and quirky home-screen touches.
Getting the best results
The more specific your prompt, the closer the result lands.
- Be explicit. Spell out the behaviour, data, and layout. “FTSE 100 with the day’s change in red or green” beats “a stocks widget”.
- Reference design. Name the colours, fonts, shapes, or style you’re after.
- Upload an image. Use images to give the agent a strong visual starting point.
Expect to iterate
The builder is non-deterministic — the same prompt won’t always give the same result, and it may not nail it the first time. That’s normal. Most widgets currently take eight or nine goes before they’re ready to deploy, so keep refining: tell the agent what to change (“make it bigger”, “use the red accent”) and it builds a new version. There’s a usage cap in the beta, but plenty of room for many versions, so don’t be shy about experimenting.
What you can plug into
On device:
- Calendar (read and write)
- Contacts (read)
- Location
- Gallery
- Camera
- Microphone
- Audio playback
- Vibration
- Toast notifications
- Motion sensors
- Compass
Some of these need permission. A widget will ask the first time it wants your calendar, location, camera, or microphone.
From the web:
- Weather and forecasts
- Air quality
- Sunrise/sunset times
- Earthquake data
- OpenStreetMap directions
- London transport
- Swiss transport
- Bike-share dock availability worldwide
- Live aircraft positions
- ISS location
- FX rates
- Stocks
- Sports scoreboards, results and fixtures
- Cricket game data
- F1 schedules and results
- Newsfeeds from non-paywalled sources
- Public holidays in Europe
Other web searches may also work if the agent is able to fetch from a source online that doesn’t require authentication.
When things break
It’s a beta, so builds will sometimes fail or render oddly. If something looks off, check Known Issues to see if we’re already on it — and if not, tell us through the feedback form.