sh20raj2 / matcha

Home Page:https://matcha-coral.vercel.app

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

🍡 matcha.css

🌊 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)

πŸ“Έ Screenshot examples

πŸ₯’ Why choose matcha.css?

🍜 Agnostic

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.

πŸ₯ Reversible

Simply include its <link rel="stylesheet"> to get started, and remove it whenever necessary without the need for document refactoring or cleanup.

🍑 Semantic

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.

🍱 Customizable

Brew your own build using our custom builder to select specific features and reduce the final build size according to your project's needs.

🍘 Open-source

Released under the MIT License, freely available at github.com/lowlighter/matcha.

πŸ“– Usage

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">

🫰 Contributing

πŸ“‚ Project structure

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

🎨 About /styles directory

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.

πŸ§‘β€πŸ’» Development lifecycle

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

πŸ“œ License

MIT License
Copyright (c) 2024-present Simon Lecoq (lowlighter)

About

https://matcha-coral.vercel.app

License:MIT License


Languages

Language:HTML 67.2%Language:CSS 24.9%Language:TypeScript 7.7%Language:Dockerfile 0.2%