# @cloudforet-test/mirinae

> Mirinae - Design System for Multi Cloud Management Platform, Cloudforet

Latest version **2.0.0-dev171** (published 2024-08-13) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @cloudforet-test/mirinae
pnpm add @cloudforet-test/mirinae
yarn add @cloudforet-test/mirinae
bun add @cloudforet-test/mirinae
```

## Health

**Score 40/100 (D)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads; large bundle.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 2.0.0-dev171 |
| Published | 2024-08-13 |
| First published | 2024-07-08 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 42 |
| Unpacked size | 25.5 MB |
| Known vulnerabilities | 0 (+25 in 6 direct dependencies) |
| Install scripts | no |
| GitHub stars | 52 |
| Author | Cloudforet |
| Maintainers | cloudforet-admin |
| Keywords | mirinae, design system, vue, vuejs, ui library, component |

## Links

- npm: https://www.npmjs.com/package/@cloudforet-test/mirinae
- Repository: https://github.com/cloudforet-io/console
- Homepage: https://github.com/cloudforet-io/console/tree/master/packages/mirinae
- Issues: https://github.com/cloudforet-io/console/issues
- npm.io page: https://npm.io/package/@cloudforet-test/mirinae

## Dependencies (42)

- [ajv](https://npm.io/package/ajv.md) ^8.12.0
- [ejs](https://npm.io/package/ejs.md) ^3.1.10
- [vue](https://npm.io/package/vue.md) 2.7.16
- [uuid](https://npm.io/package/uuid.md) ^8.3.2
- [bytes](https://npm.io/package/bytes.md) ^3.1.2
- [color](https://npm.io/package/color.md) ^3.1.2
- [dayjs](https://npm.io/package/dayjs.md) ^1.10.7
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [marked](https://npm.io/package/marked.md) ^4.0.12
- [core-js](https://npm.io/package/core-js.md) ^3.29.1
- [fuse.js](https://npm.io/package/fuse.js.md) ^3.6.1
- [ajv-i18n](https://npm.io/package/ajv-i18n.md) ^4.2.0
- [filepond](https://npm.io/package/filepond.md) ^4.30.3
- [vue-gtag](https://npm.io/package/vue-gtag.md) ^1.16.1
- [vue-i18n](https://npm.io/package/vue-i18n.md) ^8.15.5
- [commander](https://npm.io/package/commander.md) ^10.0.1
- [dompurify](https://npm.io/package/dompurify.md) ^2.3.3
- [flatpickr](https://npm.io/package/flatpickr.md) ^4.6.9
- [v-tooltip](https://npm.io/package/v-tooltip.md) ^2.0.3
- [vue-focus](https://npm.io/package/vue-focus.md) ^2.1.0
- [codemirror](https://npm.io/package/codemirror.md) ^5.65.6
- [dragselect](https://npm.io/package/dragselect.md) ^1.15.1
- [linkify-it](https://npm.io/package/linkify-it.md) ^4.0.1
- [ajv-formats](https://npm.io/package/ajv-formats.md) ^2.1.1
- [vue-svgicon](https://npm.io/package/vue-svgicon.md) ^3.2.9
- [@vueuse/core](https://npm.io/package/@vueuse/core.md) ^8.9.1
- [highlight.js](https://npm.io/package/highlight.js.md) ^11.5.1
- [vue-filepond](https://npm.io/package/vue-filepond.md) ^6.0.3
- [vue-fragment](https://npm.io/package/vue-fragment.md) ^1.5.1
- [vuedraggable](https://npm.io/package/vuedraggable.md) ^2.24.3
- [webfontloader](https://npm.io/package/webfontloader.md) ^1.6.28
- [@popperjs/core](https://npm.io/package/@popperjs/core.md) ^2.11.4
- [@faker-js/faker](https://npm.io/package/@faker-js/faker.md) ^7.3.0
- [v-click-outside](https://npm.io/package/v-click-outside.md) ^3.0.1
- [velocity-animate](https://npm.io/package/velocity-animate.md) ^1.5.2
- [vue-notification](https://npm.io/package/vue-notification.md) ^1.3.20
- [@egjs/vue-flicking](https://npm.io/package/@egjs/vue-flicking.md) ^3.7.4
- [@vueuse/components](https://npm.io/package/@vueuse/components.md) ^9.0.2
- [vue-js-toggle-button](https://npm.io/package/vue-js-toggle-button.md) ^1.3.3
- [vue-template-compiler](https://npm.io/package/vue-template-compiler.md) 2.7.16
- [@juggle/resize-observer](https://npm.io/package/@juggle/resize-observer.md) ^3.3.1
- [filepond-plugin-file-validate-type](https://npm.io/package/filepond-plugin-file-validate-type.md) ^1.2.6

## Alternatives

- [@progress/kendo-ooxml](https://npm.io/package/@progress/kendo-ooxml.md) — 152.1K weekly downloads
- [@progress/kendo-react-ripple](https://npm.io/package/@progress/kendo-react-ripple.md) — 8.0K weekly downloads
- [@progress/kendo-react-orgchart](https://npm.io/package/@progress/kendo-react-orgchart.md) — 4.3K weekly downloads
- [@praxisui/dynamic-fields](https://npm.io/package/@praxisui/dynamic-fields.md) — 2.4K weekly downloads
- [@progress/kendo-vue-listbox](https://npm.io/package/@progress/kendo-vue-listbox.md) — 932 weekly downloads

## Recent versions

- 2.0.0-dev171 (latest) — 2024-08-13
- 2.0.0-dev125 — 2024-07-08

## README

<h1 align="center">Mirinae - Cloudforet Design System</h1>  

<br/>

<div align="center" style="display:flex; flex-direction: column;">
    <div>
        <img width="245" src="https://user-images.githubusercontent.com/35549653/76694897-de236300-66bb-11ea-9ace-b9edde9c12da.png">
    </div>
<br/>
<div>
<a  href="https://www.apache.org/licenses/LICENSE-2.0"  target="_blank">  
<img  alt="License: Apache 2.0"  src="https://img.shields.io/badge/License-Apache 2.0-yellow.svg"  />  
</a> 
<a href="https://storybook.developer.spaceone.dev/"  target="_blank">  
    <img alt="mirinae storybook" src="https://img.shields.io/badge/Design System-SpaceOne-blueviolet.svg?logo=storybook" />  
</a> 
</div>

</div>  

  
    
 

  

<br/>

[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/0)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/0)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/1)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/1)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/2)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/2)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/3)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/3)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/4)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/4)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/5)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/5)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/6)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/6)[![](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/images/7)](https://sourcerer.io/fame/WANZARGEN/spaceone-dev/spaceone-design-system/links/7)


<br/>

## 🧩 Mirinae Design System  
[Mirinae Storybook](http://storybook.developer.spaceone.dev/)  

<br/> 
<br/>

## 👨‍👩‍👧 Author

See our [OWNERS](https://github.com/cloudforet-io/mirinae/blob/master/AUTHORS) file.

<br/>
<br/>

## 📝 License

This project is [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) licensed.

<br/>
<br/>

### Chart License
Mirinae design system internally uses amCharts for Dynamic Chart. <br/>
Before using the design system, look carefully at amCharts' license. <br/>
If you want to purchase the amCharts license that suits you and use it on your application,
see the license FAQ.

https://www.amcharts.com/online-store/licenses-explained/

## How to Use


### 1. Install

```shell
npm install @cloudforet/mirinae vue vue-router vue-fragment
```
You need to use `vue-router` plug-in in your project to use several components that have dependencies with these plug-ins.

### 2. Set plugin
   
Add following lines to ```main.js``` file. <br/>

```javascript
import MirinaeDesignSystem from '@cloudforet/mirinae';

