Installation

TACO UI

TACO UI is a system of React components highly based on tailwindcss, it is available as an npm package. See full documentation here via storybook

npm:

npm install @elpassion/taco

yarn:

yarn add @elpassion/taco

Taco Design System and Figma Tokens

Taco Design System uses Figma Tokens plugin and has its own tokens-based classes config connected with Tailwind CSS. It's required to add those classes to Tailwind defaultTheme in your project. See detailed specification of how tokens work in Taco: TOKENS.MD

In Taco, we use several packages that aso need to be installed if you use some components.

Here is the list:

• DatePicker - react-datepicker
• Dropdown: SelectDropdown, AsyncSelect, CreatableSelect or MenuDropdown - react-select
• Modal - react-modal
• Carousel - embla-carousel-react
• Table - @tanstack/react-table
• WYSIWYG - react-quill

If you want to import any of the above components use :

import { ComponentName } from "@elpassion/taco/ComponentName";

IMPORTANT FOR THE DatePicker COMPONENT:

To load the styles you have to import DatePicker.styles.css file in your global stylesheet, eg:

/*  globals.css */
@import "@elpassion/taco/datePickerStyles.css";

If you add a new package to the design system, please add it to the list above, and what's more important, you have to add this package to peerDependencies in npm-package.json

For icons, we use our own font. If you want to use Taco icons, this font has to be imported. For this purpose add the code below to the main styles file (e.g. globals.css) in your project:

@font-face {
  font-family: "icons";
  src: url("https://elpassion-design-system.s3.eu-west-1.amazonaws.com/fonticon.ttf")
    format("opentype");
}

Optionally (WIP) (Now it's still required for some components to work)

You can use icons locally from icons font or use cdn https://elpassion-design-system.s3.eu-west-1.amazonaws.com/fonticon.ttf TODO:

• Allow importing font file from npm package

Then use it in your app for example:

import React from "react";
import Button from "@elpassion/taco";

export default function App() {
  return (
    <div className="App">
      <Button {...props} />
    </div>
  );
}

See the contribute guide:

CONTRIBUTE.MD