Style Guide

Yardful — Brand QA Surface

Auto-generated by sparkles/laravel-core v3.40.0+. Every brand token, typography role, button variant, and layout primitive in this site's active archetype. Use as a pre-launch checklist and as ground truth for design-integrity scanners. Gated by sparkles-core.style_guide.gate. No-index by default.

1. Color tokens

Brand palette

If a swatch reads as default Tailwind blue (#2563eb) the archetype was never customized — see theme.css.

--color-surface page bg
--color-surface-alt alt bg / cards
--color-text body copy
--color-heading headings
--color-text-muted metadata / captions
--color-text-soft strong dark text
--color-accent CTA / link / accent
--color-accent-ink text on accent
--color-accent-hover CTA hover
--color-border dividers / hairlines
--color-success success
--color-warning warning
--color-danger danger

Component slots

--spk-nav-bg nav background
--spk-nav-text nav text
--spk-nav-cta-bg nav CTA background
--spk-nav-cta-text nav CTA text
--spk-footer-bg footer background
--spk-footer-text footer text
--spk-footer-muted footer secondary text
--spk-footer-brand-name footer brand name
2. Typography

Display + body roles

h1 — display

The five archetypes catch most brands.

h2 — section heading

Sober, on-brand, AA-passing by default.

h3 — subhead

For grouped content within a section.

.eyebrow
Sparkles studio
body — paragraph

Body copy uses the brand body font at var(--spk-body-line-height). The body color is var(--color-text); muted secondary copy reads as var(--color-text-muted).

.section-rule
3. Buttons

Variants × sizes

Link as button
4. Radius scale

Border radius tokens

--spk-radius-xs
--spk-radius-sm
--spk-radius-md
--spk-radius-lg
--spk-radius-xl
--spk-radius-2xl
--spk-radius-full
5. Shadow scale

Box shadow tokens

--spk-shadow-xs
--spk-shadow-sm
--spk-shadow-md
--spk-shadow-lg
--spk-shadow-xl
6. Spacing scale

Vertical rhythm tokens

--spk-space-xs
--spk-space-sm
--spk-space-md
--spk-space-lg
--spk-space-xl
--spk-space-2xl
--spk-space-3xl
--spk-space-4xl
7. Layout primitives

Section / container / grid / cluster / stack

.spk-container — capped width container with fluid horizontal gutter.
Card 1 .spk-card-pad
Card 2 .spk-card-pad
Card 3 .spk-card-pad
Card 4 .spk-card-pad
.pill .spk-cluster items wrap horizontally
8. Section components

Pre-composed patterns (v3.40.0+)

Drop-in section components from <x-sparkles::sections.*>. Each composes layout primitives + typography + brand tokens; sites pass slot content.

<x-sparkles::sections.philosophy-bullets>
Studio philosophy

What this archetype is for.

A grounded baseline so a fresh site renders coherently before the operator overrides any tokens.

  • AA-safe color pairings out of the box
  • Display + body fonts pre-paired (no free-Google-fonts paralysis)
  • Spacing rhythm that doesn't feel cramped
  • Section components compose without custom CSS
<x-sparkles::sections.faq-accordion>
Why archetypes instead of one base theme?

Because a real-estate site and a fine-art gallery need different rhythms, fonts, and accent treatments. Forcing one theme means every site iterates against the same defaults.

Can I override individual archetype values?

Yes — that's the whole point. Override 3-7 brand vars in theme.css; everything else inherits from the archetype.

<x-sparkles::sections.cta-banner>
Ready to launch

From scaffold to public in hours, not weeks.

Pick an archetype, override 5 colors, ship.

Start a new site