Make naked websites look great with matcha.css!
lowlighter 🦑

lowlighter 🦑 @lowlighter

About: プレゼント・デイ ■ プレゼント・タイム ■

Joined:
Oct 25, 2020

Make naked websites look great with matcha.css!

Publish Date: May 24 '24
892 84

Have you ever contemplated the bareness of starting from a "blank page" when beginning a new web project?

Blank page

index.html
Notice the lack of any styling or custom attributes.


<html>
  <body>
    <h1>Hello world!</h1>
    <p>
      This is my new project, and it's still under construction.
      Please be indulgent 😊
    </p>
    <p>
      Also, check out my work on <a href="https://github.com/octocat">GitHub</a>!
    </p>
    <blockquote>
      <p>
        Imagination is more important than knowledge
      </p>
      <cite>Albert Einstein</cite>
    </blockquote>
    <menu>
      <li>Home</li>
      <li>
        About me
        <menu>
          <li>My works</li>
          <li>My passions</li>
        </menu>
      </li>
      <li>Contact</li>
    </menu>
    <form>
      <h2>Contact me</h2>
      <label>
        Your email:
        <input type="email" name="email" placeholder="Your email" required>
      </label>
      <label>
        Your message:
        <small>255 characters max</small>
        <textarea name="message" placeholder="Your message" required></textarea>
      </label>
      <button type="submit">Send</button>
    </form>
  </body>
</html>


Enter fullscreen mode Exit fullscreen mode

Ouch! If you showed that to your friends while claiming you're a web developer, they would start questioning what you're really doing...

Default browser stylesheets are usually pretty bare-bones, and it can be frustrating to not have something "visually nice" when you're prototyping apps, generating static HTML pages, Markdown-generated documents, etc., and don't want to delve into CSS intricacies too early.

Good news! I have something perfect for you: matcha.css!

Just add the following into your document and see the magic happen:



<link rel="stylesheet" href="https://matcha.mizu.sh/matcha.css">


Enter fullscreen mode Exit fullscreen mode

Matcha page

Without really doing anything, we got a page that respects user preferences on light/dark mode, nice fonts and proper spacing, our <menu> actually looks like a menu, and our <form> is also pretty nice with even "mandatory field" indicators for required inputs.

All of that without any build steps, JavaScript, configuration, or refactoring.

It's because matcha.css uses semantic styling. For example, it assumes that <menu> nested in another <menu> should result in a submenu, while a <label><input required></label> should clarify to the user that the input is mandatory.

There are a few more "drop-in" CSS libraries out there, but I believe this is the most complete one as it provides additional modern styles out-of-the-box like syntax highlighting, simple layouts, utility classes, etc.

Matcha

matcha.css is also easily customizable (it does not have any !important rules, and even provide a helper to create custom builds) and while being also reversible (if you ever decide to migrate out, just remove the stylesheet).

And last but not least, it's totally free and open-source!

GitHub logo lowlighter / matcha

🍵 Drop-in semantic styling library in pure CSS. Highly customizable and perfect for simple websites and prototyping web apps!

Checkout matcha.mizu.sh for a full overview!

