{"id":13880655,"url":"https://github.com/LouisMazel/maz-ui","last_synced_at":"2025-07-16T17:30:54.765Z","repository":{"id":37258653,"uuid":"230145804","full_name":"LouisMazel/maz-ui","owner":"LouisMazel","description":"Vue \u0026 Nuxt library of standalone components \u0026 tools to build interfaces","archived":false,"fork":false,"pushed_at":"2025-07-09T19:23:06.000Z","size":119296,"stargazers_count":519,"open_issues_count":24,"forks_count":72,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-09T19:58:38.725Z","etag":null,"topics":["component","css","javascript","library","maz-ui","nuxt","standalone","tailwindcss","typescript","ui","vue","vue-components"],"latest_commit_sha":null,"homepage":"https://maz-ui.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/LouisMazel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"open_collective":"maz-ui"}},"created_at":"2019-12-25T19:37:27.000Z","updated_at":"2025-07-08T10:56:38.000Z","dependencies_parsed_at":"2023-09-26T17:46:24.664Z","dependency_job_id":"2b718505-f284-4d1e-a2de-c56e59f1a7c2","html_url":"https://github.com/LouisMazel/maz-ui","commit_stats":{"total_commits":1552,"total_committers":13,"mean_commits":"119.38461538461539","dds":0.4787371134020618,"last_synced_commit":"b5994392a6705ab1af7e60f3d7e0d83691a71113"},"previous_names":[],"tags_count":304,"template":false,"template_full_name":null,"purl":"pkg:github/LouisMazel/maz-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LouisMazel%2Fmaz-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LouisMazel%2Fmaz-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LouisMazel%2Fmaz-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LouisMazel%2Fmaz-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LouisMazel","download_url":"https://codeload.github.com/LouisMazel/maz-ui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LouisMazel%2Fmaz-ui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264502580,"owners_count":23618646,"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":["component","css","javascript","library","maz-ui","nuxt","standalone","tailwindcss","typescript","ui","vue","vue-components"],"created_at":"2024-08-06T08:03:21.328Z","updated_at":"2025-07-16T17:30:54.760Z","avatar_url":"https://github.com/LouisMazel.png","language":"Vue","funding_links":["https://opencollective.com/maz-ui"],"categories":["TypeScript","Components \u0026 Libraries"],"sub_categories":["Frameworks"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://maz-ui.com/img/logo.svg\" alt=\"Maz UI Logo\" width=\"100\"\u003e\n\n  \u003ch1\u003eMaz UI\u003c/h1\u003e\n  \u003cp\u003e\n    \u003cstrong\u003e\n      Lightweight and efficient library for Vue 3 \u0026 Nuxt 3\n    \u003c/strong\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://vuejs.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/vue-3-42b983.svg\" alt=\"vue 3\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://v3.nuxtjs.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/nuxt-3-42b983.svg\" alt=\"nuxt 3\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/maz-ui\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/maz-ui/latest.svg\" alt=\"npm\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/maz-ui\"\u003e\u003cimg src=\"https://badgen.net/npm/types/maz-ui\" alt=\"types\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://npm-stat.com/charts.html?package=maz-ui\"\u003e\u003cimg src=\"https://badgen.net/npm/dm/maz-ui\" alt=\"Downloads\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://codeclimate.com/github/LouisMazel/maz-ui/maintainability\"\u003e\u003cimg src=\"https://api.codeclimate.com/v1/badges/6b27047dcf150ccddfac/maintainability\" alt=\"maintainability\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://codeclimate.com/github/LouisMazel/maz-ui/test_coverage\"\u003e\u003cimg src=\"https://api.codeclimate.com/v1/badges/6b27047dcf150ccddfac/test_coverage\" alt=\"test coverage\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/LouisMazel/maz-ui/actions/workflows/lib-test-unit.yml/badge.svg\" alt=\"github actions test unit\"\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\n  \u003ca href=\"https://maz-ui.com\"\u003eDocumentation\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n  \u003ca href=\"https://maz-ui.com/guide/getting-started\"\u003eGetting Started\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n  \u003ca href=\"https://maz-ui.com/made-with-maz-ui\"\u003eShowcase\u003c/a\u003e\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./resources/dashboard-dark.png\"\u003e\n    \u003cimg src=\"./resources/dashboard-light.png\" alt=\"Maz UI Demo Dashboard\" width=\"100%\" style=\"border-radius: 1rem;\"\u003e\n  \u003c/picture\u003e\n  \u003cbr\u003e\n  \u003csub\u003e\u003ci\u003eExample of a dashboard built with Maz UI components\u003c/i\u003e\u003c/sub\u003e\n\u003c/p\u003e\n\n## ✨ Features\n\n- 🎯 **Cherry-pick components** - Use only what you need\n- 🌙 **Dark mode** - Built-in dark mode support\n- 🎨 **Themeable** - Easy to customize with CSS variables\n- 📱 **Responsive** - Mobile-first design approach\n- 🔧 **TypeScript** - Full type support included\n- ⚡️ **Lightweight** - Tree-shakeable, no bloat\n- 🔍 **SSR** - Server-side rendering ready\n\n## 🚀 Quick Start\n\n```bash\nnpm install maz-ui\n```\n\n### Vue 3\n\n```ts\n// main.ts\nimport 'maz-ui/styles'\n```\n\n#### 💡 Usage\n\nThen, import and use only the components, composables, and more you need:\n\n```vue\n\u003ctemplate\u003e\n  \u003cMazBtn\u003eClick me!\u003c/MazBtn\u003e\n\u003c/template\u003e\n\n\u003cscript setup lang=\"ts\"\u003e\n  import MazBtn from 'maz-ui/components/MazBtn'\n\u003c/script\u003e\n```\n\nUse provided resolvers to enjoy auto-imports and TypeScript support: [Resolvers documentation](https://maz-ui.com/guide/getting-started#recommendations)\n\n### Nuxt 3\n\nThe Nuxt module automatically:\n\n- Imports all components, plugins, composables and directives on-demand (auto-imports)\n- Includes required styles\n- Provides TypeScript support out of the box\n\n[See options and more in the documentation](https://maz-ui.com/guide/nuxt)\n\n```ts\n// nuxt.config.ts\nexport default defineNuxtConfig({\n  modules: ['maz-ui/nuxt'],\n})\n```\n\n#### 💡 Usage\n\nNo need to import components, plugins, composables or directives, they are all auto-imported.\n\n```vue\n\u003ctemplate\u003e\n  \u003cMazBtn @click=\"toast.success('Hello Maz UI!')\"\u003e Click me! \u003c/MazBtn\u003e\n\u003c/template\u003e\n\n\u003cscript setup lang=\"ts\"\u003e\n  const toast = useToast()\n\u003c/script\u003e\n```\n\n## 🎨 Theming Made Easy\n\nCustomize Maz UI to match your brand with our dedicated CLI tool:\n\n```bash\n# Install the CLI\nnpm install -g @mazui/cli\n\n# Generate your theme\nmaz generate-css-vars\n```\n\nThe CLI will automatically:\n\n- Generate all color variations\n- Create dark mode variables\n- Output a ready-to-use CSS file\n\nTo know how configure the CLI, check [theming options](https://maz-ui.com/guide/theme) in our documentation.\n\n## 🧰 What's included?\n\n- 🧩 [Components](https://maz-ui.com/components/maz-btn) - Beautiful, accessible UI components\n- 🔌 [Plugins](https://maz-ui.com/plugins/dialog) - Powerful plugins for common use cases\n- 🎣 [Composables](https://maz-ui.com/composables/use-form-validator) - Reusable composition functions\n- 📏 [Directives](https://maz-ui.com/directives/fullscreen-img) - Useful Vue directives\n- 🛠️ [Helpers](https://maz-ui.com/helpers/currency) - Useful utilities for common tasks\n\n## 🤝 Contributing\n\nWe're always looking for contributors! Check out our [contribution guide](./CONTRIBUTING.md) to get started.\n\n## 📄 License\n\n[MIT](./LICENSE)\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eBuilt with ❤️ by \u003ca href=\"https://github.com/LouisMazel\"\u003eLouis Mazel\u003c/a\u003e\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLouisMazel%2Fmaz-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLouisMazel%2Fmaz-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLouisMazel%2Fmaz-ui/lists"}