[3.0.0] — 2026-09-28
AXIS V3 is a structural refactor focused on making the foundation more systematic, scalable and easier to adapt across real projects.
Added
- Sass architecture: Added the new
pages/layer, expanding the architecture from five to six layers:abstracts → base → layout → components → sections → pages. - Page isolation: Added
_home.scss,_error.scssand thepages/_index.scssexporter for route-specific styles. - HTML partials: Added
src/html/header.htmlandsrc/html/footer.htmlfor reusable markup fragments. - HTML injection: Added
vite-plugin-html-injectand<load src="...">support. - Multi-page readiness: Extended
vite.config.jswith Rollup entry-point configuration viarollupOptions.input. - Container tokens: Added the dedicated
abstracts/tokens/_container.scsspartial and separated container sizing from spacing. - PX → REM utility: Added the
rem()Sass function for converting unitless pixel values torem. - Animation layer: Added
base/_keyframes.scsswith reusablefade-in,slide-upandspinkeyframes. - Semantic token areas: Added dedicated semantic-token sections to applicable primitive token partials.
- Expanded motion scale: Added
600,800and1000duration tokens. - Expanded opacity scale: Added additional intermediate opacity tokens to provide a continuous range from
0to100. - Expanded radius scale: Added
none,2xland3xlradius tokens, including larger surface radii of 24px and 32px. - Expanded breakpoint map: Added
3xs,xxl,3xland4xlwhile extending the full responsive range. - Expanded container map: Added
xxland3xlcontainer sizes. - Yarn workflow: Added
yarn.lockand standardized project setup/build commands around Yarn.
Changed
- Sass architecture: Reorganized sections so
sections/contains only global/reusable blocks such as header and footer; page-specific rules now live underpages/. - Comment conventions: Standardized Sass and JavaScript comments around the
// ==block style. - Documentation structure: Removed secondary
README.mdfiles from implementation subdirectories and centralized project documentation at the repository root. - Token strategy: Unified the spacing scale around 2px/4px micro increments and 8px macro anchors.
- Typography scale: Replaced the previous Major Third-based typography scale with a dedicated stepped scale and renamed font-weight tokens to semantic names such as
regular,medium,semi-bold,boldandextra-bold. - Typography semantics: Moved base and heading semantic typography tokens into
abstracts/tokens/_typography.scss;base/_typography.scssnow consumes those tokens to set element styles. - Line-height and tracking: Added dedicated line-height and letter-spacing token scales.
- Units: Converted AXIS Sass values to
remwherever practical, including former pixel-based primitive values and component measurements. - Responsive mixins: Rewrote
respond()andrespond-up()to use CSS comparison syntax (width < valueandwidth >= value) instead of explicitmax-width/min-widthexpressions. - Semantic consumption: Adjusted components and project sections to consume semantic roles where appropriate instead of repeatedly mapping the same primitives in individual files.
- Base styles: Refined reset, global defaults and utility helpers for consistency with the V3 token system.
- Components: Updated Button, Card and Badge token usage and values to align with the revised scales and local semantic variables.
- JavaScript documentation: Cleaned
script.jsandglobal.jscomments and clarified the responsibilities ofbase/,components/andvendor/areas directly in code. - Package manager: Replaced the NPM-oriented workflow from V2 with Yarn-based dependency management in the project documentation and lockfile.
- Vite configuration: Reworked configuration comments in English and added HTML injection, multi-entry support and production asset output rules.
Removed
package-lock.json: Replaced by the trackedyarn.lockworkflow.- Subdirectory README files: Removed redundant README documentation from
src/,src/sass/andsrc/js/implementation folders. - Page-specific styles from
sections/: Route-specific rules are no longer expected in global sections. - Major Third font-size tokens: Removed the previous modular-ratio values from the primitive typography scale.
- Container sizes from spacing: Container constraints are now maintained in their own token partial.
- Old responsive query construction: The explicit
max-width/min-widthimplementation has been replaced by CSS range syntax.