Comments 84 total

  • Anmol Baranwal
    Anmol BaranwalMay 24, 2024

    I never thought I would find you here (haha). The profile picture is the same as on GitHub. I'm a big fan of your metrics repo.

    Great post, by the way. It's efficient and works well.

    • lowlighter 🦑
      lowlighter 🦑May 24, 2024

      Thanks a lot !

      Yeah I've not been very active on the metrics repo recently, but I'm actually planning to go back with new ideas and in a way that'll make it more maintenable in the future too !

  • Chris Newton
    Chris NewtonMay 24, 2024

    This is exactly what I have been looking for! Thanks for the share!

  • Paulo Henrique
    Paulo HenriqueMay 24, 2024

    you had me at "Without really doing anything,"

  • Isaac Klutse
    Isaac KlutseMay 24, 2024

    Thanks for sharing. This is going to bring joy to beginner programmers. At least you will get something beautiful to see before you start writing css.

    • lowlighter 🦑
      lowlighter 🦑May 24, 2024

      I hope so !

      And when programmers want to dwelve more into CSS and design, they can just remove the matcha.css stylesheet for a smooth migration without having to refactor their code that much !

  • Nguyễn Văn Trình
    Nguyễn Văn TrìnhMay 24, 2024

    Thanks for sharing

  • a.infosecflavour
    a.infosecflavourMay 24, 2024

    That's so cool!

  • Oscar
    OscarMay 24, 2024

    This is SO amazing for beginners or anyone who just wants to see a pretty site without having to learn CSS.

  • Otomatyk
    OtomatykMay 24, 2024

    Hi! Your library seams nice and better than PicoCSS

    Salut depuis l'Île de France par ailleurs 😉

  • Adzy
    AdzyMay 24, 2024

    This is quite impressive; it's definitely going to be added to my favorites bar.

  • Leonardo Rafael Wehrmeister
    Leonardo Rafael WehrmeisterMay 24, 2024

    I really like the semantic HTML + class-light/classless approach. There are others libs too, like Beer CSS.

    • Manuel Tancoigne
      Manuel TancoigneJun 7, 2024

      I mostly use Water.css (I even have a bookmarklet to apply it to naked websites), but I'll definitively take a look at Matcha.

  • Teles
    TelesMay 24, 2024

    So nice! It would be awesome to be easily able to use matcha as page theme for GitHub Pages rendering README.md files just like these ones pages.github.com/themes/

    • lowlighter 🦑
      lowlighter 🦑May 24, 2024

      Thanks !
      I wonder if GitHub pages actually accept new themes, I may look into it !

  • logarithmicspirals
    logarithmicspiralsMay 24, 2024

    This is awesome! I'll have to try this out on a project soon.

    • Holly
      HollyMay 28, 2024

      Anyone looking for a job.I need STAFF to package MAKEUP from your home, good Salary This job is for USA only ! thank you, Here are all details.

  • Khalil Greene
    Khalil GreeneMay 24, 2024

    Thanks for this. Simple and effective.

  • АнонимMay 24, 2024

    [deleted]

    • André Mantas
      André MantasMay 29, 2024

      had to login just to say how chatgpt generated this looks.

      • Jocom Vag
        Jocom VagMay 30, 2024

        no kidding, we need a new emoicton/reaction to flag this stuff (yes i know there's reporting but i require MOAR SARCASM)

  • Ricardo Esteves
    Ricardo EstevesMay 24, 2024

    nice, this looks good!!

  • hudy9x
    hudy9xMay 25, 2024

    Thanks for sharing your awesome works. Love something simple but work

  • Satabda Mandal
    Satabda MandalMay 25, 2024

    Haven't gone through the documentation but can anyone explain how it is beneficial than bootstrap or other css framework?? Is matcha.css compatible with single page framework or libraries like react or angular??

    • lowlighter 🦑
      lowlighter 🦑May 27, 2024

      It's supposed to be a "drop-in" stylesheet and not a framework, meaning you're not expected to change your HTML document structure in any way (like adding adding classes, wrapper div, etc.).

      See it really like switching from the default browser stylesheet to a more "stylised" one.
      It still has some additional features (like classes for syntax highlighting or simple layout), but these are optional

      It may or not work with react/angular depending on how you design your components. If they're mostly <div> with class on them it may not be very beneficial, but if you're using more precise one like <nav>, <menu>, <section>, etc. it'll work as advertised

    • Documendous
      DocumendousMay 28, 2024

      Yeah, this just makes your base styles look good from the beginning and then you can use something like tailwind to make it look even better (or more to your taste).

  • Rudransh Bhardwaj
    Rudransh BhardwajMay 25, 2024

    Broo yooo , it can actually make designing faster

    Thanks

  • Lotfi Jebali
    Lotfi JebaliMay 25, 2024

    without doing anything 😇😇😇

  • Stokry
    StokryMay 26, 2024

    Really cool! I have something similar for my projects.

  • Alex Gonzalez
    Alex GonzalezMay 26, 2024

    love this library

  • Kevin Tewouda
    Kevin TewoudaMay 26, 2024

    Thank you for sharing! :)

  • Umar Sani Kanya
    Umar Sani KanyaMay 26, 2024

    Wow, so interesting I really love it, and would like to have more explanation on it.

  • Jack Kennedy
    Jack KennedyMay 27, 2024

    This is amazing, as a beginner in the web dev space, css styling can be so daunting and hard to get started, this is a game changer

  • Arjun Vijay Prakash
    Arjun Vijay PrakashMay 27, 2024

    This is truly amazing!

    All the best for the future.

    Also, is there any way, I can contribute to this project? (as a front-end developer or technical writer)

    • lowlighter 🦑
      lowlighter 🦑May 27, 2024

      I heard from some feedbacks that they were some accessibility issues (mainly to some color being hard to distinguish and links that should have kept underline).

      It'd be nice to have some insights and advices from more knowledgeable people on these kind of subjects, because front-end is not my specialty ahah x)

  • AngelloFD
    AngelloFDMay 27, 2024

    As a mainly backend focused dev, I couldn't be more happy. To have a way to reduce my time with frontend and ACTUALLY the actual tags of HTML makes me feel joyful.

    This sparks joy meme lady with the caption

    • Documendous
      DocumendousMay 28, 2024

      That's a great idea. Always good to be joyful.

  • Pandita
    PanditaMay 27, 2024

    you had me with the cute logo! thank you for sharing <3

  • ppaanngggg
    ppaannggggMay 27, 2024

    lol, look so cool to me. I am really headache about style design

  • fazicodes
    fazicodesMay 27, 2024

    this is so goood!, i just tried it for a quick interface for my api to showcase and i quickly remembered about this and it does wonder
    Image description

  • closetgeekshow
    closetgeekshowMay 27, 2024

    This is great! I made a little bookmarklet script to inject it on any site, been reading a lot of old old web pages lately and bare html is just so hard to read sometimes - this'll be a huge help.

  • Ryver
    RyverMay 27, 2024

    This is amazing!

  • Percio Andrade
    Percio AndradeMay 27, 2024

    good :)

  • Apperside
    AppersideMay 28, 2024

    Very nice concept, I didn't try it but it looks to me that it only works if you are very strict about semantic, that it's not a bad thing btw

    • lowlighter 🦑
      lowlighter 🦑May 30, 2024

      It'll definitely lose some efficiency, but can still be worth it since there are still style for styling text, paragraphs, hyperlinks, lists, etc.

  • Saurabh Kurve
    Saurabh KurveMay 28, 2024

    Wow, This is quite interesting!

  • Holly
    HollyMay 28, 2024

    Anyone looking for a job.I need STAFF to package MAKEUP from your home, good Salary This job is for USA only ! thank you, Here are all details.

  • hasib jabit jabit
    hasib jabit jabitMay 28, 2024

    Get_Your_$750_Wish_Gift_Card_Now!
    Giveaway Gift Card : Free Cash App Money Get $750 Cash App Gift Card . Your Chance to get $750 to your Cash Account!
    Cash App Gift Card $750 Free-Unveiling the Offer.
    In the fast-paced world of digital transactions, the allure of free money is hard to resist. Enter the Cash App Gift Card, a popular choice for those seeking financial perks in the form of a $750 windfall.
    Let's dive into the details, exploring the offer, its legitimacy, and the steps to claim this tempting reward.
    👉Get your reward after you fill in your information.
    👉Instantly receive $750 in your Cash App account.
    👉 Submit your Email/Zip code win the gift card
    👉 This offer is only allowed on Apple iOS in United States (US).
    CLICK HERE MORE INFO

  • Miia
    MiiaMay 28, 2024

    I will try! :)

  • Documendous
    DocumendousMay 28, 2024

    Looks really nice. Did you do this yourself?

    • lowlighter 🦑
      lowlighter 🦑May 30, 2024

      Thanks !
      Yes, I actually did this because I have a lot of small projects where I consistenly end up doing some kind of similar UI (mostly home lab dashboards and small apps) so I just decided to make it easier. That's also why it's not entirely "class-less", the syntax highlighting classes are enabled by default since I oftent use highlight.js in markdown generated docs but it's tedious to include both stylesheet from hljs to support dark/light modes

  • Axel Espinosa
    Axel EspinosaMay 28, 2024

    Really impressive library. I'll give it a try. Thanks for sharing 💡

  • gwennie
    gwennieMay 28, 2024

    I can't wait to try this out. Thanks so much for sharing!

  • Usama
    UsamaMay 28, 2024

    well that is so amazing

  • James Stine
    James StineMay 28, 2024

    This seems interesting, but I'm having a hard time finding a real use case for this in a long term project. Do you expect people to just replace this after a while? Is this just something where people are too lazy to write their own CSS and they use this instead and never do anything with CSS? Who is using this sort of thing?

    • lowlighter 🦑
      lowlighter 🦑May 30, 2024

      This is mostly intended for demo and prototyping I'll say, for example code playgrounds, small apps, home labs dashboards, students projects, etc. and like you said people that don't really want to write CSS (like backend devs that just need a simple front UI). I think it answers quite a lot of use-cases in a more hobby-ist development.

      However I do think it becomes less revelant in large projects or professional ones as usually you'd want more identity and branding (although matcha is customizable, using a CSS framework may be more suited in these case)

    • Javi Arroyo
      Javi ArroyoJun 6, 2024

      I think you underestimate people's lazyness...

  • R A M
    R A M May 29, 2024

    This is really another game changer for web developers, thanks for this will review it.

  • KAMALI INNOCENT
    KAMALI INNOCENTMay 29, 2024

    Its seems to be super great though I am not sure if you have to be having internet for it to work?
    How exactly can I use it?

    • lowlighter 🦑
      lowlighter 🦑May 30, 2024

      If you use the directly the <link> provided you'll indeed need internet since it's a remote domain, but you can also fetch a local copy by just going to matcha.mizu.sh/matcha.css

      The website also offer a custom builder if you want to add/remove features

  • Guillaume CADORET
    Guillaume CADORETMay 29, 2024

    could be nice for info.cern.ch/hypertext/WWW/TheProj...
    (but maybe a sacrilege..)

  • Guilherme Barbosa Leme
    Guilherme Barbosa LemeMay 29, 2024

    My gooodness this is god tier

  • Georgi Hadzhigeorgiev
    Georgi HadzhigeorgievMay 29, 2024

    That's actually very handy, thank you for bringing attention to it!

  • Shyam raj
    Shyam rajMay 31, 2024

    Wow, this is exactly what iam looking for, going to implement this for my next project. Thanku❤️

  • Yahaya Oyinkansola
    Yahaya OyinkansolaJun 7, 2024

    This is nice, I have never heard of drop-in CSS libraries before, is it like a new thing in the CSS world?

  • BossySmaxx
    BossySmaxxJun 7, 2024

    man that is great!! this is what I needed for my blogging website

  • Ernest Obot
    Ernest ObotJun 25, 2024

    Wow 😳

  • Ahmad ElKomey
    Ahmad ElKomeyJul 3, 2024

    Lovely! Good to know. Thanks for sharing.

  • Shawn P. Conroy
    Shawn P. ConroyJul 12, 2024

    This is incredible work. I like the semantic approach because it's more meaningful and easier to read than a bunch of divs everywhere. I especially liked it here because I learned some new things just reading your documentation. No legacy workarounds here! I've read so many CSS framework docs and never learned new HTML. I've not heard of the ruby tag before and think that can be useful for some of my projects. I'm not sure if I'd heard about the menu tag or not, but I forgot it. I'll remember it now!

    As a drop in lightweight semantic styling library, this is fantastic. I've been rewriting some smaller websites I maintain for community groups and decided to drop this in, and it works as a great foundation for several of them. With some key CSS on top of it.

    The thing that really had me scratching my head is that apparently your aside style in a section doesn't have a max-width. And so when I put in my ul with long lis it took up the full width of the section. In my CSS file I slapped on a max-wdith: 33% or similar because an aside shouldn't be that big by default.

    Since I often find that many of the frameworks are not right enough that I end up with enough of my own code, I think I will use this for many a small and medium project where warranted.

  • Lucas Frazao
    Lucas FrazaoJul 12, 2024

    I'm so happy to find this post, thx for sharing!

  • Amanda
    AmandaJul 17, 2024

    It says a lot about me that I was sold on trying it before I read the article bc of the cute logo

  • Aditya Bagale
    Aditya BagaleJul 22, 2024

    Seems like a decent start for a begineer like me!!

  • Jovan Emmanuel
    Jovan EmmanuelJul 25, 2024

    Cool, instant beautify!🔥

  • Eddie Gulay
    Eddie GulayJul 28, 2024

    Image description

  • Cody Cordova
    Cody CordovaAug 8, 2024

    love this

  • Alex Catchick
    Alex CatchickAug 10, 2024

    good work!

  • Hernan Bruno
    Hernan BrunoAug 19, 2024

    Excellent !

Add comment