{"id":13555139,"url":"https://github.com/beercss/beercss","last_synced_at":"2026-01-07T22:11:54.199Z","repository":{"id":39610808,"uuid":"319921698","full_name":"beercss/beercss","owner":"beercss","description":"Build material design interfaces in record time... without stress for devs... 🍺💛","archived":false,"fork":false,"pushed_at":"2024-04-12T19:57:25.000Z","size":17334,"stargazers_count":892,"open_issues_count":28,"forks_count":45,"subscribers_count":15,"default_branch":"main","last_synced_at":"2024-04-13T03:04:19.521Z","etag":null,"topics":["class-light","css","design-system","material","material-3","material-design-3","material-you","semantic-html"],"latest_commit_sha":null,"homepage":"https://www.beercss.com","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beercss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"beercss","open_collective":"beercss"}},"created_at":"2020-12-09T10:32:09.000Z","updated_at":"2024-07-30T19:20:31.511Z","dependencies_parsed_at":"2024-04-12T20:54:17.175Z","dependency_job_id":null,"html_url":"https://github.com/beercss/beercss","commit_stats":{"total_commits":1127,"total_committers":23,"mean_commits":49.0,"dds":"0.49068322981366463","last_synced_commit":"15104221584466af436a09a817be80865e1d444c"},"previous_names":[],"tags_count":254,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beercss%2Fbeercss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beercss%2Fbeercss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beercss%2Fbeercss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beercss%2Fbeercss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beercss","download_url":"https://codeload.github.com/beercss/beercss/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246582127,"owners_count":20800444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["class-light","css","design-system","material","material-3","material-design-3","material-you","semantic-html"],"created_at":"2024-08-01T12:03:03.226Z","updated_at":"2026-01-07T22:11:54.120Z","avatar_url":"https://github.com/beercss.png","language":"Vue","readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.beercss.com\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg src=\"https://www.beercss.com/logo.png\" alt=\"Beer CSS logo\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/beercss/beercss/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/beercss/beercss\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/beercss/beercss\"\u003e\u003cimg src=\"https://img.shields.io/jsdelivr/npm/hy/beercss\" alt=\"Downloads\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://bundlephobia.com/package/beercss@3.9.7\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/bundlephobia/minzip/beercss@3.9.7\" alt=\"minzipped size\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.npmjs.com/package/beercss\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/beercss\" alt=\"Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/beercss/beercss/pulls\"\u003e\u003cimg src=\"https://img.shields.io/github/issues-pr/beercss/beercss\" alt=\"Pull Request\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/beercss/beercss/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/beercss/beercss\" alt=\"Issues\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Beer CSS\n\nBuild material design interfaces in record time...\n\n...without stress for devs 🍺💛\n\nCheers, www.beercss.com\n\n# Sponsors\n\nBeer CSS is an MIT-licensed open source project with its ongoing development made possible entirely by the support of these awesome sponsors and backers. If you'd like to join them, please consider sponsoring Beer CSS's development.\n\n### Open Collective sponsors\n\u003cp\u003e\u003ca href=\"https://opencollective.com/beercss#support\"\u003e\u003cimg src=\"https://opencollective.com/beercss/sponsors.svg?avatarHeight=56\u0026button=false\" alt=\"Sponsors\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003e\u003ca href=\"https://opencollective.com/beercss#support\"\u003e\u003cimg src=\"https://opencollective.com/beercss/backers.svg?avatarHeight=40\u0026button=false\" alt=\"Backers\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n### Github sponsors\n\u003cp\u003e\n  \u003ca href=\"https://github.com/sponsors/beercss\"\u003e\n    \u003cimg src=\"https://avatars.githubusercontent.com/u/74856856?s=40\u0026v=4\" alt=\"Sponsors\"\u003e\n    \u003cimg src=\"https://avatars.githubusercontent.com/u/419690?s=40\u0026v=4\" alt=\"Sponsors\"\u003e\n    \u003cimg src=\"https://avatars.githubusercontent.com/u/181576?s=40\u0026v=4 alt=\"Sponsors\"\u003e\n    \u003cimg src=\"https://avatars.githubusercontent.com/u/797439?s=40\u0026v=4 alt=\"Sponsors\"\u003e\n    \u003cimg src=\"https://avatars.githubusercontent.com/u/3647943?s=40\u0026v=4 alt=\"Sponsors\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Why?\n\n- 🥇 The first CSS framework based on Material Design 3.\n- ⬇️ 10x smaller than others CSS frameworks based on Material Design.\n- 🧙‍♂️ Translates Material Design to HTML semantic standard.\n- 🤓 Ready to use with any JS framework.\n- 🪄 Highly focused on DX.\n- 🚫 No build steps, configurations or dependencies.\n- ✨ Build modern interfaces without any custom CSS.\n\n# A lightweight beer\n\nLet's be honest, in the ever-evolving world of web development, we're all looking for that sweet spot: powerful functionality without the bloat. We want speed, efficiency, and something that doesn't feel like lugging around a digital elephant. And if you're looking at the chart below, you're probably thinking, \"Wow, XYZ is huge!\". You're not wrong. But look all the way to the top. See that? That's Beer CSS.\n\n![image](https://github.com/user-attachments/assets/23df0121-7716-4114-9751-38b1e519cfcd)\n\n# The principles\n\nThis project was guided by the **\"Germany Beer Purity Law\"** or **\"Reinheitsgebot\"** created in 1516. This law states that beer should only be brewed with the following ingredients: **water**, **barley malt** and **hops**. Only 3 ingredients. Exciting, right? So we thinking about It and our 3 ingredients are: **settings**, **elements** and **helpers**. This sounds weird at first time, because It's not BEM, OOCSS, SMACSS, ITCSS, \"Utility first\" or any other approach. Our approach doesn't avoid some bad practices, but is lightweight, tasty and pure like a beer. Just try it and feel it! 😁\n\n```\n|  SETTINGS     |       // The settings affects all document\n|---------------|----|\n|               |    |\n|  ELEMENTS     |    |  // The elements are the components, widgets or tags\n|               |    |\n|---------------|    |\n|               |    |\n|               |    |\n|  HELPERS      |----|  // The common helpers makes the elements more scalable and customizable\n|               |\n|               |\n|---------------|\n```\n\n### ✅ DO:\n\n```\n// 1 setting to 1 document\n\u003cbody class=\"dark|light\"\u003e...\u003c/body\u003e\n\n// 1 element to N helpers\n\u003celement class=\"helper helper\"\u003e...\u003c/element\u003e\n\u003cdiv class=\"element helper helper\"\u003e...\u003c/div\u003e\n\n// nav elements before all others\n\u003cbody\u003e\n  \u003cnav class=\"left|right|top|bottom\"\u003e...\u003c/nav\u003e\n  ...\n\u003c/body\u003e\n\n\u003cdiv id=\"app\"\u003e\n  \u003cnav class=\"left|right|top|bottom\"\u003e...\u003c/nav\u003e\n  ...\n\u003c/div\u003e\n\n// write css like this\n.element.helper {...}\n.element \u003e .element {...}\n.element \u003e .helper {...}\n```\n\n### 🚫 DON'T:\n\n```\n// N elements to 1 tag\n\u003cdiv class=\"element element helper\"\u003e...\u003c/div\u003e\n\n// element with dependencies\n\u003cdiv class=\"element\"\u003e\n  \u003cdiv class=\"element-header\"\u003e...\u003c/div\u003e\n  \u003cdiv class=\"element-content\"\u003e...\u003c/div\u003e\n  \u003cdiv class=\"element-footer\"\u003e...\u003c/div\u003e\n\u003c/div\u003e\n\n// nav elements after all others\n\u003cbody\u003e\n  ...\n  \u003cnav class=\"left|right|top|bottom\"\u003e...\u003c/nav\u003e\n\u003c/body\u003e\n\n\u003cdiv id=\"app\"\u003e\n  ...\n  \u003cnav class=\"left|right|top|bottom\"\u003e...\u003c/nav\u003e\n\u003c/div\u003e\n\n// write css like this\n.element.element {...}\n.element .element {...}\n.element .helper {...}\n```\n\n# Get started\n\n### CDN\n\nFrom jsdelivr.net.\n\n```html\n// with html\n\u003clink href=\"https://cdn.jsdelivr.net/npm/beercss@3.9.7/dist/cdn/beer.min.css\" rel=\"stylesheet\" /\u003e\n\u003cscript type=\"module\" src=\"https://cdn.jsdelivr.net/npm/beercss@3.9.7/dist/cdn/beer.min.js\"\u003e\u003c/script\u003e\n\u003cscript type=\"module\" src=\"https://cdn.jsdelivr.net/npm/material-dynamic-colors@1.1.2/dist/cdn/material-dynamic-colors.min.js\"\u003e\u003c/script\u003e\n```\n\n```css\n// with css\n@import \"https://cdn.jsdelivr.net/npm/beercss@3.9.7/dist/cdn/beer.min.css\";\n```\n\n```js\n// with javascript\nimport \"https://cdn.jsdelivr.net/npm/beercss@3.9.7/dist/cdn/beer.min.js\";\nimport \"https://cdn.jsdelivr.net/npm/material-dynamic-colors@1.1.2/dist/cdn/material-dynamic-colors.min.js\";\n```\n\n### NPM\n\nYou can get the latest release using NPM. This release contains source files as well as the compiled CSS and JavaScript files.\n\n```js\n// installing\nnpm i beercss\nnpm i material-dynamic-colors\n```\n\n```js\n// importing as window.beercss and window.materialDynamicColors\nimport \"beercss\";\nimport \"material-dynamic-colors\";\n```\n\n```js\n// importing as beercss and materialDynamicColors\nimport beercss from \"beercss\";\nimport materialDynamicColors from \"material-dynamic-colors\";\n```\n\n```js\n// importing manually from dist\nimport \"beercss/dist/cdn/beer.min.css\";\nimport beercss from \"beercss/dist/cdn/beer.min.js\";\nimport materialDynamicColors from \"material-dynamic-colors/dist/cdn/material-dynamic-colors.min.js\";\n```\n\n```js\n// importing manually from src\nimport \"beercss/src/cdn/beer.css\";\nimport beercss from \"beercss/src/cdn/beer.ts\";\nimport materialDynamicColors from \"material-dynamic-colors/src/cdn/material-dynamic-colors.js\";\n```\n\n### HTML\n\nYou can use this html to setup your project. See on [Codepen](https://codepen.io/leo-bnu/pen/yLKLPxj). More about in [Main layout](docs/MAIN_LAYOUT.md).\n\n```html\n\u003chtml\u003e\n  \u003chead\u003e\n    \u003cmeta charset=\"UTF-8\"\u003e\n    \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\"\u003e\n    \u003cmeta http-equiv=\"X-UA-Compatible\" content=\"ie=edge\"\u003e\n    \u003cmeta name=\"google\" content=\"notranslate\"\u003e\n    \u003ctitle\u003eHello world\u003c/title\u003e\n    \u003clink href=\"https://cdn.jsdelivr.net/npm/beercss@3.9.7/dist/cdn/beer.min.css\" rel=\"stylesheet\"\u003e\n    \u003cscript type=\"module\" src=\"https://cdn.jsdelivr.net/npm/beercss@3.9.7/dist/cdn/beer.min.js\"\u003e\u003c/script\u003e\n    \u003cscript type=\"module\" src=\"https://cdn.jsdelivr.net/npm/material-dynamic-colors@1.1.2/dist/cdn/material-dynamic-colors.min.js\"\u003e\u003c/script\u003e\n  \u003c/head\u003e\n  \u003cbody class=\"dark\"\u003e\n    \u003cnav class=\"left drawer l\"\u003e\n      \u003cheader\u003e\n        \u003cnav\u003e\n          \u003cimg src=\"https://www.beercss.com/favicon.png\" class=\"circle\"\u003e\n          \u003ch6\u003eCheers\u003c/h6\u003e\n        \u003c/nav\u003e\n      \u003c/header\u003e\n      \u003ca\u003e\n        \u003ci\u003ehome\u003c/i\u003e\n        \u003cdiv\u003eHome\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003esearch\u003c/i\u003e\n        \u003cdiv\u003eSearch\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003eshare\u003c/i\u003e\n        \u003cdiv\u003eShare\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003emore_vert\u003c/i\u003e\n        \u003cdiv\u003eMore\u003c/div\u003e\n      \u003c/a\u003e\n      \u003cdiv class=\"divider\"\u003e\u003c/div\u003e\n      \u003clabel\u003eLabel\u003c/label\u003e\n      \u003ca\u003e\n        \u003ci\u003ewidgets\u003c/i\u003e\n        \u003cdiv\u003eWidgets\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003echat\u003c/i\u003e\n        \u003cdiv\u003eChat\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003ehelp\u003c/i\u003e\n        \u003cdiv\u003eHelp\u003c/div\u003e\n      \u003c/a\u003e  \n    \u003c/nav\u003e\n\n    \u003cnav class=\"left m\"\u003e\n      \u003cheader\u003e\n        \u003cimg src=\"https://www.beercss.com/favicon.png\" class=\"circle\"\u003e\n      \u003c/header\u003e\n      \u003ca\u003e\n        \u003ci\u003ehome\u003c/i\u003e\n        \u003cdiv\u003eHome\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003esearch\u003c/i\u003e\n        \u003cdiv\u003eSearch\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003eshare\u003c/i\u003e\n        \u003cdiv\u003eShare\u003c/div\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003emore_vert\u003c/i\u003e\n        \u003cdiv\u003eMore\u003c/div\u003e\n      \u003c/a\u003e\n    \u003c/nav\u003e\n\n    \u003cnav class=\"bottom s\"\u003e\n      \u003ca\u003e\n        \u003ci\u003ehome\u003c/i\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003esearch\u003c/i\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003eshare\u003c/i\u003e\n      \u003c/a\u003e\n      \u003ca\u003e\n        \u003ci\u003emore_vert\u003c/i\u003e\n      \u003c/a\u003e\n    \u003c/nav\u003e\n\n    \u003cmain class=\"responsive\"\u003e\n      \u003cimg src=\"https://www.beercss.com/beer-and-woman.svg\" class=\"responsive round\"\u003e\n      \u003ch3\u003eWelcome\u003c/h3\u003e\n      \u003ch5\u003eThe beer is ready!\u003c/h5\u003e\n    \u003c/main\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n**We recommend use the material-dynamic-colors only when your app needs to change theme at runtime.**\n\n# Documentation\n\nComplete documentation and examples available at:\n\n- **[Documentation](docs/INDEX.md)**\n- **[Codepen](https://codepen.io/collection/XydYMB)**\n- **[Homepage](https://www.beercss.com)**\n\n# Contributing guide\n\nHi! We are really excited that you are interested in contributing to Beer CSS! Before submitting your contribution, please make sure to take a moment and read through the following guidelines:\n\n[Beer CSS Contributing Guidelines](CONTRIBUTING.md)\n\n# License\n\n[MIT](https://opensource.org/licenses/MIT)\n\n# Cheers to all stargazers 🍻\n[![Stargazers repo roster for @beercss/beercss](https://reporoster.com/stars/notext/beercss/beercss)](https://github.com/beercss/beercss/stargazers)\n\n### Stargazers over time\n[![Stargazers over time](https://starchart.cc/beercss/beercss.svg?variant=adaptive)](https://starchart.cc/beercss/beercss)\n","funding_links":["https://github.com/sponsors/beercss","https://opencollective.com/beercss"],"categories":["Vue","Material Design","Frameworks / Resources"],"sub_categories":["B"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeercss%2Fbeercss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeercss%2Fbeercss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeercss%2Fbeercss/lists"}