TILT Handbook
This is the internal operating manual for TILT. It covers the business (how we sell, deliver, support, and run the company) and everything we have built (the website, the models, the tools). It is private.
How to read it
Section titled “How to read it”Use the left sidebar or the search box (top of the page). Search is full-text across every page. Each section is organized by function, not by date, so you look up what you need rather than reading start to finish.
How it works behind the scenes
Section titled “How it works behind the scenes”- The real content is plain Markdown files in this repository under
docs-site/src/content/docs/. Those files are the single source of truth. The same Markdown still feeds the customer bot knowledge pack andllms.txt. - This website is built from those files and published privately to Cloudflare Pages, gated by Cloudflare Access (email one-time-PIN login). Nobody without an approved email can see it.
- It is not indexed by Google and is not linked from tiltanalytics.com.
How to edit it
Section titled “How to edit it”- Day to day: ask Claude Code to make the change, then run
npm run deployinsidedocs-site/. - Small fix without a terminal: open the repo on GitHub, press
.to launch the browser editor, edit the Markdown file, commit. Then anpm run deploypublishes it.
Reading the callouts
Section titled “Reading the callouts”Section map
Section titled “Section map”| Section | What is in it |
|---|---|
| Company | Who we are, how we position, who we sell to, who does what, continuity |
| Products | Every model and tool, what each does, who it is for, pricing |
| Sales | The playbook from first contact to closed |
| Delivery | How a model gets built, customized, and handed off |
| Support | The support promise as a real process; renewals |
| Marketing | Channels, the plan, site and SEO operations |
| Website & Tech | Architecture, the deploy process, the rent worker, the runbook |
| Finance & Admin | Bookkeeping, the vendor register, payment operations |
| Accounts & Access | Pointer inventory of logins and access (no passwords stored here) |
| Reference | Glossary, voice rules, forms and links, the bot, the notes system |
| Decisions | Why we did things a certain way; the change log |