startup.ts

startup.ts marks a Startup and holds its name, its Domain, the Startup Template it extends, and its own values. It is the business record as code.

import { Startup } from 'startup-builder'

export default Startup({
  name: 'Leaseline',
  domain: 'leaseline.app',
  extends: 'solo-saas',
})

ReferenceCopy Anchor Link

One Startup() call with literal values. The file is parsed, never run, so it holds data only. Spreads of Templates are allowed; a loop, a computed value or a call into your own code fails the parse check and names the line.

The Startup's own fields are name, domain, extends, idea, hypothesis (the Founding Hypothesis), msc, offers and routes. Any Setting, such as signup or trial, takes its own value as well (Settings). Every key gives each one's type and default.

Role seats keyed by function, such as support: { agent: 'Rae' }, are shorthand. The full seat lives in Roles.

Every keyCopy Anchor Link

Each key the root file takes, with its type, its default and the Builder that reads it. The Startup root file reference adds the errors a push fails with.

ExamplesCopy Anchor Link

LeaselineCopy Anchor Link

import { Startup } from 'startup-builder'

export default Startup({
  name: 'Leaseline',
  domain: 'leaseline.com',
  extends: 'solo-saas',
  idea: 'Small property managers pay to never miss a lease renewal.',
  hypothesis: {
    customer: 'Property managers with 20 to 200 units',
    problem: 'Renewals slip because end dates live in a spreadsheet',
    approach: 'Import the rent roll and send every notice at 60 days',
    switch: 'A spreadsheet and a calendar reminder',
    differentiation: 'Set up in ten minutes from the rent roll',
  },
  signup: 'magicLink',
  trial: '30d',
})

Three spellingsCopy Anchor Link

The same Startup in MDX and JSON parses to one fingerprint. npm create startups writes TypeScript, and startups.new writes MDX.

---
name: Leaseline
domain: leaseline.com
extends: solo-saas
---
Leaseline tracks lease renewals for small property managers, so no renewal slips past its date.

{ "name": "Leaseline", "domain": "leaseline.com", "extends": "solo-saas" }

What it buildsCopy Anchor Link

The StartupBuilder compiles the file and directs the other four Builders.

• the Startup, created with Startup.create and extended with Template.extend on the first write
• its Settings, and the Interfaces its Startup Template declares: /api, /app, /docs and MCP
• the Events Template.extended, then Startup.built when the first build finishes

RoutingCopy Anchor Link

The Startup's namespace is its domain: https://api.sb/leaseline.com serves its API, and leaseline.com/api serves the same on its own Domain. A route to custom code needs a reason:

routes: { '/webhooks/partner': { to: 'code/partner-webhook', reason: 'The partner posts form-encoded webhooks that no Verb accepts.' } }

Good to knowCopy Anchor Link

• Two root files in one folder fail. Pick startup.ts, startup.mdx or startup.json.
• A key set in both startup.ts and settings.mdx fails, so every Setting has one home.
• npx startup-builder show / prints the whole Startup, own and inherited values.