tinylib.json

The file's JSON schema. init writes it, and dev keeps it on the version of tinylib-sdk your app installs.

Required. Your app's address, such as chess in tinylib.app/chess: lowercase letters and digits, with single hyphens between them. Your app's first version claims it. At most 40 characters.

Required. The name Tinylib shows under your app's icon and on its notifications. 1 to 20 characters.

Required. One sentence about your app, shown on its card and its page. 1 to 120 characters.

Required. The path of your app's icon in its folder: a square PNG, at least 512 pixels on a side. init adds a placeholder. At most 256 KB.

Locks the app's orientation. On the web, it works only with fullscreen.

Hides the phone's status and navigation bars. On the web, the app goes full screen from a tap, and again at the user's next tap if they leave, except in Safari on iPhone, which keeps its bars.

Keys of the user's data that only your rules can write, with ctx.data, such as a rating. An entry ending in / covers every key under it. A new version can't declare a key your client has already written, and declaring any needs a rules.js. At most 100 entries, each 1 to 128 bytes.

The features your app uses: "reminders" for tinylib.reminders, "friends" for tinylib.friends or data saved with audience: 'friends', and "notifications" for ctx.notify. Without its entry, a call to tinylib.reminders.set or tinylib.friends rejects with refused, and ctx.notify sends nothing and shows an error on the developer page.