Skip to content
StartupBuilderby Startups.Studio
Code
Changelog
File conventionsRoot filesstartups.lock

Lockfile

The lockfile pins each Startup Template and Product Template a Startup extends to a Version by fingerprint, so upgrades arrive as reviewed Changes.

PropertyValue
Pathstartups.lock
HoldsVersion
Kindfile
Leadersdb-first, git-first
TeamEngineering Team
Written byTemplate.extend, Template.upgrade
Compiled byStartupBuilder

Example

startups.lock in a Startup repository.

startups.lock
{
  "lockfileVersion": 1,
  "pins": {
    "agent-run-services": { "version": 4, "digest": "sha256:7be2c09d" },
    "services-as-software": { "version": 11, "digest": "sha256:e1a6f3b8" }
  }
}

Props

The keys the file takes.

PropTypeRequiredDescription
lockfileVersionnumberrequiredThe format version: 1.
pinsjsonrequiredOne pin per Startup Template or Product Template the Startup extends, keyed by its id.
versionnumberInside a pin: the pinned Version.
digeststringInside a pin: sha256: over the Version’s parsed canonical form.

Generates

StartupBuilder compiles it into these records, Verbs and routes.

KindWhat
RecordsVersion
VerbsTemplate.extend, Template.upgrade
RoutesNone.