Skip to content

Page structure and global styles

The marketing site has three separate layers. Keeping them separate makes changes easier to understand and safer to publish.

LayerControlsMain location
ContentWords, headings, prices, calls to action, and SEO fieldsSanity Studio or the page’s fallback data
StructureWhich sections appear and the order in which they appearsrc/pages/*.astro
PresentationColors, spacing, widths, typography, grids, and responsive behaviorsrc/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.

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-hero supplies the shared interior-page hero background and spacing.
  • compact-hero constrains the heading size for a shorter hero.
  • section-shell gives content the standard maximum width, equal side gutters, and vertical spacing.
  • eyebrow styles the small uppercase label above a heading.

The homepage has a purpose-built hero:

  • hero is the complete homepage hero section.
  • hero-content contains the eyebrow, heading, summary, and buttons.
  • hero-grid contains decorative artwork only. It does not contain editable page content.
  • hero-summary styles the introductory paragraph.
  • hero-actions arranges the primary and secondary calls to action.
  • proof-strip contains the three proof points below the hero.

Use these classes to choose a layout without creating page-specific CSS unnecessarily.

ClassIntended content
section-shellStandard full-width page section with aligned content gutters
section-splitTwo-column text section that becomes one column on mobile
two-column-listIntroductory text beside a list
feature-gridThree feature cards
catalog-gridFeature catalogue entries
solution-gridIndustry and use-case entries
integration-gridIntegration entries
pricing-gridPricing plan cards
control-gridSecurity control cards
resource-listResource and documentation links
story-listCustomer story entries
faq-listQuestions and answers
cta-panelA 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.

Public pageStructure fileMain layout classes
Homesrc/pages/index.astrohero, proof-strip, section-split, feature-grid, workflow-layout, cta-panel
Featuressrc/pages/features.astropage-hero, feature-catalog, catalog-grid
Solutionssrc/pages/solutions.astropage-hero, solution-catalog, solution-grid
Platformsrc/pages/platform.astropage-hero, two-column-list, platform-map
Integrationssrc/pages/integrations.astropage-hero, integration-grid
Pricingsrc/pages/pricing.astropage-hero, pricing-grid, tier-card, pricing-automation
Securitysrc/pages/security.astrosecurity-hero, control-grid, evidence-strip
Resourcessrc/pages/resources.astropage-hero, resource-list
Customerssrc/pages/customers.astropage-hero, story-list
FAQsrc/pages/faq.astropage-hero, faq-list
Contactsrc/pages/contact.astrocontact-hero, contact-layout, contact-box

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);
}
  • --paper is the main page background.
  • --ink is the primary text color.
  • --muted is used for supporting text.
  • --line controls borders and separators.
  • --surface is the background for cards and raised content.
  • --teal and --teal-strong are the primary brand accents.
  • --cobalt, --amber, and --rose provide secondary accents.
  • --page-max controls the maximum content width across the marketing site.
  • --page-gutter controls 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 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.

  1. Change wording, prices, or SEO values in Sanity when the field is available there.
  2. Change section order or add a new content block in the relevant src/pages/*.astro file.
  3. Change a shared color, maximum width, or gutter through a :root variable.
  4. Change one component’s appearance through its existing class in global.css.
  5. 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.