Libraries

A library is a Git repository that holds your connector files. Admins add it in the console under Settings › Libraries. Adding a library installs nothing: it lists the apps the repository holds, and any errors in their files.

Repository

• Hosts: github.com, or a Gitea server on port 443.
• Address: https://host/owner/repo.
• Access: public, or private with a read-only token.

Branch or tags

A library follows one of two things:

Follow	A new version is
A branch	every new commit
Tags	the newest release tag by version number. v1.10.0 is newer than v1.9.3. Tags without a number are ignored.

Layout

Without a manifest, Flowplane reads these files, one level deep:

connectors/
  crm.py          ← one connector per file, Python
  tickets.star    ← or Starlark
lib/
  signing.star    ← helpers your connectors load

With a flowplane.yaml at the root, it reads exactly the files the manifest lists:

connectors:
  - connectors/crm.py
lib:
  - lib/signing.star

Keep the manifest this simple: comments, the two keys and - path items, nothing else.

Updates

Flowplane checks each library for new versions regularly. Check now on the library’s page checks at once.

When a connector or a helper it loads changes, its installed app shows Update available. A commit that touches neither changes nothing. Updates never run by themselves: an admin approves each new version.

Limits

A library holds up to 200 files, of at most 256 KiB each and 4 MiB in total. A library over a limit is refused as a whole, with the reason. Symlinks, submodules and files that are not UTF-8 are not supported.

Removing a library

You cannot remove a library while an app is installed from it. Remove those apps first.