Page structure and global styles
The marketing site has three separate layers. Keeping them separate makes changes easier to understand and safer to publish.
| Layer | Controls | Main location |
|---|---|---|
| Content | Words, headings, prices, calls to action, and SEO fields | Sanity Studio or the page’s fallback data |
| Structure | Which sections appear and the order in which they appear | src/pages/*.astro |
| Presentation | Colors, spacing, widths, typography, grids, and responsive behavior | src/styles/global.css |
CSS classes do not decide the actual wording on a page. They describe the role and appearance of the HTML element to which they are attached.
Common page anatomy
Section titled “Common page anatomy”Most interior marketing pages begin with the same structure:
<section class="page-hero compact-hero"> <div class="section-shell"> <p class="eyebrow">Features</p> <h1>Page heading</h1> <p>Page introduction</p> </div></section>page-herosupplies the shared interior-page hero background and spacing.compact-heroconstrains the heading size for a shorter hero.section-shellgives content the standard maximum width, equal side gutters, and vertical spacing.eyebrowstyles the small uppercase label above a heading.
The homepage has a purpose-built hero:
herois the complete homepage hero section.hero-contentcontains the eyebrow, heading, summary, and buttons.hero-gridcontains decorative artwork only. It does not contain editable page content.hero-summarystyles the introductory paragraph.hero-actionsarranges the primary and secondary calls to action.proof-stripcontains the three proof points below the hero.
Reusable layout classes
Section titled “Reusable layout classes”Use these classes to choose a layout without creating page-specific CSS unnecessarily.
| Class | Intended content |
|---|---|
section-shell | Standard full-width page section with aligned content gutters |
section-split | Two-column text section that becomes one column on mobile |
two-column-list | Introductory text beside a list |
feature-grid | Three feature cards |
catalog-grid | Feature catalogue entries |
solution-grid | Industry and use-case entries |
integration-grid | Integration entries |
pricing-grid | Pricing plan cards |
control-grid | Security control cards |
resource-list | Resource and documentation links |
story-list | Customer story entries |
faq-list | Questions and answers |
cta-panel | A closing call-to-action section |
At widths below 900px, the multi-column layouts above become one column. The smallest-screen adjustments are under the 520px media query at the bottom of global.css.
Page map
Section titled “Page map”| Public page | Structure file | Main layout classes |
|---|---|---|
| Home | src/pages/index.astro | hero, proof-strip, section-split, feature-grid, workflow-layout, cta-panel |
| Features | src/pages/features.astro | page-hero, feature-catalog, catalog-grid |
| Solutions | src/pages/solutions.astro | page-hero, solution-catalog, solution-grid |
| Platform | src/pages/platform.astro | page-hero, two-column-list, platform-map |
| Integrations | src/pages/integrations.astro | page-hero, integration-grid |
| Pricing | src/pages/pricing.astro | page-hero, pricing-grid, tier-card, pricing-automation |
| Security | src/pages/security.astro | security-hero, control-grid, evidence-strip |
| Resources | src/pages/resources.astro | page-hero, resource-list |
| Customers | src/pages/customers.astro | page-hero, story-list |
| FAQ | src/pages/faq.astro | page-hero, faq-list |
| Contact | src/pages/contact.astro | contact-hero, contact-layout, contact-box |
Global visual settings
Section titled “Global visual settings”The :root block at the top of src/styles/global.css is the visual control panel for the marketing site:
:root { --paper: #f8faf5; --ink: #111827; --muted: #5b6472; --line: #d9e3dc; --surface: #ffffff; --teal: #147a6c; --teal-strong: #0b5e54; --cobalt: #345cf4; --amber: #f2b84b; --rose: #c94f68; --page-max: 1180px; --page-gutter: clamp(1.25rem, 4vw, 4rem);}--paperis the main page background.--inkis the primary text color.--mutedis used for supporting text.--linecontrols borders and separators.--surfaceis the background for cards and raised content.--tealand--teal-strongare the primary brand accents.--cobalt,--amber, and--roseprovide secondary accents.--page-maxcontrols the maximum content width across the marketing site.--page-guttercontrols equal left and right page padding responsively.
Changing one of these variables updates every rule that references it. Use a page-specific class when a change should affect only one section.
Global content settings
Section titled “Global content settings”Global content is different from global CSS. In Sanity Studio, Site Settings controls values shared by the whole website: the default site title and description, primary domain, shared logo and favicon assets, header navigation and actions, footer description, footer link columns, copyright name, and footer-bottom tagline. Uploaded assets in the Brand tab take precedence over the existing public-file paths and are used by both the marketing site and Docs.
Page-specific wording belongs in the corresponding document, such as Home Page or Pricing
Page. The values in src/lib/site.ts are fallback content used only when the corresponding
published Site Settings field is empty. The header and footer markup remain in
src/components/SiteHeader.astro and src/components/SiteFooter.astro.
Choosing where to make a change
Section titled “Choosing where to make a change”- Change wording, prices, or SEO values in Sanity when the field is available there.
- Change section order or add a new content block in the relevant
src/pages/*.astrofile. - Change a shared color, maximum width, or gutter through a
:rootvariable. - Change one component’s appearance through its existing class in
global.css. - Add a new class only when the element has a genuinely new visual or structural role.
After a CSS or Astro change, run npm run build. After a Sanity content change, publish the document; the Cloudflare webhook will rebuild the static site.