4.0.8 β€’ Published 1 year ago

js-mir-test v4.0.8

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Read this in other languages:

Mirrorful is simple, open-source design system infrastructure. Install Mirrorful to generate colors and other design tokens for your project. Then, import these tokens directly into your app.

  • Start new projects with a source of truth
  • Visually modify your theme
  • Generate colors
  • πŸ”œ Theme Templates
  • πŸ”œ Lightweight Headless Component Library
  • πŸ”œ Eslint rules
  • πŸ”œ Propagate tokens across projects
  • πŸ”œ Figma integration

And more...

πŸš€ Get started

Mirrorful is a NPM package intended to be installed as dev dependency.

npm install mirrorful --save-dev

or

yarn add mirrorful --dev

✨ Usage

The following commands will start a local editor at localhost:5050.

yarn run mirrorful

or

npx mirrorful

πŸ’Ώ Export Formats

After configuring your theme in the editor, you can export it to be used by your app.

We currently export to the following file types: .js, .ts, .css, .scss, .json

Using CSS Variables

Example:

.primary-button {
  background-color: var(--color-primary);
}

.primary-button:hover {
  background-color: var(--color-primary-hover);
}

Using Javascript Constants

Example:

<button backgroundColor={{ Tokens.primary.base }}>Click here</button>

🀝 Component Library Agnostic

We strive to be component library agnostic. Whether you're using Material UI, Chakra UI, Tailwind, Ant Design, or even your in-house library, Mirrorful hooks right in.

⚠️ create-react-app may warn that you are trying to import from outside the src directory. We are working on a long-term solution, but for now, we would recommend making a copy of the .mirrorful folder in your src directory.

Check out our examples:

Looking for a specific example? Request one here!

❀️ Community & Support

πŸͺž Contributors

🌎 Translations

Mirrorful is currently available in English, German πŸ‡©πŸ‡ͺ and Swedish πŸ‡ΈπŸ‡ͺ. Help us translate our documentation and UI to your language!

You can find all the info in this issue.

πŸ“š Documentation

Check out our documentation for more information.