Semantic structure
Use the documented Xshna classes with semantic HTML rather than replacing native elements unnecessarily.
Compose existing xsh- classes on the appropriate HTML element. Keep content order meaningful when CSS is disabled.
Patterns / Component reference
Hero and marketing
Large expressive headlines, call-to-action clusters and product layouts.
LIVE COMPONENT REFERENCE
Hero typography and call-to-action composition
Compose display typography, supporting copy, actions and badges using native markup; ensure appropriate heading order.
Actual Xshna CSSResponsive preview
Build with precision.
A complete frontend design system for ambitious products.
HTML · COPY AND USE
<section class="xsh-hero"><span class="xsh-badge xsh-badge-soft" data-xsh-intent="info">Xshna Version 1 Beta</span><h2 class="xsh-hero-title">Build with precision.</h2><p class="xsh-lead">A complete frontend design system for ambitious products.</p><div class="xsh-ref-flex"><a class="xsh-btn xsh-btn-primary" href="installation.html">Get started</a><a class="xsh-btn xsh-btn-outline" href="design-personalities.html">Explore themes</a></div></section>Overview
Use xsh-hero, xsh-hero-title, xsh-container and xsh-grid-auto to build unique branded homepages.
Live example
Interactive · Real frameworkA system for ambitious interfaces.
Responsive, adaptive, and designed for ordinary hosting.
Example markup
<section class="xsh-hero"><span class="xsh-badge xsh-badge-solid" data-xsh-intent="primary">Xshna 1.0</span><h2 class="xsh-hero-title">A system for ambitious interfaces.</h2><p class="xsh-lead xsh-mt-4">Responsive, adaptive, and designed for ordinary hosting.</p><div class="xsh-flex xsh-gap-3 xsh-mt-6"><button class="xsh-btn xsh-btn-primary">Start building</button><button class="xsh-btn xsh-btn-secondary">Read docs</button></div></section>Production guidance
Use restrained marketing visuals to protect performance and readability.
Customize this component through --xsh-* CSS tokens, data-xsh-* configuration attributes and documented xsh-* utilities. Use the optional JavaScript distribution only when an interactive behavior is needed.
Build with confidenceOpen interactive design playground →
Complete selector inventory
These selectors exist in the current distribution. An entry in this table does not imply that arbitrary modifier combinations are meaningful; use the examples above for the intended composition.
| Class | Purpose | Delivery |
|---|---|---|
.xsh-hero | Core component | CSS-only |
.xsh-hero-actions | Composable modifier / structure class | CSS-only |
.xsh-hero-title | Composable modifier / structure class | CSS-only |
Implementation details
Interactive behavior
Verify focus order, disabled behavior and descriptive labels for interactive patterns.
Load xshna.min.js only if the documented interaction needs it. Your application remains responsible for data, persistence and business rules.
Responsive and localization
Test narrow containers, long translations and user-defined text sizes.
Test 320px-wide viewports, container-constrained instances, keyboard zoom, longer translations and right-to-left text where relevant.
Theme and customization
Use --xsh-* CSS variables for theme values and data-xsh-design / data-xsh-density on the xsh-app root.
Prefer design tokens over hard-coded overrides so components remain coherent across personalities.
What to verify before shipping
- Confirm every documented class used by the feature exists in the release CSS.
- Navigate controls using Tab, Shift+Tab, Enter, Space and Escape where appropriate.
- Test with reduced motion, high contrast, 200% text zoom and a narrow mobile viewport.
- Verify disabled, loading, empty, error and long-content states where relevant.
- Check actual application behavior independently of the preview: these examples use illustrative data.