Skip to content

Settings file

The Settings file holds the Settings a Startup or Studio sets for itself; every other Setting inherits from its nearest holder.

PropertyValue
Pathsettings.mdx
HoldsSetting
Kindfile
Leadersdb-first, git-first
TeamOperations Team
Written byChange.merge
Compiled byStartupBuilder

Example

settings.mdx in a Startup repository.

settings.mdx
---
trial: 30d
signup: workEmail
refundWindow: 14d
approvalHours: 24
priceMove: 0.1
delayWindow: { refund: 1 business hour }
locked: [signup]
---

Props

The frontmatter keys the file takes. The body is its prose.

PropTypeRequiredDescription
trialstringHow long a trial runs before the first charge: 14d by default.
signupstringHow a buyer signs up: email, workEmail, magicLink, keyless, apiKey, oauth or agentIdentity.
refundWindowstringHow long after a charge a refund is granted without review.
approvalHoursnumberHow long an Approval waits before it escalates.
priceMovenumberThe largest Price change, as a share, an Agent makes without an Approval.
delayWindowjsonHow long each one-way Verb waits before it runs, keyed by Verb.
lockedstring[]Settings no Product below may change.

Generates

StartupBuilder compiles it into these records, Verbs and routes.

KindWhat
RecordsSetting, Change
VerbsNone.
RoutesNone.