User guide

Dashboards

Tabs of widgets: routines as widgets, ready-made ones, charts and sharing.

Dashboards#

Painéis (Dashboards) shows widgets in tabs: one tab per dashboard, as many as you like (home, work, the shop). The first one, Home, starts with the ready-made widgets. + makes a new tab with a name and an emoji.

• Editing. Edit lets you drag a widget by its handle, resize it from its corner, remove it, rename the tab or delete it. Add widget lists everything you can put on it, drawn as it will look. On the phone, and in a narrow window, the widgets stack.
• Kinds. A widget is one of seven kinds:
  • a number, with its trend and a sparkline of its history;
  • progress towards a goal;
  • a status (OK, attention or alert);
  • a list;
  • a table;
  • a chart (line, area, bar or donut);
  • a few lines of text.
• Ready-made widgets. They need no routine: what needs you, today's runs, your reminders, spent this month, and today's limit.
• Routines as widgets.
  • Ask for one in the chat: "show me the dollar every hour", "keep a widget with today's orders". The routine then updates its widget each time it runs.
  • A routine you already have becomes one with Turn into a widget on its page. Pick a kind, or let Pimpo pick. Pimpo redoes the routine so it also shows its result, keeping everything else it does, and you approve the new version as with any change. A routine that already shows a widget offers See on dashboards instead.
  • Any routine can also go on a dashboard as its health: its last run, success rate and next run.
• Refreshing. Widgets update live as routines run, and say when they are out of date. Refresh now in a widget's menu runs its routine once. When the routine uses a model and its last run cost a cent or more, it asks first.
• Floating on the desktop. In the desktop app, Float on the desktop in a widget's menu puts it in a small window of its own, above your other windows and on every desktop. Drag it by the card and resize it from its edges; it keeps its place and size, and comes back when the app starts. Its × closes it, and the arrow opens the dashboards. Floating widgets update live, and they close while the app is locked (see Locking the desktop app) and come back with the unlock.
• On the Android home screen. In the Pimpo app on an Android phone, Add to the home screen in a widget's menu places it on the home screen. It refreshes about every half hour and whenever you open the app, and a tap opens Pimpo. Away from home, or with Pimpo off, it keeps the last values and says how old they are. You can also add a Pimpo widget from the launcher's widget list and choose one of the widgets already on that phone. The phone reads them with a key of its own, made on the phone, that reads only those widgets and nothing else; it stops working when the phone is removed. iPhone widgets wait for a later version.
• Sharing.
  • Share with the house, in edit mode, shows a dashboard to everyone in the house.
  • They see only the widgets you marked Share with the house in the widget's menu, and their own ready-made widgets. Everything else shows as not shared with them.
  • Nobody else can change your dashboard.

This page is built from the repository's documentation. Improve it on GitHub.