← Back to the Brail website

What is a brand shell?

Part of: BuildLast updated 6 November 2026

A brand shell is a ready-made, on-brand HTML starting point for one type of output, such as a sales deck, proposal or one-pager, with slots an agent fills with content.

Also called: HTML shell, brand template, presentation shell.

Why it matters.

AI agents write and arrange content well, and invent layouts less reliably. A shell takes layout off the table: the structure, typography, spacing and brand elements are fixed, and the agent fills the slots with the right copy, images and numbers.

Shells are most useful for the outputs a team makes again and again, such as sales decks, proposals, customer reports and one-pagers. Paired with the right context and examples for that situation, a shell is how an agent gets a polished result without a designer rebuilding it. Kept as versioned files, a shell is improved once and every new piece picks up the change.

Example.

BeforeAsked for a proposal, Claude designs its own document. The headings, spacing and colours only loosely resemble the brand, so a designer spends an hour fixing it.
AfterThe agent starts from the brand's proposal shell and fills its sections with the client's details, the right case study and approved images. It looks like the design team made it.

How Brail handles it.

Brail keeps your deck, proposal and report shells as versioned HTML files, so each request starts from your current layout instead of one an agent invents. When the design team updates a shell, the next deck made in any tool uses the new version, and the old one stays in the history.

Questions people ask.

How do I get AI to make slides in our brand?
Give it a shell: an on-brand HTML starting point for decks, with slots for content, plus your brand kit. The agent fills the content and keeps your layout. See HTML-first marketing.
What's the difference between a brand shell and a template?
In practice a shell is a template written in HTML and CSS, built so an AI agent can fill it reliably, rather than a .pptx or design file a person edits by hand.
How do we change a shell without losing the old one?
Keep shells as versioned files. A change becomes a new version that new work starts from, and earlier versions stay in the history and can be restored. See brand versioning.
  • Brand HTML: Brand HTML is a brand expressed as working HTML and CSS that AI agents fill with content instead of designing from scratch.
  • Brand blocks: Brand blocks are reusable on-brand sections, such as a hero, stat row, quote, case card or call to action, written as plain HTML and CSS so any agent or tool can assemble them.
  • HTML-first marketing: HTML-first marketing is producing decks, proposals, reports and pages as HTML instead of .pptx or .png, because AI agents build and edit HTML well, and the result can be branded, versioned, published and tracked.
  • Brand versioning: Brand versioning is giving every brand file, from messaging and pricing to logos and skills, a history, an owner, a draft or approved status and sign-off for changes, so agents only use approved versions.
  • Brand kit: A brand kit is a brand's core visual set in usable form: logos, colours, fonts and design tokens, plus a few key visuals, ready for an agent to apply.
  • Train AI on your brand: You train AI on your brand by giving it the context, examples, assets and rules it needs before it produces anything.

Read more.