Tinylib
DiscoverDocsSign in
Sign in
Tinylib
AboutDiscoverDocsMake an appPricingTermsPrivacyDeveloper TermsContact

Start

  • Quickstart
  • How Tinylib works

Guides

  • Data
  • Rooms and rules
  • Games
  • Friends
  • Places and links
  • Reminders and notifications
  • Publishing
  • Errors and offline
  • Platforms
    • Notifications and reminders
    • Opening your app offline
    • The screen
    • Sharing and links

Client API

  • tinylib
  • tinylib.data
  • tinylib.rooms
  • tinylib.invitations
  • tinylib.friends
  • tinylib.places
  • tinylib.reminders
  • Types
  • tinylib-sdk/kits

Rules API

  • Kinds
  • ctx

Reference

  • tinylib.json
  • Command line
  • Limits

Plain text

  • llms.txt
  • llms-full.txt

Platforms

Your app runs the same code everywhere Tinylib runs. What differs is what the device lets Tinylib do around it: notifications, reminders, opening offline, the screen, and sharing.

WhereWhat it is
Web
What it is
Tinylib in Chrome, Edge, or Firefox on a computer or an Android phone, including installed from Chrome
Safari
What it is
Tinylib in Safari on a Mac, or in any browser on an iPhone or iPad
Home Screen
What it is
Tinylib added to an iPhone's or iPad's Home Screen
Android app
What it is
Tinylib from Google Play
dev
What it is
A pane in npx tinylib-sdk dev, which behaves like the web

There's no iPhone app. On an iPhone, Tinylib runs in the browser or from the Home Screen.

Notifications and reminders

The user allows notifications once for Tinylib on each device, when an app first needs them (Notification permission).

WhereA room's notificationsReminders
Web
A room's notifications
Arrive, even while Tinylib is closed
Reminders
Go off at their time, even while Tinylib is closed. One set offline goes off only while Tinylib is open in a tab.
Safari on a Mac
A room's notifications
As on the web
Reminders
As on the web
Safari on an iPhone or iPad
A room's notifications
Never arrive
Reminders
Never go off
Home Screen
A room's notifications
Arrive, even while Tinylib is closed
Reminders
Go off at their time, even while Tinylib is closed. One set offline goes off only while Tinylib is open.
Android app
A room's notifications
Arrive, even while Tinylib is closed
Reminders
Go off at their time, even when set offline and while Tinylib is closed
dev
A room's notifications
Show in the user's Notifications list
Reminders
Show in the user's Notifications list, on dev's clock. One set in an offline pane still goes off at its time.

Opening your app offline

WhereOpens your app without a connection
Web and Android app
Opens your app without a connection
Once it has opened there online
Safari and Home Screen
Opens your app without a connection
Once it has opened there online, while Safari keeps its files, which it may delete
dev
Opens your app without a connection
Once that pane has opened it online. Each pane's Online switch tries it.

The screen

orientation and fullscreen in tinylib.json apply differently:

WhereFull screenOrientation
Web
Full screen
From the tap that opens your app, or else the user's first tap in it, and again at their next tap if they leave
Orientation
Held in full screen on an Android phone, never on a computer
Safari on a Mac or iPad
Full screen
As on the web
Orientation
Not held
Safari on an iPhone
Full screen
Safari keeps its bars
Orientation
Not held
Android app
Full screen
From the moment your app opens
Orientation
Held
dev
Full screen
Not shown
Orientation
A landscape app gets a wide pane

Sharing and links

Wheretinylib.places.shareA link to another site
Web and Safari
tinylib.places.share
The device's share sheet where the browser has one, or Tinylib's own
A link to another site
Opens in a new tab
Android app
tinylib.places.share
Android's share sheet
A link to another site
Opens in the phone's browser
dev
tinylib.places.share
Tinylib's own sheet
A link to another site
Opens in a new tab
PreviousErrors and offlineNexttinylib

On this page

  • Notifications and reminders
  • Opening your app offline
  • The screen
  • Sharing and links