Layout Archetypes
The Layout Archetypes Theming Dimension — locked vocabularies for site-header and site-footer patterns. Paired but independent.
The Layout Archetypes Dimension covers site chrome shape — the header at the top of every page and the footer at the bottom. Two sibling vocabularies, paired but orthogonal: a client can pick editorial-transparent nav with legal_heavy footer, or utility-first nav with cta_focused footer, or any other combination. One of the four Theming Dimensions.
Each industry pack declares a default for both in its navigationIA and footerArchetype fields. Consumer sites render the shapes at build time via the BDS <SiteHeader> and <SiteFooter> components from @brikdesigns/bds/blueprints-astro.
Archetypes are layout-level decisions, not styling — they describe which content blocks appear, in what arrangement, and how they respond to scroll. Styling is inherited from the client theme + atmosphere.
Treat archetype selection as a pack default. Clients override per-engagement via the portal Intel tab; the pack default represents Brik's curated recommendation for the vertical. If a client needs a variant outside the vocabulary, either (a) graduate their vertical to its own pack, or (b) extend the vocabulary with a new canonical archetype after a real client validates it.
Navigation
The vocabulary of site-header patterns. Locked enums in content-system/vocabularies/.
| Vocabulary | Values |
|---|---|
NAV_ARCHETYPE_VALUES | editorial-transparent · utility-first · service-centric · portfolio-minimal · calm-flat |
SCROLL_BEHAVIOR_VALUES | transparent-top-frosted-past-80 · sticky-solid · reveal-on-scroll · hide-on-scroll-down · always-solid |
DRAWER_PATTERN_VALUES | fullscreen-overlay · slide-left-panel · slide-right-panel · bottom-sheet |
Decision matrix — by industry
| Industry | Archetype | Links | Mega-menu | Scroll | Mobile |
|---|---|---|---|---|---|
| Dental | editorial-transparent | 4 | Services · 4-col | transparent-top-frosted-past-80 | fullscreen-overlay |
| Real Estate (RV / MHC) | utility-first | 5 | Communities · 3-col | sticky-solid | slide-left-panel |
| Small Business (general) | editorial-transparent | 4 | None | reveal-on-scroll | fullscreen-overlay |
Archetype semantics
What each archetype is for — audience assumptions, conversion intent, when to pick it vs. its neighbors.
editorial-transparent
4 primary links + Services mega-menu + utility cluster (phone + primary CTA). Nav is transparent over the hero at page-load, frosted glass past 80px scroll, hides on scroll-down past 120px.
Fit: luxury dental, med-aesthetic, editorial hospitality — verticals where hero photography must breathe at first load and the header is a secondary surface during browsing.
Avoid when: users land in task mode (search, filter, compare). An always-solid nav serves them better.
utility-first
5 primary links + task-oriented mega-menu + utility cluster with the primary conversion action leading (e.g. "Find a Site", "Schedule a Tour", "Free Consultation"). Always-solid background — never hides, never goes transparent. The top bar is a task surface, not a branding surface.
Fit: real-estate / RV / MHC directories, multi-practice legal, SaaS with deep product catalogs.
Avoid when: the brand moment matters more than the task (luxury, editorial).
service-centric
5 primary links + a prominent mega-menu on Services / Practice Areas / Specialties — the mega-menu IS the product discovery surface. 2-column internal layout: categories on the left, featured practitioner / case card on the right.
Fit: legal multi-practice, specialty medical groups, agencies with a productized service catalog.
Avoid when: service catalog is small (under 6 items). A flat nav does the job.
portfolio-minimal
3–4 primary links, no dropdowns, text-only serif treatment with wide tracking. Hide-on-scroll-down, reveal-on-scroll-up. Utility cluster is minimal — often just an IG icon and a ghost "Inquire" link.
Fit: MUA, photographers, wedding vendors, creative portfolios.
Avoid when: the site has more than one conversion path (book vs. contact vs. shop).
calm-flat
3–4 primary links, NO dropdowns — anxiety-sensitive audiences (wellness, mental health, therapy) don't hover-explore. Always solid at low contrast. Single warm CTA — "Book Session" — no secondary actions competing.
Fit: wellness, mental health, therapy, recovery, palliative care.
Avoid when: the audience is in research / comparison mode — they'll need a mega-menu to survey options.
Drawer patterns
Mobile drawer is a separate axis from archetype — DRAWER_PATTERN_VALUES controls how the mobile menu surfaces, independent of the desktop nav shape. Each pattern has its own interaction contract; mixing pieces (e.g. taking the slide animation from one and the scroll model from another) is how the menu becomes janky.
fullscreen-overlay
The default for editorial-transparent and small-business. The drawer takes over the entire viewport — it never renders as a bounded inner-scroll box, never lets the underlying page peek through, and never depends on --nav-h calculation timing.
Interaction contract:
- Layout. Fixed-position
inset: 0; height: 100dvh; z-indexabove the nav bar. Three flex regions: header (logo + close X), scrollable body, sticky footer (utility cluster — Contact + phone). The body has its own padding so the last item is reachable above the sticky footer. - Submenu disclosure. Tapping a parent link opens its panel inline. No separate chevron toggle, no "first tap opens, second tap navigates" ambiguity. Parent pages are reachable two ways: the matching child card (when child === parent, e.g. About → "The Practice") or the "View all X →" link at the bottom of mega panels.
- Panel collapse. Toggle the
hiddenattribute on the panel — not CSS-onlydisplay: none, not thegrid-template-rows: 0fraccordion trick. Both fail in real browsers: the grid trick leaves implicit auto-height rows when the panel has multiple children (e.g.<ul>+ "View all" link), and CSS-only collapse leaves tabbable links inside the a11y tree even when visually hidden. - Scroll lock.
body { overflow: hidden }does not hold on iOS Safari — the documentElement still rubber-bands behind the overlay. Use position-fixing instead: storewindow.scrollY, setbody.style.position = 'fixed'; body.style.top = -scrollY + 'px', and restore viawindow.scrollTo(0, scrollY)on close. - Smart-hide pause. If the site uses
hide-on-scroll-down, the smart-hide handler must bail while the menu is open (document.body.classList.contains('nav-menu-open')) so it can't fight the overlay. - Viewport guard. If the viewport crosses into ≥768px while the menu is open (orientation change on a tablet), auto-close. Otherwise the body stays scroll-locked while the desktop nav is in use.
Reference implementation: web/birdwell-mutlak/src/components/Nav.astro.
slide-left-panel / slide-right-panel
The drawer slides in from the named side, leaving a visible portion of the underlying page (typically a translucent scrim). Use when the underlying context still matters — task-mode interfaces (search, filter, compare) where the user wants the menu and their place on the page.
The same scroll-lock + viewport-guard rules apply. The submenu disclosure model is open: a separate chevron toggle is acceptable here because the drawer width may not afford a full-width tappable parent link.
bottom-sheet
The drawer rises from the bottom edge, typically capped at 60–80% of viewport height with a swipe-down handle. Use when the menu is a secondary navigation surface (e.g. a filter sheet on a listings page) and the primary nav is in a tab bar. Rare for marketing sites.
Live pack previews
Each current industry pack with its seeded navigationIA rendered as a structural mock + spec table.
Dental
| Archetype | editorial-transparent |
| Primary link count | 4 |
| Primary links | Services · About · Smile Gallery · Financing |
| Services mega-menu | Yes — 4 columns, 3 categories |
| Utility cluster | phone · solid CTA "Book" |
| Scroll behavior | transparent-top-frosted-past-80 |
| Mobile drawer | fullscreen-overlay |
Services mega-menu
Cosmetic
- Porcelain veneersCustom-crafted restorations
- Cosmetic dentistryWhitening, bonding, smile design
- Teeth whiteningIn-office + take-home systems
Restorative & Preventive
- Restorative dentistryCrowns, bridges, full-mouth rehab
- Preventive careCleanings, exams, family care
- DenturesCustom-fit, natural look
Comfort & Support
- Sedation dentistryNitrous oxide available
- Your first visit90 minutes, no surprises
- MembershipIn-house care plan
New patient?
90 minutes with the doctor you choose
Choose your doctor when you book. Both doctors are accepting new patients.
Request your first visit →Real Estate — RV Parks & MHC
| Archetype | utility-first |
| Primary link count | 5 |
| Primary links | Communities · Amenities · Rates · About · Contact |
| Services mega-menu | Yes — 3 columns, 3 categories |
| Utility cluster | phone · solid CTA "Find a Site" |
| Scroll behavior | sticky-solid |
| Mobile drawer | slide-left-panel |
Communities mega-menu
RV Parks
- All RV parks
- Seasonal sitesWeekly + monthly stays
- Premium sitesPull-through, full hookup
Mobile Home Communities
- All communities
- Homes for sale
- Lot rental
Vacation Rentals
- Cabins
- Glamping
- Group bookings
New here?
Find your site in under a minute
Tell us the dates + site type; we'll surface availability across all communities.
Check availability →Small Business (general)
| Archetype | editorial-transparent |
| Primary link count | 4 |
| Primary links | About · Services · Work · Contact |
| Services mega-menu | No |
| Utility cluster | phone · solid CTA "Get in Touch" |
| Scroll behavior | reveal-on-scroll |
| Mobile drawer | fullscreen-overlay |
Footer
The vocabulary of site-footer patterns. Sibling to navigation; same selection model.
v0.1 status: vocabulary + industry-pack field ship now so packs can declare a default. Live <SiteFooter> preview arrives with v0.2 of @brikdesigns/bds/blueprints-astro. Until then, client sites hand-roll the footer and treat this section as the spec — same pattern Birdwell followed for navigation before PR #171 shipped the nav archetype render surface.
Vocabulary
Locked enum in content-system/vocabularies/footer-archetype.ts. Extend only after a real client validates a new variant — resist adding values speculatively from design dreams.
| Slug | Dominates | Fit |
|---|---|---|
four_col_directory | Informative content — balanced | Dental (overridden), real-estate, legal, specialty medical, CRE, most service-business defaults |
cta_focused | Closing CTA | Single-service businesses, wellness, focused-offer pages, landing-page-style sites |
legal_heavy | Compliance block | Healthcare (HIPAA / §1557), legal multi-practice, financial services with prominent disclosures |
Default: four_col_directory — chosen because it suits the broadest set of service-business sites without over-weighting any one concern. Industries with a specific compliance burden or a single-conversion posture override explicitly.
Decision matrix — by industry
| Industry | Footer archetype | Why |
|---|---|---|
| Dental | legal_heavy | Healthcare = HIPAA / §1557. Privacy Officer contact + Notice of Privacy Practices need the compliance block up front. |
| Real Estate (RV / MHC) | four_col_directory | Property directories carry enough content for 4 balanced columns; disclosures are standard (bottom bar sufficient). |
| Small Business (general) | four_col_directory | Informative baseline for the widest range of service businesses. Verticals with unique footer needs graduate to their own pack. |
Archetype semantics
four_col_directory
A 4-column informative layout. From left to right:
- Brand column — logo, tagline, social icon row (3–5 icons max).
- Directory column — primary navigation links.
- Secondary column — utility pages (careers, press, blog, etc.) or the second tier of offerings.
- Visit column — address block, hours-at-a-glance, phone, primary CTA.
Below the columns: a bottom bar with copyright + legal links (Privacy Policy, Terms, HIPAA Notice link if healthcare).
Fit: service businesses with enough content to fill 4 meaningful columns — dental (with legal_heavy override), real-estate, legal, specialty medical, CRE, any vertical where a visitor landing cold on an interior page needs a lot of orientation.
Avoid when: the site has so few content types that some columns are empty, OR when the footer is the primary conversion surface (prefer cta_focused in that case).
cta_focused
Large closing CTA occupying the top two-thirds of the footer — headline + body + prominent primary action button. Below that: a trimmed row with logo, primary nav links inline, address + phone. Bottom bar same as other archetypes.
Fit: single-service businesses, wellness / mental health (where the CTA is "Book Session" and visual calm wants less chrome below), focused landing pages that have built a narrative through the body and want the footer to earn the click.
Avoid when: the site has multiple conversion paths of comparable importance (book vs. contact vs. financing) — a single large CTA flattens the real IA.
legal_heavy
Regulated-industry variant. Layout resembles four_col_directory but with a prominent compliance column replacing the Secondary column (or inserted as a 5th column depending on content volume). The compliance column surfaces:
- HIPAA Notice of Privacy Practices link + effective date
- Privacy Officer contact (name, title, email, phone)
- Non-Discrimination Statement (ACA §1557 for covered providers)
- Notice of Privacy Practices PDF link
- Any jurisdiction-specific disclosures (state board info, license numbers)
Directory + Visit columns present but secondary. Bottom bar includes the full legal link stack (Privacy, HIPAA Notice, Terms, Non-Discrimination, Accessibility).
Fit: healthcare practices subject to HIPAA (Covered Entities + Business Associates), healthcare recipients of federal funding (§1557), legal multi-practice firms with state disclosure requirements, financial services firms with consumer-disclosure obligations.
Avoid when: compliance scope is minimal — the extra weight makes the footer feel bureaucratic on a simple service-business site.
How to pick
Same resolution model for both nav and footer:
- Read the client's
industry_slugfromcompany_profiles. - Look up the pack via
getPackByIndustrySlug(industry_slug)from@brikdesigns/bds/content-system. - Read
pack.navigationIAandpack.footerArchetype— those are the defaults. If absent, fall back tosmallBusiness.navigationIAandDEFAULT_FOOTER_ARCHETYPE(four_col_directory). - Check the portal Intel tab — admin may have overridden either per-client. Overrides win.
- Pass the resolved values to
<SiteHeader>and<SiteFooter archetype={…}>from@brikdesigns/bds/blueprints-astro(footer render surface lands in v0.2).
Until the Astro blueprint components land, client Astro sites hand-roll their header and footer against the semantics documented here and swap to the BDS components for free at v0.2 upgrade. The Birdwell & Mutlak site is the reference implementation of editorial-transparent — see web/birdwell-mutlak/src/components/Nav.astro.
Related
- Theming Overview — the four-layer cascade in context
- Atmospheres — CSS overlay layer; orthogonal to layout archetype
- Blueprints — section composition patterns
- Content System / Industries — packs declare default archetypes
- Blueprints-Astro Package Spec — architecture contract for the Astro render surface
Atmospheres
The Atmospheres Theming Dimension — CSS decoration overlays that establish visual character (editorial-luxury, cinematic, warm-soft, and more) without duplicating CSS per client.
Blueprints
The Blueprints Theming Dimension — named layout + interaction patterns that ground AI mockup generation with concrete structural constraints.