Vue.use(MirinaeDesignSystem, pluginOptions);
```

#### Plugin Options

| Option                 | Description                                                                                                                                                                   |
|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| vueI18n                | Whether to set your Vue I18n configs. If you use Vue I18n and want to use your Vue I18n configs, give your Vue I18n to this option. In Mirinae, some components use Vue I18n. |
| installFragment        | Whether to install Vue Fragment. Some components use Vue Fragment, so don't give this option if you have already installed it in your application.                            |

```typescript
interface MirinaeDSOptions {
    vueI18n?: VueI18n;
    installFragment?: boolean;
}
```

### 3. Set components locally

Example: 

```javascript
import { PButtonTab, PDynamicLayout } from '@cloudforet/mirinae';

export default {
    components: {
        PButtonTab,
        PDynamicLayout,
    },
    ...
}
```

### Components with dependencies
These components require plug-ins `vue-router` and `vue-i18n` installed in your project to function fully. If these plug-ins are not installed, it may not work as intended.

| Plug-in          | Components                            |
|------------------|---------------------------------------|
| Vue Router       | - `PLink` <br/> - `PBreadcrumbs`      |


<br/>

## How to Apply Styles

Mirinae Design System is based on Tailwindcss.<br/>

### Global Styles

#### Case 1. All styles
If your project doesn't use tailwindcss, add the code below to ```main.ts```.

```javascript
import '@cloudforet/mirinae/css/style.css';
import '@cloudforet/mirinae/dist/style.css';
```

### Case 2. Without tailwindcss styles
If your project use tailwindcss, you don't need to import all styles. <br/>
In that case, add codes below to your ```tailwind.config.js```.

```javascript
const mirinaeTailwind = require('@cloudforet/mirinae/tailwind.config.js')

module.exports = {
    theme: {
        ...mirinaeTailwind.theme,
        // your customized theme
    },
    variants: [...mirinaeTailwind.variants, 
    //your customized variants 
    ],
    plugins: [
        ...mirinaeTailwind.plugins,
        //your customized plugins 
    ]
}
```

Also, you need to add codes below to your ```main.js```.

```javascript
import '@cloudforet/mirinae/css/light-style.css';
import '@cloudforet/mirinae/dist/style.css';
```

---
_Source: https://npm.io/package/@cloudforet-test/mirinae · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
