Core concepts

If the tutorials showed you how to use bidsmith, these pages explain why it’s shaped the way it is. Read them once and the rest of the docs will land faster.

You don’t need to read them in order; each page stands alone. If you only have time for two, read The .bid file and Plan and apply — those two concepts cover ~80% of bidsmith.

The basics

The .bid file What a .bid file is made of, and how a project is laid out.

Plan and apply The preview-before-mutating loop that's bidsmith's safety belt.

How things connect

Modules Why each .bid file's name matters, and when to split into multiple files.

References How resources point at each other — and how bidsmith catches typos for you.

When things get interesting

Drift What happens when the dashboard and your .bid file disagree.

The GitHub flow for marketers Branch, pull request, review, merge — how a single change moves through your team.

Authentication What bidsmith does with your Google credentials, and what it doesn't.