Design Tokens First
No reusable design decision is hard-coded when it can be expressed as a token. Component values are centralized in /design/components.php.
Design System Edition · v0.8.3.8.4
Living Style Guide & Component Reference for a PHP-driven, modular, documented, responsive framework.
Core design decisions shared by every component: colors, typography, spacing, borders, radius, and shadows.
Foundation values live in /design. The dynamic assets/css/colors.php renderer converts color data into CSS custom properties.
Design data, presentation, components, utilities, documentation, and reusable PHP partials each have one clear responsibility.
Monarch is governed by single-source-of-truth, token-first, declarative architecture.
No reusable design decision is hard-coded when it can be expressed as a token. Component values are centralized in /design/components.php.
/monarch contains framework and privileged Designer/Administrator tools; the project root contains the website; future security services will reside under /monarch/security.
Favicon identity is configured once in design/branding.php. Pages inside /monarch automatically use Monarch branding; website pages use the site brand.
monarch/assets/favicon/assets/favicon/Labels and HEX values are rendered from design/palette.php and design/theme.php.
Rosewood · #B1657CSoft Periwinkle · #AE9DEDDust Grey · #D7D7D7Sunflower Gold · #F4C369Midnight Violet · #201829Muted Grey · #777777Visited Violet · #7045A0Code Green · #7CFC7CCode Background · #11101AError Pink · #FF9A9A#FF0000#FFD700#0066FF#FF7F00#00A651#8000FF#FF4500#FFB000#9ACD32#009999#5A4FCF#C71585Standard paragraph text for readable long-form content.
Small text
Large text
Light text
Semibold text
Bold text
Good typography makes great design.
Layout organizes space. Flow organizes rhythm. Semantic presets control relationships between direct siblings without placing exterior spacing on the elements themselves.
Paragraphs maintain a calm, responsive cadence.
A later heading receives additional separation to clearly begin a new thought.
The same markup becomes tighter on small screens and more relaxed as space increases.
Dashboard information stays visually connected.
Density changes without element-specific margin utilities.
The preset names the experience rather than the CSS mechanism.
<article class="flow-reading">...</article>
A concise visual reference for Monarch's core spacing, radius, and shadow values. Numeric values are highlighted in code green.
--space-0
0
--space-xs
.25rem
--space-sm
.5rem
--space-md
1rem
--space-lg
1.5rem
--space-xl
2rem
--space-2xl
3rem
--space-3xl
4rem
--radius-none
0
--radius-sm
.25rem
--radius-md
.5rem
--radius-lg
.75rem
--radius-xl
1rem
--radius-full
999px
--radius-pill
999px
--shadow-sm
0 2px 6px rgba(0,0,0,.18)
--shadow-md
0 10px 24px rgba(0,0,0,.25)
--shadow-lg
0 18px 48px rgba(0,0,0,.35)
Reusable interface modules with documented markup and predictable variants.
All twelve list types, including the Feature List, are preserved and documented.
Cards use the increased 3px outer stroke throughout the framework.
A flexible content container built from reusable tokens.
A highlighted variant with accent emphasis and elevation.
Cards may include responsive media and optional footer content.
| Layer | Location | Purpose |
|---|---|---|
| Design data | /design | Single source of truth |
| Presentation | /assets/css | Visual rules and generated tokens |
| Components | /components | Reusable PHP markup |
| Documentation | /docs | Standards and maintenance guidance |
Compositions made from foundation tokens, components, and utilities.
Monarch preserves familiar .container > .row > .col-* markup while generating dimensions, gutters, and responsive behavior from design/layouts.php.
.container-narrow
.container
.container-wide
.col-6.col-6.col-12 .col-md-8.col-12 .col-md-4| Token | Value | Responsibility |
|---|---|---|
grid.columns | 12 | Column proportions |
grid.gutter | lg | Space between columns |
containers.standard | 75rem | Default maximum width |
containers.padding | lg | Responsive edge protection |
<div class="container">
<div class="row">
<div class="col-12 col-md-8">Main content</div>
<div class="col-12 col-md-4">Sidebar</div>
</div>
</div>
Combine typography, spacing, labels, and buttons.
A compact status message assembled from utilities.
Patterns coordinate Layout, Flow, and Components into reusable content compositions.
Organizes the responsive spatial relationship.
Controls the rhythm inside each card.
Express the purpose of each content unit.
Templates establish reusable page skeletons. The project root contains the Universal Website reference pages, including Home, About Us, Services, Contact, FAQ, Blog, Article, and 404.
/templates contains one-column, two-column, landing, article, and documentation skeletons.
/docs/recipes documents how Patterns and Templates compose complete page experiences.
Single-purpose classes that solve small layout and presentation needs without creating a new component.
d-block d-inline d-inline-block d-flex d-grid d-noneflex-row flex-column flex-wrap justify-center justify-between align-centergrid-2 grid-3 grid-4 grid-auto gap-sm gap-md gap-lgcontainer container-narrow container-wide container-fluidm-0 m-sm m-md mt-md mb-md p-sm p-md p-lgw-25 w-50 w-75 w-100 max-400 max-600 max-800Utility text
text-left text-center text-right text-uppercase text-primary text-mutedbg-primary bg-secondary bg-accent bg-light bg-darkborder border-top border-primary rounded-sm rounded-md rounded-lg rounded-pill rounded-circleshadow-none shadow-sm shadow shadow-md shadow-lg shadow-xlrelative absolute fixed sticky overflow-hidden overflow-auto overflow-scrollvisible invisible opacity-0 opacity-25 opacity-50 opacity-75 opacity-100cursor-pointer cursor-help cursor-wait cursor-not-allowedtransition transition-fast transition-slow hover-shadow hover-grow hover-primary hover-accentsr-only visually-hidden focus-ringno-print print-onlyReusable motion is configured in design/animations.php. View-triggered examples begin only when they enter the viewport and can be replayed for testing.
data-monarch-animation="fade-up" data-monarch-trigger="view"data-monarch-animation="pop" data-monarch-trigger="view"animate-spinner animate-skeleton hover-lift hover-grow hover-shadowThe identifier styles originally demonstrated in Lists are now reusable utility classes for any module.
<span class="label label-primary">Primary</span>Debugging tools, code conventions, and version information for maintaining Monarch.
debug debug-carddebug-griddebug-flex debug-spacingSee /docs/CSS-STANDARDS.md and /docs/PHP-STANDARDS.md for naming, comments, indentation, and module responsibilities.
v0.8.3.8.4
Monarch Design System — DESIGN SYSTEM EDITION — Page Composition.
Live examples, variants, and source locations for the shared website patterns.
Hero default
The canonical responsive Hero system.
Hero minimal
The canonical responsive Hero system.
Hero left
The canonical responsive Hero system.
Pattern
A simple title region for interior, legal, search, and documentation pages.
patterns/page-header.phppatterns/feature-grid.phppatterns/cta-banner.phppatterns/statistics.phppatterns/team-grid.phppatterns/timeline.phppatterns/contact-panel.phppatterns/faq-list.phppatterns/split-content.phppatterns/article-list.phppatterns/site-header.phppatterns/site-footer.phppatterns/section.phpFive canonical page archetypes, documented with purpose and live source.
Template
Campaign and marketing pages
templates/landing.phpTemplate
Focused reading and simple content
templates/one-column.phpTemplate
Main content with supporting rail
templates/two-column.phpTemplate
Editorial and long-form content
templates/article.phpTemplate
Technical reference and guides
templates/documentation.phpPrimary
Uses semantic Monarch tokens only; no hard-coded presentation colors.
Secondary
Uses semantic Monarch tokens only; no hard-coded presentation colors.
Accent
Uses semantic Monarch tokens only; no hard-coded presentation colors.
Meaning-driven colors remain consistent across every brand theme.
Success status treatment
Information status treatment
Warning status treatment
Danger status treatment
Pending status treatment
Neutral status treatment
All Universal Website sample pages are listed from the centralized sample-page inventory.