Configuration

Two places hold board setup: bordful.config.ts in the repo, and Site settings in the admin (/admin, global Site settings).

Last updated Nov 3, 2026

bordful.config.ts

defineBordfulConfig in src/config/define-config.ts parses this file. Unknown keys are rejected. Defaults below match that schema. The committed file is:

export default defineBordfulConfig({
  bordfeed: {
    baseUrl: "https://bordfeed.com",
    syncCron: "0 6 * * *",
    sync: { jobsPerSync: 50, jobsPerDay: 200 },
  },
  telemetry: { clientHeader: true },
  board: { defaultTemplateId: "fully-remote" },
  alerts: { provider: "resend" },
  csp: { extraScriptOrigins: [], extraConnectOrigins: [] },
});

Option	Default	Rules
`bordfeed.baseUrl`	`https://bordfeed.com`	`https` only. Use the origin only, for example `https://bordfeed.com`. The schema does not reject a trailing path. `BORDFEED_BASE_URL` overrides this at runtime and may be `http` for a local mock.
`bordfeed.syncCron`	`0 6 * * *`	Five cron fields. Step values must use `*/N` or `a-b/N`. This matches the Vercel cron for `/api/cron/bordfeed`. Editing it does not change `vercel.json`.
`bordfeed.sync.jobsPerSync`	`50`	Most jobs one sync fetches, including the first sync. Clamped to 20 to 100. A value set in the Bordfeed Connection global wins over this one. See Credits per sync.
`bordfeed.sync.jobsPerDay`	`200`	Most jobs fetched per UTC day across every sync. Clamped to 20 to 5000. A value set in the Bordfeed Connection global wins over this one.
`telemetry.clientHeader`	`true`	`false` drops the `X-Bordfeed-Client` header and `install_id`. `ref` and `utm_*` still go out. See Bordfeed.
`board.defaultTemplateId`	`fully-remote`	Template used for sample jobs and for the feed created at connect. Read once, on first boot. An existing board keeps the template stored in its Bordfeed connection, so changing this value later does not move it.
`alerts.provider`	`resend`	Only `resend`.
`csp.extraScriptOrigins`	`[]`	Intended extra `script-src` origins. `https` origins only. Not applied yet.
`csp.extraConnectOrigins`	`[]`	Intended extra `connect-src` origins. `https` origins only. Not applied yet.

Live Bordfeed template ids (2 Nov 2026): fully-remote, remote-writing, engineering-it, growth-marketing-eu, customer-support, remote-design, senior-tech-remote-us.

An extra CSP origin is an origin, not a URL path. https://cdn.example.com is the shape buildCsp accepts. A path, a quote, a semicolon, a space, or a comma is rejected by buildCsp. One leading wildcard label is allowed (https://*.example.com). Those checks run only when the lists are passed in. Today they are not: src/proxy.ts calls buildCsp({ isDev, nonce }) and ignores bordful.config.ts. An origin you add stays blocked until that call passes csp.extraScriptOrigins and csp.extraConnectOrigins.

Site settings

Admins edit the Site settings global. Editors do not.

Group	Fields
(top)	Name (default `Job Board`), tagline, logo (media upload).
Theme	Ten color overrides, heading font, body font, radius. See Theming.
Board	Title, description, jobs per page (5 to 100, default 20), public detail fields.
Post a Job	Enabled (default off), payment link URL, price label (default empty), duration in days (default 30, 1 to 365). See Post a Job.
Alerts	Enabled (default off), default frequency (`weekly` or `daily`, default `weekly`), sender name, sender email. See Job alerts.
Showcase	List my board (default off).

Public detail fields, all on by default: salary, location, employmentType, workplaceType, careerLevel, languages, categories, validThrough.

BORDFUL_MARKETING is not a Site settings field. It is an environment variable, and it is true only on bordful.com. See Deploy.

PreviousDeploy NextCustomization