Card studio — Vao Push

Three things to know

01

Data source

Where data comes from and which fields update. One source can serve multiple cards.

02

Card design

How fields are arranged and displayed. Drafts and published designs stay separate.

03

Subscription

Lets a device read a published card. Import codes belong to their server.

01 · Connect your data

Create a card in My Cards in the Web console. Use a new data source or choose an existing one.

Input method	How it works
Read JSON / API	Provide a public HTTPS JSON URL, authentication, and field mappings. Your server fetches it periodically.
Push data from a tool	A script sends JSON with PUT to the source-specific address, replacing the entire current state.

json

{
  "fields": {
    "progress": {
      "type": "percent",
      "label": "Progress",
      "value": "68"
    },
    "status": {
      "type": "text",
      "value": "In progress"
    }
  }
}

This fictional example tracks photo processing. Numeric values use decimal strings; bind the progress field to show completion.

02 · Design and preview a draft

Choose real fields, adjust labels, typography, and layout, and preview different sizes. Use visual controls for common changes, or advanced layout and structured JSON for more complex designs. Cards do not execute arbitrary web code.

03 · Publish and import

Save the draft and check fields, data, and size, then publish.
Generate an import code in Connection & Subscription. Connect the App to the same server and import from Cards → +.
Fine-tune its name, appearance, and supported field settings in the App, then add a system widget and select the card.

Daily data changes need no design republishing. Compatible design updates preserve device-specific tweaks. The App can also create simple templates for recent messages.

Updates and deletion

Successful data collection does not mean the Home Screen has refreshed. The system schedules widget updates, and offline devices may retain the last valid content.

Card deletion first shows its impact and preserves the data source and other cards. A source can be deleted only when no cards reference it, including unpublished drafts.