On this page
Release states
Master CSS is currently in the Beta stage and is progressing toward the RC release.
-
Alpha οΌ 2.0.0-alpha.80 - Beta οΌ 2.0.0-beta.204
- Release Candidate οΌ 2.0.0-rc.1
- Stable οΌ 2.0.0
Beta ( Current )
This phase will encompass completing all core features and breaking changes, providing a solid foundation for v2.
π Core documentation
With over 200 documents in Master CSS 2.0, we've organized relevant documents affecting core functions as prerequisites for the stable release.
Finalizing these documents allows us to verify the rationality, ease of use, and scalability of core features for further improvement.
Getting Started | |
---|---|
π’Code Linting | An official ESLint plugin for enforcing team coding styles, making your template markup more organized, and catching syntax errors early. |
π’Genernal Installation | The easiest way to use Master CSS from scratch is to initialize the runtime engine directly in the application's entry file. |
π’Installation | Master CSS is a markup-driven CSS language with smart rules allowing you to write familiar CSS using concise syntax within HTML. |
Comparing the rendering modes, syntax differences, advantages in usage and functional positioning of mainstream frameworks. | |
π§Language Service | Enhanced Master CSS development experience, including syntax highlighting, code completion, syntax rule preview, and more. |
π’Language Service for Visual Studio Code | Language Service APIs for major IDE extensions. |
π§Migration | Easily migrate CSS technologies and projects you are currently using to the Master CSS. |
π’Using CDNs | Copy and paste CDNs to instantly launch the runtime engine in your browser out of the box. |
Installation | |
π’Progressive Rendering in Angular | Guide to setting up Master CSS progressive rendering in your Angular project. |
π’Progressive Rendering in Next.js | Guide to setting up Master CSS progressive rendering in your Next.js project. |
π’Progressive Rendering in Nuxt.js | Guide to setting up Master CSS progressive rendering in your Nuxt.js project. |
π’Progressive Rendering in React | Guide to setting up Master CSS progressive rendering in your React project. |
π’Progressive Rendering in Svelte | Guide to setting up Master CSS progressive rendering in your Svelte project. |
π’Progressive Rendering in Vue.js | Guide to setting up Master CSS progressive rendering in your Vue.js project. |
π’Runtime Rendering in Angular | Guide to setting up Master CSS runtime rendering in your Angular project. |
π’Runtime Rendering in Astro | Guide to setting up Master CSS runtime rendering in your Astro project. |
π’Runtime Rendering in Blazor | Guide to setting up Master CSS runtime rendering in your Blazor project. |
π’Runtime Rendering in Laravel | Guide to setting up Master CSS runtime rendering in your Laravel project. |
π’Runtime Rendering in Next.js | Guide to setting up Master CSS runtime rendering in your Next.js project. |
π’Runtime Rendering in Nuxt.js | Guide to setting up Master CSS runtime rendering in your Nuxt.js project. |
π’Runtime Rendering in React | Guide to setting up Master CSS runtime rendering in your React project. |
π’Runtime Rendering in Svelte | Guide to setting up Master CSS runtime rendering in your Svelte project. |
π’Runtime Rendering in Vite | Guide to setting up Master CSS runtime rendering in your Vite project. |
π’Runtime Rendering in Vue.js | Guide to setting up Master CSS runtime rendering in your Vue.js project. |
π’Runtime Rendering in Webpack | Guide to setting up Master CSS runtime rendering in your Webpack project. |
π’Runtime with esm.sh CDN | Paste the esm.sh CDN to instantly launch the Master CSS runtime engine. |
π’Static Extraction in Angular | Guide to setting up Master CSS static extraction in your Angular project. |
π’Static Extraction in Astro | Guide to setting up Master CSS static extraction in your Astro project. |
π’Static Extraction in Blazor | Guide to setting up Master CSS static extraction in your Blazor project. |
π’Static Extraction in Laravel | Guide to setting up Master CSS static extraction in your Laravel project. |
π’Static Extraction in Next.js | Guide to setting up Master CSS static extraction in your Next.js project. |
π’Static Extraction in Nuxt.js | Guide to setting up Master CSS static extraction in your Nuxt.js project. |
π’Static Extraction in React | Guide to setting up Master CSS static extraction in your React project. |
π’Static Extraction in Svelte | Guide to setting up Master CSS static extraction in your Svelte project. |
π’Static Extraction in Vite | Guide to setting up Master CSS static extraction in your Vite project. |
π’Static Extraction in Vue.js | Guide to setting up Master CSS static extraction in your Vue.js project. |
π’Static Extraction in Webpack | Guide to setting up Master CSS static extraction in your Webpack project. |
Core Syntax | |
Apply styles based on theme, print, and other modes and queries. | |
π§State Selectors | Apply styles based on user interactions, element states, and other states. |
π’Style Declarations | Master CSS covers all native CSS features with a structured syntax and simplifies CSS with smart rules. |
Fundamentals | |
Creating design tokens for consistent-looking user interfaces. | |
Implement styles with more flexibility, using dynamic variables. | |
π’Markup-driven | Master CSS styles are driven by template markups and generate CSS rules on demand. |
π’Global Styles | Normalize browser and preset global styles for more concise-style programming. |
π’Rendering Modes | Master CSS provides three rendering modes, which you can choose according to project scale and application scenarios to meet your current business requirements. |
π’Responsive Design | Adapt your user interface to different devices with flexible responsive syntax. |
This guide helps develop concepts for code reuse and de-duplication techniques. | |
Use design tokens to switch between different theme modes. | |
π’Browser Support | The core engine of Master CSS hardly affects CSS support for browsers. |
Production Optimization | |
π’Unstyled Content | Improve the page loading experience and ensure seamless rendering of content. |
Speed up initial page loads by lazy loading the runtime engine. | |
Render pages early to improve user experience and SEO. | |
π’Critical Resources | The runtime engine plays a crucial role in the initial display of a page. |
Customization | |
Enhanced Service | |
π§Class Variant | Create reusable, extensible, and customizable style class variants. |
π§Theme Service | Standard CSS theme switching and service for Master CSS. |
API Reference | |
π’Core | The core syntax parsing and runtime engine of Master CSS. |
π’ESLint | The ESLint configuration and plugin reference for Master CSS. |
π§Extractor | Master CSS static extractor for various raw text extraction. |
π§Renderer | Pre-render CSS on demand based on HTML. |
π§Validator | Validator for Master CSS syntactic class. |
π’ Completedπ§ UnfinishedβͺοΈ Planning
π Color palette
See the issue #171.
Humans perceive different lightness for different color shades in the current color palette, which can lead to visual inconsistencies in the UI.
We'll refactor on a visually consistent general palette based on intuition.
It's expected to be the final breaking change during the beta stage.
π Other APIs
We may check whether each property, parameter, and external API needs to be improved when writing configuration-related documents.
This work is critical to the popularity of third-party plugin authoring for Master CSS, and breaking configuration changes will not be made in the future unless necessary.
Release Candidate
At this stage, Master CSS is stable, which means there will be no further breaking changes. We'll refine the documentation and complete tasks for the upcoming v2.
π Syntax documentation
Initially, the v1 docs were rushed into release, making its content rather rudimentary and potentially challenging to comprehend.
Our goal for our upcoming v2 docs is to present a comprehensive and elegantly crafted syntax document. This enables developers to grasp the intricacies of CSS effortlessly, thus enhancing CSS understanding through our meticulous documentation.
At the same time, we hope to get in touch with actual examples by writing syntax-related documents to obtain new improvements, such as simplifying syntax, adding utilities, etc.
Accessibility | |
---|---|
π§Screen Readers | Style utility for imporving the accessibility with screen readers. |
Animation | |
π’Animation | Style syntax for applying an animation between styles. |
π§Animation Delay | Style syntax for setting a time to delay before beginning to perform the animation. |
π’Animation Direction | Style syntax for setting the direction of the animation. |
π§Animation Duration | Style syntax for setting the length of time that an animation takes to complete one cycle. |
π§Animation Fill Mode | Style syntax for setting how a CSS animation applies styles to its target before and after its execution. |
π’Animation Iteration Count | Style syntax for setting the number of times an animation should be played. |
π§Animation Name | Style syntax for setting the names of the animation. |
π’Animation Play State | Style syntax for setting whether an animation is running or paused. |
π§Animation Timing Function | Style syntax for setting speed curve of the animation. |
Appearance | |
π§Accent Color | Style syntax for setting the accent color of user interface elements or controls. |
π§Appearance | Style syntax for controlling the native appearance of UI controls. |
π§Caret Color | Style syntax for setting the color of the cursor in text input. |
π§Color | Style syntax for setting foreground color of an element. |
π§Cursor | Style syntax for setting the mouse cursor style. |
Background | |
π§Background | Style syntax for setting all background style properties at once. |
π§Background Attachment | Style syntax for setting whether position of background image is fixed when scrolling. |
π§Background Blend Mode | Style syntax for setting how an element's background images should blend with the background color. |
π§Background Clip | Style syntax for controlling how clip the background. |
π§Background Color | Style syntax for setting the background color of an element. |
π§Background Image | Style syntax for setting background images on an element. |
π§Background Origin | Style syntax for setting the background's origin. |
π§Background Position | Style syntax for setting the initial position for background image. |
π§Background Repeat | Style syntax for setting how background images are repeated. |
π§Background Size | Style syntax for setting the size of the background image. |
Border | |
π§Border | Style syntax for setting an elementβs border. |
π§Border Color | Style syntax for setting the color of an elementβs border. |
π§Border Radius | Style syntax for setting radius of an elementβs corners. |
π§Border Style | Style syntax for setting the line style for an elementβs border. |
π§Border Width | Style syntax for setting the width of an elementβs border. |
Effect | |
π§Backdrop Filter | Style syntax for applying filter effects to the area behind an target element. |
π§Box Shadow | Style syntax for adding shadow effects around an element. |
π§Filter | Style syntax for applying graphic effects to an element. |
π§Mask Image | Style syntax for setting the image that is used as mask layer for an element. |
π§Mix Blend Mode | Style syntax for setting how an element's content should blend with its parent background. |
Flex | |
π§Flex | Style syntax for setting how flex items grow or shrink. |
π§Flex Basis | Style syntax for setting the initial main size of a flex item. |
π§Flex Direction | Style syntax for setting the direction of flex items. |
π§Flex Grow | Style syntax for setting how flex items grow. |
π§Flex Shrink | Style syntax for setting how flex items shrink. |
π§Flex Wrap | Style syntax for setting how flex items wrap. |
Font | |
π§Font | Style syntax for setting font properties of an element. |
π’Font Family | Style syntax for setting the font for an element. |
π§Font Feature Settings | Style syntax for controling advanced typographic features in OpenType fonts. |
π§Font Size | Style syntax for setting the font size of elements. |
π§Font Smoothing | Style syntax for controlling the font smoothing of an element. |
π§Font Style | Style syntax for setting font style of an element. |
π§Font Variant Numeric | Style syntax for controlling the usage of alternate glyphs for numbers, fractions, and ordinal markers. |
π§Font Weight | Style syntax for setting the weight of the font. |
Grid | |
π§Grid | Style syntax for setting layout of grid system. |
π§Grid Auto Columns | Style syntax for setting the size of the grid columns. |
π§Grid Auto Flow | Style syntax for controlling how auto-placed items get inserted in the grid. |
π§Grid Auto Rows | Style syntax for setting the size of the grid rows. |
π§Grid Column | Style syntax for setting a grid items's size and location in a grid layout. |
π§Grid Columns | Style utility for creating multiple grid columns. |
π§Grid Row | Style syntax for setting a grid items's size and location in a grid layout. |
π§Grid Rows | Style utility for creating multiple grid rows. |
π§Grid Template | Style syntax for setting grid columns, grid rows, and grid areas. |
π§Grid Template Areas | Style syntax for setting areas in the grid container |
π§Grid Template Columns | Style syntax for creating columns in a grid layout. |
π§Grid Template Rows | Style syntax for creating rows in a grid layout. |
Grid And Flexbox | |
π§Align Content | Style syntax for controlling how multiple rows or columns are aligned along its cross axis. |
π§Align Items | Style syntax for controlling how items are aligned along its cross axis. |
π§Align Self | Style syntax for controlling how an individual item is aligned along its cross axis. |
π§Gap | Style syntax for setting the gutters between rows and columns. |
π§Justify Content | Style syntax for controlling how items are aligned along its main axis. |
π§Justify Items | Style syntax for controlling how items are aligned along its inline axis. |
π§Justify Self | Style syntax for controlling how an individual item is aligned along its inline axis. |
π§Order | Style syntax for changing the order of item in flex or grid container. |
π§Place Content | Style syntax for setting align-content and justify-content at the same time. |
π§Place Items | Style syntax for setting align-items and justify-items at the same time. |
π§Place Self | Style syntax for setting align-self and justify-self at the same time. |
Interactivity | |
π§Pointer Events | Style syntax for setting whether an element reacts to pointer events. |
π§Resize | Style syntax for setting whether an element is resizable. |
π§Touch Action | Style syntax for setting how an element's region can be manipulated by a touchscreen user. |
π§User Drag | Style syntax for controlling whether the user can drag element. |
π§User Select | Style syntax for controlling whether the user can select text. |
Layout | |
π§Box Decoration Break | Style syntax for setting how an element's fragments should be rendered when broken across multiple lines, columns, or pages. |
π§Break After | Style syntax for controlling how page, column, or region breaks should occur after an element. |
π§Break Before | Style syntax for controlling how page, column, or region breaks should occur before the specified element. |
π§Break Inside | Style syntax for controlling how page, column, or region breaks should occur within the specified element. |
π§Clear | Style syntax for moving an element below floating elements instead of floating to the left or right. |
π§Column Span | Style syntax for setting how elements span across multiple columns. |
π§Columns | Style syntax for setting the number of columns within the container. |
π§Direction | Style syntax for setting the direction of text. |
π§Display | Style syntax for controlling the element's inner and outer display types. |
π’Float | Style syntax for placing an element on the left or right side of its container. |
π§Inset | Style syntax for setting distance between an element and the parent element. |
π§Isolation | Style syntax for controlling whether an element should create a new stacking context. |
π§Overflow | Style syntax for controlling the desired behavior for an element's overflow. |
π§Position | Style syntax for setting an element is positioned in a document. |
π§Z Index | Style syntax for set the z-order of a positioned element. |
List Style | |
π§List Style | Style syntax for setting all the list style properties at once. |
π§List Style Image | Style syntax for replacing the list item marker with an image. |
π§List Style Position | Style syntax for setting the position of the list item marker. |
π§List Style Type | Style syntax for setting the style of the list item marker. |
Media | |
π§Object Fit | Style syntax for setting how the content should be resized to fit its container. |
π§Object Position | Style syntax for setting the alignment of the selected replaced element within the element's box. |
Outline | |
π§Outline | Style syntax for setting all the outline properties at once. |
π§Outline Color | Style syntax for setting the color of an elementβs outline. |
π§Outline Offset | Style syntax for setting the spacing between an outline and the border of an element. |
π§Outline Style | Style syntax for setting the style of an element's outline. |
π§Outline Width | Style syntax for setting the thickness of an element's outline. |
Performance | |
π§Contain | Style syntax for providing performance benefits by limiting calculations of layout. |
π§Will Change | Style syntax for setting how an element is expected to change in the browser. |
Scroll | |
π§Overscroll Behavior | Style syntax for setting what a browser does when reaching the boundary of a scrolling area. |
π§Scroll Behavior | Style syntax for setting the scrolling behavior for a scrolling box. |
π§Scroll Margin | Style syntax for setting the scroll margin of an element. |
π§Scroll Padding | Style syntax for setting the scroll padding of an element. |
π§Scroll Snap Align | Style syntax for setting the scroll snap position. |
π§Scroll Snap Stop | Style syntax for setting whether scroll container is pass over snap positions. |
π§Scroll Snap Type | Style syntax for setting how strictly snap points are enforced on the scroll container. |
Shape | |
π§Clip Path | Style syntax for creating a clipping region. |
π§Shape Image Threshold | Style syntax for setting the alpha channel threshold for a CSS shape. |
π§Shape Margin | Style syntax for setting a margin for a CSS shape. |
π§Shape Outside | Style syntax for setting a shape around which adjacent inline content should wrap. |
Sizing | |
π§Aspect Ratio | Style syntax for setting the ratio for the box. |
π§Box Sizing | Style syntax for setting how the total width and height of an element is calculated. |
π§Height | Style syntax for setting an elementβs height. |
π§Max Height | Style syntax for setting the maximum height of an element. |
π§Max Width | Style syntax for setting the maximum width of an element. |
π§Min Height | Style syntax for setting the minimum height of an element. |
π§Min Width | Style syntax for setting the minimum width of an element. |
π§Width | Style syntax for setting an elementβs width. |
Spacing | |
π§Margin | Style syntax for setting the margin area on all four sides of an element. |
π§Padding | Style syntax for setting the padding area on all four sides of an element. |
Svg | |
π§Stroke | Style syntax for setting the outline color of an SVG shape. |
π§Stroke Width | Style syntax for setting the width of the stroke to be applied to the SVG shape. |
Tables | |
π§Border Collapse | Style syntax for setting whether table cell have shared or separate borders. |
Text | |
π§Text Align | Style syntax for setting the text alignment of an element. |
π§Text Decoration | Style syntax for setting the appearance of decorative lines on text. |
π§Text Decoration Color | Style syntax for setting the color of decorative lines on text. |
π§Text Decoration Line | Style syntax for setting the kind of decoration that is used on text. |
π§Text Decoration Style | Style syntax for setting the style of the decoration line that is used on text. |
π§Text Decoration Thickness | Style syntax for setting thickness of the decoration line. |
π§Text Fill Color | Style syntax for setting the color of text. |
π§Text Indent | Style syntax for setting indentation of the first line. |
π§Text Orientation | Style syntax for setting orientation of the text characters in a line. |
π§Text Overflow | Style syntax for handling how hidden overflow content. |
π§Text Rendering | Style syntax for setting what to optimize when rendering text. |
π§Text Shadow | Style syntax for adding shadows to text. |
π§Text Size | Style utility for setting the font size with a golden-ratio line height. |
π§Text Stroke | Style syntax for setting the width and color of strokes for text characters. |
π§Text Stroke Color | Style syntax for setting the color of the stroke for text characters. |
π§Text Stroke Width | Style syntax for setting the width of the stroke for text characters. |
π’Text Transform | Style syntax for controlling capitalization of text. |
π§Text Underline Offset | Style syntax for setting the distance of a text decoration line from its original position. |
Transform | |
π§Transform | Style syntax for controlling rotate, scale, skew, or translate an element. |
π§Transform Box | Style syntax for defining the layout box to which transform and transform-origin properties relate. |
π§Transform Origin | Style syntax for setting the origin for an elementβs transformations. |
π§Transform Style | Style syntax for setting how children of an element are rendered in the 3D space. |
Transition | |
π§Transition | Style syntax for controlling animation speed when changing CSS properties. |
π§Transition Delay | Style syntax for setting a time to delay before starting transition. |
π§Transition Duration | Style syntax for setting the length of time a transition should takes to complete. |
π§Transition Property | Style syntax for setting the CSS properties to which a transition effect should be applied. |
π§Transition Timing Function | Style syntax for setting speed curve of the transition effect. |
Typography | |
π§Content | Style syntax for replacing an element with a generated value. |
π§Letter Spacing | Style syntax for setting the spacing between text characters. |
π§Line Clamp | Style syntax for limiting the contents of a container to the specified number of lines. |
π§Line Height | Style syntax for setting the height of a line box. |
π§Vertical Align | Style syntax for setting vertical alignment. |
π§White Space | Style syntax for controlling how whitespace and line breaks within an element are handled. |
π§Word Break | Style syntax for setting whether words should break. |
π§Word Spacing | Style syntax for setting the spacing between words. |
π§Writing Mode | Style syntax for setting different writing mode. |
Variable | |
π§Variable | CSS variables defined specific values to be reused throughout a document. |
Visibility | |
π§Opacity | Style syntax for setting the opacity of an element. |
π§Visibility | Style syntax for controlling whether an element is visible. |
π’ Completedπ§ UnfinishedβͺοΈ Planning
βͺοΈ Master CSS Language Service
π§ The detailed content is under planning.
π’ Master CSS ESLint
Released in v2.0.0-beta.175. Check out the new documentation.
It now implements a partial feature, with the rest scheduled for batch release after the v2 is launched.
βͺοΈ Homepage redesign
Redesign the homepage according to the features of v2.
FAQs
When is v2 expected to arrive?
Throughout the Beta phase, Master CSS v2.0 introduced many essential functions, services, and framework compatibility enhancements. Many of these underwent refactoring as part of the development journey or were fine-tuned in response to valuable input from the community.
Since the syntax and API of Master CSS are expected to be in use for many years, even though v2 is nearing completion, it will take us some time to validate its market acceptance and solidify its foundation.
Now that we're at the end of beta, we can more accurately estimate arrival times based on the task at hand:
- Master CSS v2.0
- Release Candidate οΌ December 2023
- Stable οΌ February 2024
- Master UI v1.0
- Alpha οΌ April 2024
- Beta οΌ May 2024
- Release Candidate οΌ June 2024
- Stable οΌ August 2024
- Master UI Pro v1.0 οΌ December 2024
Is it stable enough for now?
Only one breaking change remains during the beta, Color Palette. If you don't mind or are not affected by it, you can start using Master CSS in production!
How to keep track of the latest updates?
- GitHub Releases οΌ We've beautified the release changelog, which notes any version and package detailed changes.
- Docs - Discord Channel οΌ We'll post the latest documentation updates in the #docs channel in the Master discord server.
How to prevent version change conflicts?
When using a CDN in production, pining the current version to avoid potential conflicts due to version changes is strongly recommended, like so:
<script src="https://cdn.master.co/[email protected]"></script>
Where is the source code of the documentation?
The official documentation is now open source; welcome to contribute your expertise.