π See live on matcha.mizu.sh !
matcha.css is a pure CSS library designed to style HTML elements similarly to a default browser stylesheet, eliminating the need for users to manually patch their documents.
Ideal for fast prototyping, static HTML pages, Markdown-generated documents, and developers seeking to streamline their workflow without delving into CSS intricacies and want to make use of the full range of available HTML elements.
- β No build steps
- β No dependencies
- β No JavaScript
- β No configuration needed
- β No refactoring required
- β
~6kB
gzipped (can be further reduced)
![](https://raw.githubusercontent.com/richardsonjf/lowlighter-matcha/main/.github/demo-light-a.png)
![](https://raw.githubusercontent.com/richardsonjf/lowlighter-matcha/main/.github/demo-light-b.png)
![](https://raw.githubusercontent.com/richardsonjf/lowlighter-matcha/main/.github/demo-light-c.png)
![](https://raw.githubusercontent.com/richardsonjf/lowlighter-matcha/main/.github/demo-light-d.png)
Works seamlessly with any document and covers a broader range of HTML elements compared to similar libraries. It remains unobtrusive by leveraging CSS pseudo-elements and offers extensive browser support.
Simply include its <link rel="stylesheet">
to get started, and remove it whenever necessary without the need for document refactoring or cleanup.
Adapts styling based on elements hierarchy, providing intuitive behaviors such as "implicit submenus" when nesting <menu>
elements, required field indicator (*
) when a <label>
is paired with
<input required>
, etc.
Brew your own build using our custom builder to select specific features and reduce the final build size according to your project's needs.
Released under the MIT License, freely available at github.com/lowlighter/matcha.
To utilize matcha.css, just include the following line in the <head>
section of your document. It's that simple!
<link rel="stylesheet" href="https://matcha.mizu.sh/matcha.css">
This project is separated into three main directories:
/api
for serverless functions run on Vercel/app
for entry points, static assets, and build scripts/styles
for CSS source files
Each subdirectory within this folder is intended to be mostly self-contained and scoped. It helps to keep the codebase organized while also allows users to cherry-pick specific features and create custom builds.
Extra features should be prefixed using the character @
and should most likely be excluded by default in the builder to avoid bloating the default build.
When submitting a pull request, the preview will be available on Vercel. Maintainers and other contributors can review the changes and provide feedback before merging.
Local development is intended to be done using the deno runtime. If you do not wish to install it, you can also use the provided devcontainer configuration to run the project in a containerized environment or directly on GitHub Codespaces.
To start the development server, run the following command:
deno task serve
Before submitting your changes, ensure everything is correctly formatted by running the following command:
deno task fmt
MIT License
Copyright (c) 2024-present Simon Lecoq (lowlighter)