Lolly
Buksan ang App
  1. I-automate
  2. Gumawa ng mga tool at design system

Publish and localize a tool

Once a tool works on your machine, you can try it on any Lolly from a zip, test its hooks without a browser, send it as a file, publish it to a catalog and translate its labels. Pick the route by who should receive the tool and what they may change.

A tool with your rules

Share with rules turns a Lolly Design document into a portable .lolly tool. Recipients change only the inputs you approved. The tool is compiled for you. Its fonts and images travel inside the file.

An editable starting point

In a Lolly Design document, choose Save, then Save as a template. The template joins that tool's New from template chooser on your device, with no tool.json, catalog build or Git. A template holds starting values for a tool people already have. Recipients can edit the whole design. Share the template as a .lolly file, or ship it with the tool as Templates people save describes.

Your own tool, as a file

Zip your tool folder, or download a .lolly that includes the tool. The recipient's device runs your hooks.js after they accept the Trust this tool? prompt.

A shared catalog

Add the folder to a catalog that many people sync, such as this repository's community/. An organisation can run the catalog as a Git repository with review and an audit trail. This is optional.

Try it without the monorepo

To run a tool you wrote without the full clone, zip the tool folder and drop the zip on lolly.tools or any Lolly instance. Choose Install this tool in the drop sheet. The tool installs on that device and opens. You can zip the folder or its contents: a single top-level folder is stripped. Nothing is uploaded. The zip is read in the page, and the files go to the same device-local store a .lolly's carried tool uses.

Warning: Read a stranger's tool before you trust it

Your hooks.js is executable code, so the install asks the same Trust this tool? question a .lolly asks.

Drop an edited zip again and Lolly offers to replace your copy. Use this loop while you iterate. An installed tool never replaces a catalogue tool, so an id the catalogue already lists is refused. Give your tool its own id.

Test hooks without a browser

Install the tool-author SDK from npm:

npm i -D @lolly-tools/core

It exports createMockHost, an in-memory host bridge a plain node test can drive; validateTool, the same manifest check the catalog CI runs; and the HostV1 types for your editor. It depends only on ajv, so nothing else from the platform comes along. It depends only on ajv. The package's README on npm walks a four-file tool through a test.

Sharing a tool without a catalog (.lolly)

Open the tool, choose Share → Download .lolly and tick Include the tool. The file then carries tool.json, template.html, styles.css, hooks.js, icon.svg, the sibling text templates its formats need and the translation file for the active language, beside the design, so it opens on a device that has never seen the tool. The box arrives ticked for any tool the deployment's signed catalog does not list. That covers anything you just wrote and every tool on a build that signs nothing.

A tool made with Share with rules packages its checked fonts and images automatically. For a hand-written tool, review the share dialog's file list and dependency warnings before you send the file.

The recipient's consent is what stands between your hooks.js and their device. On import Lolly asks Trust this tool? The prompt shows the tool, shows you as its author when the file has your details and says that opening the file runs the tool's own code on their device. Trust & install accepts. For a file that carries a saved design, declining leaves that design in Projects until they have the tool. A standalone rules tool is installed only after consent. Two things to write for:

Sharing your work describes the same file from the recipient's side. The Threat Model lists this trust boundary.

Publish to a catalog

A catalog is the shared library people's Lolly syncs from. To add a hand-written tool to one:

  • Place the folder. A brand-neutral tool goes under community/<tool-id>/. A tool for one brand goes in that brand pack's tools/ directory.
  • Rebuild the index. Run pnpm run build:catalog:all. It regenerates each profile's catalog/tools/index.json from the manifests and refreshes asset checksums. The index is generated, so never edit it by hand.
  • Validate. Run pnpm run validate:catalog:all to confirm every profile's catalog is consistent.
  • Build and deploy the catalog. The app picks up the catalog on its next start.

While you work, pnpm run dev:web serves the app locally with your tool in the gallery.

To contribute a tool to Lolly itself, open a pull request against lolly-tools/lolly with your tool directory under community/<tool-id>/. Run pnpm run ci:local before you push. It runs the pull-request CI checks on your machine. --changed runs only the checks your change touches.

For an organisation using Lolly Work

The manifest and template stay the portable source. Optional Lolly Work adds organisation permissions and input policies around the tools an instance offers, plus a shared asset catalog with uploads, federation and review workflows. Installing a portable tool on your own device does not publish it to every member or grant access to organisation content. On an instance that allows it, a saved template's menu also offers Submit to the workspace catalog.

Coordinate pack publication with the instance operator. Configuration and the Lolly Work pages Catalog and content and Policy and governance describe the controls.

Localizing a tool

A tool's words live in the manifest, in English by default. To translate them, add an i18n/<lang>.json file: a sparse, flat overlay of only the strings a translator touched, keyed by dotted paths.

// community/your-tool-id/i18n/de.json
{
  "name": "…",
  "description": "…",
  "inputs.headline.label": "…",
  "inputs.headline.help": "…",
  "inputs.size.options.a4": "…"
}

With ?lang=de, the sidebar's labels, help text and select options come from the file. The tool's code is unchanged.

The QR tool's sidebar in German - every label, hint and dropdown option translated by the i18n sidecar signed by Lollyvector SVG44 paths~2.8k nodes55 groups44 KBCheck it yourselfKunin ang signed na fileThe QR tool's sidebar in German - every label, hint and dropdown option translated by the i18n sidecar signed by Lollyvector SVG44 paths~2.8k nodes55 groups44 KBCheck it yourselfKunin ang signed na file

A language can come from the reserved lang URL or CLI parameter or the person's profile language. The engine then fetches the matching i18n/<lang>.json, if there is one, and merges the file onto the manifest before any shell or the input model reads the manifest. One overlay point serves every shell: web, CLI and TUI. A missing file, key or valid JSON falls back to the manifest's English, so a translation gap never stops a tool loading. validate:catalog checks the keys, catching typos at build time.

Which strings a translation file can hold

name, description, a11yLabel and featured.blurb. For each input: label, help, notice, placeholder, section, suffix, options.<value>, addMenu.label, tableEditor.title and tableEditor.fields.<key>.label, with block and vector fields as inputs.<id>.fields.<fieldId>.…. And the walkthrough: guide.title, plus guide.tracks.<id>.label, .note and .steps.<index>.

Example tools

Every tool below is in community/, so you can open it in Lolly and read it in the repository.