Limits

All the numbers that limit a module, in one place. Each group links to the guide that tells why the limit is there and what happens past it. The guides link here, and do not repeat the numbers.

Loading

Modules, loading, and errors

• Reload after an edit: about 300 ms after you save a module that is on.
• A file that goes: Pi Pocket removes a module only when its file is still gone 300 ms later.
• Time to load: 30 s at most for one load: the import, and an async default export.
• Time to load at the server’s start: all the modules share 30 s. After that, each module that is left has 2 s.

Names

Names

• A module that adds to the app: a name of 64 characters at most. Modules, loading, and errors
• An id of a rail button, menu row, launcher action, page, or sheet: 64 characters at most. Browser modules
• A command’s name: 64 characters at most. Slash commands
• An event’s name: 1 to 64 characters. Events
• A gallery entry’s name: 2 to 64 characters. Publishing to the gallery

Host

Using the host

• host.text.quoted: cuts the line to 120 characters when you give no max.

Linked sessions

Starting and messaging sessions

• Sessions that one session starts: 10 at most. A linked session cannot start sessions.
• Messages between the sessions of a team: 20 at most since a person last wrote in one of them. Then a person must write.
• A message: 20,000 characters at most.
• A title: one line of 120 characters at most.
• A call’s key: Pi Pocket keeps the record of a key for 30 days, and the records of the last 1,000 calls of each session.

Browser modules

Browser modules

• A file that a browser module serves: 8 MB at most.
• Files that count for a new version: the first 2000 served files, in 500 folders at most. An edit past these does not load the module again.
• Folders that Pi Pocket watches for edits: the first 64. It sees an edit deeper at its next look.
• Calls to pocket in one task: past 1000, over more than 1 s, the module stops in that browser.
• Pages and sheets that a module opens or closes: past 300 in 1 s, the module stops. With no task between them, it stops past 1000, or at 5 or more over more than 1 s.
• Redraws in a hidden tab: by a timer of 100 ms, which the browser can make slower.
• Notices from pocket.notify: 5 every 5 s for a module, for all its versions together. The app drops the rest.
• Rail buttons of modules: together, the height of 4 buttons. Past that, they scroll.
• A count on a rail button: a count past 99, and Infinity, shows “99+”.
• Text on a rail button: past 24 characters, it is cut to 23 characters and “…”.
• Swipe back on a page: on touch screens up to 699 px wide.

Tool calls

How tool calls show

• A call’s label: one line, cut to 80 characters.
• A call’s subject: one line, cut to 160 characters.
• The words of a summary: verb, noun, and by are 60 characters at most each. A longer one gives the default display.

Events

Events

• The data of one event: 256 KB of JSON at most.
• Events that a version of a module sends: 100 each second at most, and 1 MB of them. The rest of that second’s events are dropped.
• A tab that falls behind: Pi Pocket cuts it off when it is more than 8 MB behind and takes nothing for 30 s. It also cuts off a tab that is more than 128 MB behind. The tab then connects again, with no old events.

Commands

Slash commands

• Commands of one module: 50 at most.
• A command’s description and args: 200 characters at most each.
• The arguments that a person types: 4000 characters at most.
• A toast’s message: cut to 500 characters.
• A card: Pi Pocket keeps the last 30,000 characters.
• Runs of one person: 4 at the same time, in all sessions together. Pi Pocket refuses a fifth run until one ends.
• Kept requests: Pi Pocket keeps the request ids of the last 100 finished runs of each person in each session. The same text sent again from the same tab finds the first run only while its id is kept.

Cleanups

Cleanups

• A cleanup when the server stops: Pi Pocket waits 3 s at most for the cleanups that return a promise.

Gallery

Publishing to the gallery, Gallery entry

• The index: 4 MB at most, with 2000 entries at most.
• The index’s name: 80 characters at most. Its repo: 160 characters at most.
• An extension’s files: 50 at most, of 512 KB each at most, and 2 MB together at most.
• A theme’s files: 200 at most, and 16 MB together at most. theme.json, colors.toml, and colors-light.toml: 8 KB each at most. Its CSS: 256 KB together at most. A font or an image: 4 MB at most.
• A theme’s name: 2 to 48 characters.
• A file’s name: 200 characters at most, and four folders deep at most, with <name>/ as the first folder. Each part of it is 100 characters at most.
• title: 60 characters at most. description: 600 characters at most.
• tags: 10 at most, of 24 characters each at most.
• author.name: 60 characters at most. author.github: 39 characters at most.
• version: 32 characters at most.
• minPocket: three numbers of 4 digits at most each, such as 0.14.0.
• source.repo: an owner of 39 characters at most, and a repository name of 100 characters at most. source.path: 200 characters at most, and four folders deep at most.
• Each list in declares: 100 names at most. An extension, tool, hook, or section name is 64 characters at most. A route’s path is 200 characters at most. A command, with its scope, is 80 characters at most.
• revoked: 50 commits at most, each with a reason of 300 characters at most.
• Looks for revoked versions: two times a day, while extensions from the index are installed.

Themes

Themes

• A theme’s id (its folder’s name): 2 to 48 characters.
• theme.json: 8 KB. Its name and author: 60 characters each; its description: 200; its version and minPocket: 32.
• colors.toml and colors-light.toml: 8 KB each.
• All of a theme’s CSS: 256 KB together.
• A font or an image: 4 MB.
• Everything a theme serves: 16 MB, and 200 files.
• Folders: 4 deep under the theme’s own; Pi Pocket looks at 2,000 files and folders in it at most.