Mastors-Gridder v1.2.0 Release Notes
🎉 Major Feature Release - January 2, 2026
🚀 Overview
We're thrilled to announce Mastors-Gridder v1.2.0, a massive update that nearly doubles the power of the library! This release adds 20 new mixins, bringing the total from 23 to 43 comprehensive grid utilities.
Version 1.2 introduces modern CSS features, enhanced control over grid behavior, and powerful new shortcuts that make building complex layouts faster and more intuitive than ever.
⭐ What's New
📊 By The Numbers
- +20 New Mixins - Nearly doubled the mixin library
- 43 Total Mixins - Comprehensive coverage of CSS Grid features
- 100% Backward Compatible - All v1.0 mixins work identically
- 4 New Categories - Better organization and discoverability
- Modern CSS Support - Container queries, intrinsic sizing, and more
🎯 Major Features
1. Core Grid Setup (4 New Mixins)
Simplified initialization and flow control for your grids.
grid-container - Quick Grid Setup
.wrapper {
@include grid-container(12, 1rem);
}
Perfect for rapid prototyping and standard layouts.
grid-auto-flow - Control Item Placement
.masonry {
@include grid-auto(250px);
@include grid-auto-flow(row, true); // Dense packing
}
Fill gaps intelligently with the dense packing algorithm.
grid-auto-rows & grid-auto-cols - Dynamic Sizing
.dynamic {
@include grid-auto(300px);
@include grid-auto-rows(150px); // All rows 150px
}
Control implicitly created tracks with precision.
2. Advanced Sizing Controls (7 New Mixins)
Fine-grained control over column and row sizing.
grid-minmax - Explicit Minmax Control
.cards {
@include grid-minmax(200px, 400px, auto-fit, 1rem);
}
More control than grid-auto with explicit min/max boundaries.
grid-fr - Fractional Unit Ratios
.layout {
@include grid-fr(2fr, 1fr, 1fr); // 2:1:1 ratio
}
Create precise proportional layouts.
grid-intrinsic - Content-Driven Sizing
.tags {
@include grid-intrinsic(auto-fit, max-content, 0.5rem);
}
Let content determine column sizes with min-content, max-content, or fit-content().
grid-explicit - Complete Grid Definition
.dashboard {
@include grid-explicit(200px 1fr 300px, auto 1fr auto, 1rem);
}
Set both columns and rows in a single, powerful mixin.
grid-fit-content - Flexible Boundaries
.nav {
@include grid-fit-content(200px, auto-fit, 1rem);
}
Columns grow with content but respect maximum width.
grid-repeat-pattern - Custom Patterns
.alternating {
@include grid-repeat-pattern(100px 200px, 3, 1rem);
// Results in: 100px 200px 100px 200px 100px 200px
}
Create alternating or complex column patterns.
grid-auto-track - Ultimate Flexibility
.flexible {
@include grid-auto-track(auto-fill, 200px, 300px, 1rem);
}
Combine auto-fit/fill with custom min/max for maximum control.
3. Modern Layout & Positioning (6 New Mixins)
Next-generation layout patterns and positioning utilities.
grid-layer - Overlay Elements
.hero { @include grid-container(1, 0);.background {
@include grid-layer; // Spans entire grid
}.overlay {
@include grid-layer;
background: rgba(0, 0, 0, 0.5);
}
.content {
@include grid-layer;
z-index: 2;
}
}
Perfect for hero sections, image overlays, and layered designs.
grid-full-width & grid-full-height - Instant Spanning
.header { @include grid-full-width; // Spans all columns }
.sidebar {
@include grid-full-height; // Spans all rows
}
Concise shortcuts for full-width/height elements.
grid-areas-responsive - Responsive Template Areas
.app {
@include grid-areas-responsive(
"header" "nav" "main" "footer",
"header header" "nav main" "footer footer",
1024px
);
}
Different grid structures for mobile and desktop in one mixin.
grid-container-aware - Container Query Support
.widget-container { container-type: inline-size;
.widgets {
@include grid-container-aware(250px, 1rem);
}
}
Components that respond to their container size, not the viewport.
grid-masonry-modern - Enhanced Masonry
.pinterest {
@include grid-masonry-modern(4, 40px, 1rem);
}
Improved masonry layouts with better gap handling and dense packing.
4. Enhanced Alignment (3 New Mixins)
More intuitive and powerful alignment utilities.
grid-place - Concise Centering
.hero {
@include grid-place(center);
min-height: 400px;
}
Shorthand for place-items - cleaner than ever.
grid-place-content - Content Distribution
.spaced {
@include grid-place-content(space-between);
}
Control how the grid content is distributed.
grid-content - Grid Content Alignment
.centered-grid {
@include grid-cols(3);
@include grid-content(center, center);
height: 100vh;
}
Align the entire grid block within its container.
💡 Real-World Use Cases
Hero Section with Layered Content
.hero { @include grid-container(1, 0); min-height: 600px;.background {
@include grid-layer;
background: url('hero.jpg') center/cover;
}.overlay {
@include grid-layer;
background: linear-gradient(rgba(0,0,0,0.4), rgba(0,0,0,0.6));
}
.content {
@include grid-layer;
@include grid-place(center);
color: white;
z-index: 2;
}
}
Advanced Product Grid
.products { @include grid-minmax(280px, 350px, auto-fit, 2rem); @include grid-auto-flow(row, true); // Dense packing @include grid-auto-rows(minmax(200px, auto));.featured {
@include grid-span(2, 2);
}
.sale {
@include grid-full-width;
}
}
Responsive App Layout
.app { @include grid-areas-responsive( "header" "nav" "main" "aside" "footer", "header header header" "nav main aside" "footer footer footer", 1024px ); min-height: 100vh;
.header { grid-area: header; }
.nav { grid-area: nav; }
.main { grid-area: main; }
.aside { grid-area: aside; }
.footer { grid-area: footer; }
}
Container-Responsive Widget
.card-container { container-type: inline-size; padding: 2rem;.cards {
@include grid-container-aware(250px, 1rem);.card { background: white; padding: 1rem; border-radius: 8px; }
}
}
🔄 Migration Guide
Upgrading from v1.0
Good news! Version 1.2 is 100% backward compatible. All existing mixins work identically with no breaking changes.
Step 1: Update the Library
npm update mastors-gridder
Or update your CDN link to:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/KEHEM-IT/Mastors-Gridder@v1.2.0/mastors-gridder.css" />
Step 2: Optionally Adopt New Features
You can gradually adopt new mixins where they improve your code:
Before (v1.0):
.item {
grid-column: 1 / -1;
}
After (v1.2 - Optional):
.item {
@include grid-full-width;
}
Before (v1.0):
.grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 400px));
gap: 1rem;
}
After (v1.2 - Simpler):
.grid {
@include grid-minmax(200px, 400px, auto-fit, 1rem);
}
📚 Documentation Updates
- Complete mixin reference - All 43 mixins documented with examples
- Quick reference tables - Easy lookup for all parameters
- Real-world examples - Practical use cases for every feature
- Updated best practices - New patterns and recommendations
- Expanded FAQ - Common questions about v1.2 features
- Browser support guide - Compatibility notes for modern CSS features
🌐 Browser Support
All v1.2 features are supported in modern browsers:
| Feature | Chrome | Firefox | Safari | Edge |
|---|---|---|---|---|
| Core Grid Mixins | 57+ | 52+ | 10.1+ | 16+ |
| Intrinsic Sizing | 57+ | 52+ | 10.1+ | 16+ |
| place-items/content | 59+ | 45+ | 11+ | 79+ |
| Container Queries | 105+ | 110+ | 16+ | 105+ |
| Subgrid | 117+ | 71+ | 16+ | 117+ |
Note: Container queries (grid-container-aware) require modern browsers. Use traditional media queries as fallback for older browsers.
🎓 Learning Path
New to Mastors-Gridder? Start here:
- Core Basics -
grid-auto,grid-cols,grid-center - Layout Patterns -
grid-sidebar,grid-holy-grail - Item Control -
grid-span,grid-full-width,grid-layer - Advanced Sizing -
grid-minmax,grid-fr,grid-intrinsic - Modern Features -
grid-container-aware,grid-areas-responsive
Upgrading from v1.0? Focus on these high-impact additions:
grid-full-width/grid-full-height- Cleaner spanninggrid-minmax- Better responsive controlgrid-place- Concise alignmentgrid-layer- Overlay elementsgrid-auto-flow- Dense packing
🛠️ Technical Improvements
- Optimized CSS Output - More efficient compiled CSS
- Better Parameter Validation - Clearer error messages
- Enhanced Type Safety - Improved SCSS type checking
- Performance Optimizations - Faster compilation times
- Reduced Bundle Size - More efficient code generation
🐛 Bug Fixes
- Fixed edge case in
grid-densewith odd-sized items - Improved
grid-subgridcompatibility with nested grids - Corrected
grid-holy-grailresponsive breakpoint behavior - Enhanced
grid-masonrygap calculations
🙏 Acknowledgments
Thank you to the community for feedback, suggestions, and bug reports that helped shape this release. Special thanks to all contributors and early testers of v1.2 features.
🔮 What's Next?
Looking ahead to future releases:
- v1.3 - Animation and transition utilities
- v1.4 - Grid debugging tools and helpers
- v1.5 - Accessibility enhancements
- v2.0 - Module system and custom configuration
📦 Installation
NPM
npm install mastors-gridder@1.2.0
CDN
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/KEHEM-IT/Mastors-Gridder@v1.2.0/mastors-gridder.css" />
Import in SCSS
@use "mastors-gridder/mastors-gridder" as *;
🔗 Resources
- Full Documentation: https://kehem-it.github.io/Mastors-Gridder/
- GitHub Repository: https://github.com/KEHEM-IT/Mastors-Gridder
- CSS Documentation: README-CSS.md
- Issue Tracker: GitHub Issues
💬 Feedback
We'd love to hear from you! Share your experience with v1.2:
- Found a bug? Open an issue
- Have a suggestion? Start a discussion
- Built something cool? Share it with the community!
📄 License
Free to use in personal and commercial projects.
Maintained by: KEHEM-IT
Version: 1.2.0
Release Date: January 2, 2026
Status: Stable
Summary
Mastors-Gridder v1.2.0 is our biggest release yet, bringing 20 powerful new mixins and modern CSS features that make building complex layouts easier than ever. With 100% backward compatibility and comprehensive documentation, upgrading is seamless.
Start using v1.2 today and experience the next generation of CSS Grid utilities! 🚀
# Mastors-Gridder v1.2.0 Release Notes🎉 Major Feature Release - January 2, 2026
🚀 Overview
We're thrilled to announce Mastors-Gridder v1.2.0, a massive update that nearly doubles the power of the library! This release adds 20 new mixins, bringing the total from 23 to 43 comprehensive grid utilities.
Version 1.2 introduces modern CSS features, enhanced control over grid behavior, and powerful new shortcuts that make building complex layouts faster and more intuitive than ever.
⭐ What's New
📊 By The Numbers
- +20 New Mixins - Nearly doubled the mixin library
- 43 Total Mixins - Comprehensive coverage of CSS Grid features
- 100% Backward Compatible - All v1.0 mixins work identically
- 4 New Categories - Better organization and discoverability
- Modern CSS Support - Container queries, intrinsic sizing, and more
🎯 Major Features
1. Core Grid Setup (4 New Mixins)
Simplified initialization and flow control for your grids.
grid-container - Quick Grid Setup
.wrapper {
@include grid-container(12, 1rem);
}Perfect for rapid prototyping and standard layouts.
grid-auto-flow - Control Item Placement
.masonry {
@include grid-auto(250px);
@include grid-auto-flow(row, true); // Dense packing
}Fill gaps intelligently with the dense packing algorithm.
grid-auto-rows & grid-auto-cols - Dynamic Sizing
.dynamic {
@include grid-auto(300px);
@include grid-auto-rows(150px); // All rows 150px
}Control implicitly created tracks with precision.
2. Advanced Sizing Controls (7 New Mixins)
Fine-grained control over column and row sizing.
grid-minmax - Explicit Minmax Control
.cards {
@include grid-minmax(200px, 400px, auto-fit, 1rem);
}More control than grid-auto with explicit min/max boundaries.
grid-fr - Fractional Unit Ratios
.layout {
@include grid-fr(2fr, 1fr, 1fr); // 2:1:1 ratio
}Create precise proportional layouts.
grid-intrinsic - Content-Driven Sizing
.tags {
@include grid-intrinsic(auto-fit, max-content, 0.5rem);
}Let content determine column sizes with min-content, max-content, or fit-content().
grid-explicit - Complete Grid Definition
.dashboard {
@include grid-explicit(200px 1fr 300px, auto 1fr auto, 1rem);
}Set both columns and rows in a single, powerful mixin.
grid-fit-content - Flexible Boundaries
.nav {
@include grid-fit-content(200px, auto-fit, 1rem);
}Columns grow with content but respect maximum width.
grid-repeat-pattern - Custom Patterns
.alternating {
@include grid-repeat-pattern(100px 200px, 3, 1rem);
// Results in: 100px 200px 100px 200px 100px 200px
}Create alternating or complex column patterns.
grid-auto-track - Ultimate Flexibility
.flexible {
@include grid-auto-track(auto-fill, 200px, 300px, 1rem);
}Combine auto-fit/fill with custom min/max for maximum control.
3. Modern Layout & Positioning (6 New Mixins)
Next-generation layout patterns and positioning utilities.
grid-layer - Overlay Elements
.hero {
@include grid-container(1, 0);
.background {
@include grid-layer; // Spans entire grid
}
.overlay {
@include grid-layer;
background: rgba(0, 0, 0, 0.5);
}
.content {
@include grid-layer;
z-index: 2;
}
}Perfect for hero sections, image overlays, and layered designs.
grid-full-width & grid-full-height - Instant Spanning
.header {
@include grid-full-width; // Spans all columns
}
.sidebar {
@include grid-full-height; // Spans all rows
}Concise shortcuts for full-width/height elements.
grid-areas-responsive - Responsive Template Areas
.app {
@include grid-areas-responsive(
"header" "nav" "main" "footer",
"header header" "nav main" "footer footer",
1024px
);
}Different grid structures for mobile and desktop in one mixin.
grid-container-aware - Container Query Support
.widget-container {
container-type: inline-size;
.widgets {
@include grid-container-aware(250px, 1rem);
}
}Components that respond to their container size, not the viewport.
grid-masonry-modern - Enhanced Masonry
.pinterest {
@include grid-masonry-modern(4, 40px, 1rem);
}Improved masonry layouts with better gap handling and dense packing.
4. Enhanced Alignment (3 New Mixins)
More intuitive and powerful alignment utilities.
grid-place - Concise Centering
.hero {
@include grid-place(center);
min-height: 400px;
}Shorthand for place-items - cleaner than ever.
grid-place-content - Content Distribution
.spaced {
@include grid-place-content(space-between);
}Control how the grid content is distributed.
grid-content - Grid Content Alignment
.centered-grid {
@include grid-cols(3);
@include grid-content(center, center);
height: 100vh;
}Align the entire grid block within its container.
💡 Real-World Use Cases
Hero Section with Layered Content
.hero {
@include grid-container(1, 0);
min-height: 600px;
.background {
@include grid-layer;
background: url('hero.jpg') center/cover;
}
.overlay {
@include grid-layer;
background: linear-gradient(rgba(0,0,0,0.4), rgba(0,0,0,0.6));
}
.content {
@include grid-layer;
@include grid-place(center);
color: white;
z-index: 2;
}
}Advanced Product Grid
.products {
@include grid-minmax(280px, 350px, auto-fit, 2rem);
@include grid-auto-flow(row, true); // Dense packing
@include grid-auto-rows(minmax(200px, auto));
.featured {
@include grid-span(2, 2);
}
.sale {
@include grid-full-width;
}
}Responsive App Layout
.app {
@include grid-areas-responsive(
"header" "nav" "main" "aside" "footer",
"header header header" "nav main aside" "footer footer footer",
1024px
);
min-height: 100vh;
.header { grid-area: header; }
.nav { grid-area: nav; }
.main { grid-area: main; }
.aside { grid-area: aside; }
.footer { grid-area: footer; }
}Container-Responsive Widget
.card-container {
container-type: inline-size;
padding: 2rem;
.cards {
@include grid-container-aware(250px, 1rem);
.card {
background: white;
padding: 1rem;
border-radius: 8px;
}
}
}🔄 Migration Guide
Upgrading from v1.0
Good news! Version 1.2 is 100% backward compatible. All existing mixins work identically with no breaking changes.
Step 1: Update the Library
npm update mastors-gridderOr update your CDN link to:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/KEHEM-IT/Mastors-Gridder@v1.2.0/mastors-gridder.css" />Step 2: Optionally Adopt New Features
You can gradually adopt new mixins where they improve your code:
Before (v1.0):
.item {
grid-column: 1 / -1;
}After (v1.2 - Optional):
.item {
@include grid-full-width;
}Before (v1.0):
.grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 400px));
gap: 1rem;
}After (v1.2 - Simpler):
.grid {
@include grid-minmax(200px, 400px, auto-fit, 1rem);
}📚 Documentation Updates
- Complete mixin reference - All 43 mixins documented with examples
- Quick reference tables - Easy lookup for all parameters
- Real-world examples - Practical use cases for every feature
- Updated best practices - New patterns and recommendations
- Expanded FAQ - Common questions about v1.2 features
- Browser support guide - Compatibility notes for modern CSS features
🌐 Browser Support
All v1.2 features are supported in modern browsers:
| Feature | Chrome | Firefox | Safari | Edge |
|---|---|---|---|---|
| Core Grid Mixins | 57+ | 52+ | 10.1+ | 16+ |
| Intrinsic Sizing | 57+ | 52+ | 10.1+ | 16+ |
| place-items/content | 59+ | 45+ | 11+ | 79+ |
| Container Queries | 105+ | 110+ | 16+ | 105+ |
| Subgrid | 117+ | 71+ | 16+ | 117+ |
Note: Container queries (grid-container-aware) require modern browsers. Use traditional media queries as fallback for older browsers.
🎓 Learning Path
New to Mastors-Gridder? Start here:
- Core Basics -
grid-auto,grid-cols,grid-center - Layout Patterns -
grid-sidebar,grid-holy-grail - Item Control -
grid-span,grid-full-width,grid-layer - Advanced Sizing -
grid-minmax,grid-fr,grid-intrinsic - Modern Features -
grid-container-aware,grid-areas-responsive
Upgrading from v1.0? Focus on these high-impact additions:
grid-full-width/grid-full-height- Cleaner spanninggrid-minmax- Better responsive controlgrid-place- Concise alignmentgrid-layer- Overlay elementsgrid-auto-flow- Dense packing
🛠️ Technical Improvements
- Optimized CSS Output - More efficient compiled CSS
- Better Parameter Validation - Clearer error messages
- Enhanced Type Safety - Improved SCSS type checking
- Performance Optimizations - Faster compilation times
- Reduced Bundle Size - More efficient code generation
🐛 Bug Fixes
- Fixed edge case in
grid-densewith odd-sized items - Improved
grid-subgridcompatibility with nested grids - Corrected
grid-holy-grailresponsive breakpoint behavior - Enhanced
grid-masonrygap calculations
🙏 Acknowledgments
Thank you to the community for feedback, suggestions, and bug reports that helped shape this release. Special thanks to all contributors and early testers of v1.2 features.
🔮 What's Next?
Looking ahead to future releases:
- v1.3 - Animation and transition utilities
- v1.4 - Grid debugging tools and helpers
- v1.5 - Accessibility enhancements
- v2.0 - Module system and custom configuration
📦 Installation
NPM
npm install mastors-gridder@1.2.0CDN
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/KEHEM-IT/Mastors-Gridder@v1.2.0/mastors-gridder.css" />Import in SCSS
@use "mastors-gridder/mastors-gridder" as *;🔗 Resources
- Full Documentation: https://kehem-it.github.io/Mastors-Gridder/
- GitHub Repository: https://github.com/KEHEM-IT/Mastors-Gridder
- CSS Documentation: [README-CSS.md](./README-CSS.md)
- Issue Tracker: [GitHub Issues](https://github.com/KEHEM-IT/Mastors-Gridder/issues)
💬 Feedback
We'd love to hear from you! Share your experience with v1.2:
- Found a bug? [Open an issue](https://github.com/KEHEM-IT/Mastors-Gridder/issues)
- Have a suggestion? [Start a discussion](https://github.com/KEHEM-IT/Mastors-Gridder/discussions)
- Built something cool? Share it with the community!
📄 License
Free to use in personal and commercial projects.
Maintained by: [KEHEM-IT](https://github.com/KEHEM-IT)
Version: 1.2.0
Release Date: January 2, 2026
Status: Stable
Summary
Mastors-Gridder v1.2.0 is our biggest release yet, bringing 20 powerful new mixins and modern CSS features that make building complex layouts easier than ever. With 100% backward compatibility and comprehensive documentation, upgrading is seamless.
Start using v1.2 today and experience the next generation of CSS Grid utilities! 🚀