{"id":16014737,"url":"https://github.com/louismazel/maz-ui","last_synced_at":"2026-04-01T21:48:38.619Z","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-04-21T10:13:41.000Z","size":118617,"stargazers_count":508,"open_issues_count":28,"forks_count":70,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-15T23:08:11.493Z","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-05-06T10:58:02.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":301,"template":false,"template_full_name":null,"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","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254436949,"owners_count":22070947,"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-10-08T15:04:59.568Z","updated_at":"2026-04-01T21:48:38.606Z","avatar_url":"https://github.com/LouisMazel.png","language":"Vue","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 \u0026 Nuxt\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 badge\"\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 badge\"\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  \u003c!-- \u003ca href=\"https://codecov.io/github/LouisMazel/maz-ui\" \u003e\n\u003cimg src=\"https://codecov.io/github/LouisMazel/maz-ui/branch/master/graph/bundle/lib-esm/badge.svg\" alt=\"Coverage\"/\u003e\n\u003c/a\u003e --\u003e\n  \u003ca href=\"https://codecov.io/github/LouisMazel/maz-ui\" \u003e\n\u003cimg src=\"https://codecov.io/github/LouisMazel/maz-ui/branch/master/graph/badge.svg?token=C6WEHHD8T9\" alt=\"Coverage\"/\u003e\n\u003c/a\u003e\n  \u003ca href=\"https://github.com/LouisMazel/maz-ui/actions/workflows/lib-test-unit.yml\"\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/a\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/guide/themes\"\u003eTheming\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## Documentation\n\nCheck the [Documentation](https://maz-ui.com) for more information.\n\n## 🚀 Quick Start\n\n```bash\nnpm install maz-ui\n```\n\n### Vue\n\n```ts\nimport { mazUi } from '@maz-ui/themes/presets'\nimport { fr } from '@maz-ui/translations'\nimport { MazUi } from 'maz-ui/plugins/maz-ui'\n// main.ts\nimport 'maz-ui/styles'\n\nconst app = createApp(App)\n\napp.use(MazUi, {\n  theme: {\n    preset: mazUi,\n  },\n  translations: {\n    messages: {\n      fr,\n    },\n  },\n})\n```\n\n#### 💡 Usage\n\nThen, import and use only the components, composables, and more you need:\n\n```vue\n\u003cscript setup lang=\"ts\"\u003e\nimport MazBtn from 'maz-ui/components/MazBtn'\n\u003c/script\u003e\n\n\u003ctemplate\u003e\n  \u003cMazBtn\u003eClick me!\u003c/MazBtn\u003e\n\u003c/template\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\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\u003cscript setup lang=\"ts\"\u003e\nconst toast = useToast()\n\u003c/script\u003e\n\n\u003ctemplate\u003e\n  \u003cMazBtn @click=\"toast.success('Hello Maz UI!')\"\u003e\n    Click me!\n  \u003c/MazBtn\u003e\n\u003c/template\u003e\n```\n\n## 🧰 What's included?\n\n### Modules\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### Packages\n\n- [Themes](https://maz-ui.com/guide/themes) - Easy to customize with CSS variables\n- [Translations](https://maz-ui.com/guide/translations) - Internationalization\n- [Icons](https://maz-ui.com/guide/icons) - Beautiful icons ready-to-use for Vue applications\n- [Nuxt](https://maz-ui.com/guide/nuxt) - Nuxt module for easy integration of Maz UI\n- [Utils](https://maz-ui.com/helpers/capitalize) - Useful utilities for common tasks\n- [Node](https://www.npmjs.com/package/@maz-ui/node) - Useful utilities for node\n- [MCP](https://maz-ui.com/guide/mcp) - AI assistant for documentation\n- [EslintConfig](./packages/eslint-config/README.md) - ESLint configuration of Maz UI (built on top of [@antfu/eslint-config](https://www.npmjs.com/package/@antfu/eslint-config))\n\n## Are you looking for a package or release manager?\n\nCheck out [Relizy](https://github.com/LouisMazel/relizy) for an auto-release manager for your packages or apps.\n\n- [Documentation](https://louismazel.github.io/relizy/)\n- [GitHub](https://github.com/LouisMazel/relizy)\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","funding_links":["https://opencollective.com/maz-ui"],"categories":[],"sub_categories":[],"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"}