Start Here
Set up this build's design system here before you open any other page in Bricks. Below are the setup steps, a live style guide of this site's design system, and IGD's build practices. This page is deleted at launch.
Setup steps
Work through these in order. Steps 2, 3 and 5 are required before building.
1 · Fill in the token sheet
Start from the project's design input, whether that's the design brief, a Claude design system or an HTML mockup, and fill in the IGD token sheet: the three brand colors, the two neutrals, the heading and body fonts, and any scale changes.
2 · Set the colors
Open this page in Bricks (Edit with Bricks), then open the Style Manager and edit the Brand palette. Until setup is done, this is the only page Bricks opens. Replace Primary, Secondary and Accent (the magenta, lime and orange placeholders). Dark and Light start as near-black and off-white; change them if the design calls for it. Each brand color's lighter, darker and transparent shades follow it automatically. Don't click “Generate shades” on these colors: it replaces the live shades with fixed values.
3 · Set the fonts
Find the design's fonts in Bricks' Font Manager and choose Download & install, so the fonts are served from this site instead of Google. Then, still in Bricks on this page, open Theme Styles › IGD Base › Typography and set Body (currently Comic Sans MS) and All headings (currently Impact).
4 · Adjust the scales (only if needed)
Text and spacing grow smoothly from 360px to 1440px screens. If the design needs bigger or smaller type or spacing overall, change the base size or ratio of the Text or Space category in the Variables manager. Bricks recalculates every step for you.
5 · Review the style guide
Scroll through the style guide below and compare it with the design. When it matches, tick “Design system reviewed”.
- ○ Brand colors set (Primary, Secondary, Accent)
- ○ Fonts chosen in IGD Base (Body, All headings)
- ○ Style guide reviewed on Start Here
Set the brand colors and fonts first (steps 2 and 3), then come back here to review.
6 · Build the site
Home is blank and already set as the homepage. Open it in Bricks and start building. Until steps 2, 3 and 5 are done, opening a page in Bricks brings you back here.
7 · Launch
Before go-live, work through the IGD launch checklist: delete this page, delete the IGD plugin, activate Wordfence and WP Super Cache, and deactivate MCP Adapter.
Style guide
Everything in this section is built from this site's tokens and classes, so it always shows the current design system. Until the colors and fonts are set, it shows the placeholders.
Colors
Primary · --primary
Primary lighter · --primary-l-1
Primary darker · --primary-d-1
Primary transparent · --primary-t-1
Secondary · --secondary
Secondary lighter · --secondary-l-1
Secondary darker · --secondary-d-1
Secondary transparent · --secondary-t-1
Accent · --accent
Accent lighter · --accent-l-1
Accent darker · --accent-d-1
Accent transparent · --accent-t-1
Dark · --dark
Dark lighter · --dark-l-1
Dark darker · --dark-d-1
Light · --light
Light lighter · --light-l-1
Light darker · --light-d-1
Typography
Heading 1 · --text-3xl
Heading 2 · --text-2xl
Heading 3 · --text-xl
Heading 4 · --text-l
Heading 5 · --text-m
Heading 6 · --text-s
Lead text · --text-l. Use the Lead type on a Heading or Rich Text element for intro paragraphs.
Body text · --text-m. Sphinx of black quartz, judge my vow. Pack my box with five dozen liquor jugs.
Links inside text use Primary: this is a text link.
Text scale
xs · --text-xs · Sphinx of black quartz, judge my vow
s · --text-s · Sphinx of black quartz, judge my vow
m · --text-m · Sphinx of black quartz, judge my vow
l · --text-l · Sphinx of black quartz, judge my vow
xl · --text-xl · Sphinx of black quartz, judge my vow
2xl · --text-2xl · Sphinx of black quartz, judge my vow
3xl · --text-3xl · Sphinx of black quartz, judge my vow
Space scale
--space-xs
--space-s
--space-m
--space-l
--space-xl
--space-2xl
--space-3xl
Radius and shadows
--radius-s
--radius-m
--radius-l
--radius-full
.shadow-s · --shadow-s
.shadow-m · --shadow-m
.shadow-l · --shadow-l
Buttons
Building with this Sandbox
IGD's build practices for this Sandbox: carried over from the v1 guide where they still apply, and updated for v2.
How this Sandbox is organized
IGD standards are the same on every build: the breakpoints, the Style Manager settings, the token names, the structure of the IGD Base theme style and the utility classes. Don’t change them on a client site. If one of them should change, tell the core team so the Sandbox is updated for everyone.
Client slots are what you set for each project: the five colors, the two fonts and, when the design needs it, the text and space scale settings.
Breakpoints: Desktop 1440 (base) · Laptop 1024 · Tablet 768 · Mobile L 425 · Mobile S 375. Bricks is desktop-first: style the desktop view first, then adjust at smaller breakpoints. Each breakpoint’s styles apply at its width and below.
Use tokens, not raw values
Whenever a Bricks control accepts a value, pick a variable instead of typing pixels or hex codes. When the design changes, the whole site follows.
- Colors:
--primary,--secondary,--accent,--dark,--light. Each brand color also has-l-1(lighter),-d-1(darker) and-t-1(transparent). Color classes such as.bg-primaryand.text-primaryare available too. - Text sizes:
--text-xsto--text-3xl. Body text is--text-m. - Spacing:
--space-xsto--space-3xl. - Layout:
--gutter(the side padding every section uses) and--flow-space(the gap the flow class adds). - Radius:
--radius-s,--radius-m,--radius-l,--radius-full. - Shadows:
--shadow-s,--shadow-m,--shadow-l. Bricks’ box-shadow control can’t take a variable, so apply them with theshadow-s,shadow-mandshadow-lclasses.
Text sizes and spacing are fluid: they grow smoothly from 360px to 1440px screens, so you rarely need breakpoint-specific values for them.
Utility classes
Add these as global classes on an element (Style › CSS › CSS classes). They cover the common layout patterns so you don’t rebuild them on every site.
- grid-2, grid-3, grid-4: equal columns with a
--space-mgap. grid-3 and grid-4 drop to 2 columns at Tablet, and all three drop to 1 column at Mobile L. - stack: stacks children vertically with a
--space-mgap. - cluster: a wrapping row of items such as tags, buttons or icons, with a
--space-sgap. - section-s, section-l: tighter or roomier top and bottom padding on a Section. The side gutter stays the same.
- text-center: centers text.
- text-balance: evens out the line lengths of a heading.
- flow: adds space between stacked content, such as paragraphs and lists in a text column.
- visually-hidden: hides text on screen but keeps it for screen readers.
- link-overlay: put it on a card and the card’s link covers the whole card. Use one link per card.
- shadow-s, shadow-m, shadow-l: apply the three shadow tokens.
Demo: grid-3
Column 1
Column 2
Column 3
Demo: cluster
Design
Build
Launch
Support
Demo: text-balance
This longer heading wraps onto two lines, and text-balance evens out their lengths
Demo: link-overlay
Demo: visually-hidden
Screen readers announce a hidden sentence right after this one.
This sentence is visually hidden but read by screen readers.
Theme Styles and Page Settings
This Sandbox ships with one theme style, IGD Base, applied to the whole site. It connects Bricks’ defaults to the tokens: body and heading typography, H1–H6 sizes, link and button colors, section padding and container width. Set the fonts in it (setup step 3) and leave the rest alone: it already follows the colors and scales you set.
Page Settings (Bricks editor › Settings › Page Settings) control how a single page behaves: a page-specific background, turning off site-wide popups on that page, extra body classes and so on. Check them before you start a page layout.
Templates
Templates are powerful, but you don’t need them for the whole build. With IGD Base handling site-wide styling, every regular page can be built directly on the page itself (Pages › Edit with Bricks). That keeps content where editors expect it and makes updates simple.
Use templates for headers, footers, single-item layouts for custom content (Pods), posts and products, and sections repeated across pages such as sidebars, modals and off-canvas panels. Anything driven by dynamic data is a good candidate, unless a simple query loop on the page is enough.
Components
Components make repeated content easy. If a layout has a repeatable, complex element that doesn’t pull dynamic data (for example from Pods), build it as a component. Editors can update its content without being able to change its layout. Build components from real, repeated content during the project; this Sandbox doesn’t ship any.
Custom code
For consistency, put site-wide custom CSS or JavaScript in Bricks › Settings › Custom Code, so everyone knows where to find it. Element-level custom CSS is fine for a one-off tweak, but global code belongs there.
Preferred elements
Forms: Bricksforge Pro Forms. No third-party form plugin needed. Pro Forms has every field type, honeypot and reCAPTCHA protection, picks up the site’s styling automatically, and adds a Submissions screen to the dashboard for every form on the site.
Logo: the Logo element. An Image element works, but the Logo element is built for the job: more control over how the logo displays, plus the right SEO markup.
Text: Basic Text over Rich Text. Basic Text lets editors update the words without changing the look. Rich Text lets them change the formatting too, which can break the layout. Use Rich Text only where editors really need formatting. The next paragraph shows what can go wrong.
This paragraph was added with a Rich Text element, which let me change the design without touching anything but the text editor.
Plugins
- Admin and Site Enhancements (ASE): admin workflow and site improvements that replace a pile of single-purpose plugins.
- Better Search Replace: fixes old URLs in content and fields after a site is cloned or moved.
- Bricksable: extra Bricks elements and extensions focused on subtle animation and engagement.
- Bricksforge: extends Bricks with Pro Forms and many more features.
- MCP Adapter: connects the site to Claude for core devs. Leave it deactivated unless you’re a core dev using it on this build.
- Pods: custom content types and fields.
- Post Types Order: drag-and-drop ordering for posts and Pods content.
- Site Kit by Google: Search Console and Analytics setup.
- Wordfence: security. Off until launch.
- WP Super Cache: page caching. Off until launch.
Getting a new site
Most builds start as a DEV site that the tech team creates on the dev-stag server by cloning this Sandbox. Running a local copy is possible too; ask the core team.