@aplinkosministerija/design-system

Design System

Design System library provides a set of UI components designed to streamline the development of consistent user interfaces among web applications.

Installation

You can install the design system package via npm or yarn:

npm install @aplinkosministerija/design-system

or

yarn add @aplinkosministerija/design-system

Usage

Before using our design system library, make sure to install and set up the styled-components package in your project. This package is essential for styling components within the design system, allowing for smooth integration and customization.

For the library to function properly, ensure to utilize the Theme type provided by the design system library when configuring styled-components.

import { Theme } from '@aplinkosministerija/design-system';

When implementing global styles, you have the option to either create your own or import them from our library. However, if you choose to write your own global styles, it's important to remember to set the font-size to 62.5%. This adjustment is necessary because our design system relies on rem units rather than pixels. By setting the font-size to 62.5%, you can ensure consistent and predictable typography rendering across different screen sizes and devices.

In case you decide to implement your own global styles, add the following CSS to your global styles:

html {
    font-size: 62.5%;
}

Otherwise, import global styles from the library:

import { globalStyles } from '@aplinkosministerija/design-system';
const GlobalStyles = createGlobalStyle`${globalStyles(theme)}`;

Once styled-components are configured and the theme and global styles are set up, you can simply import components from the library and use them in your code.

import { Button } from '@aplinkosministerija/design-system';

const App = () => {
    return (
        <div>
            <Button onClick={() => alert('Button clicked!')}>Click me</Button>
        </div>
    );
}

export default App;

Components

Button

Checkbox

Switch

AsyncSelectField

AsyncMultiSelectField

MapField

Map

SelectField

MultiSelectField

TextField

NumericTextField

TextAreaField

PasswordField

PhotoUploadField

Table

RecursiveTable

Tabs

License

This project is licensed under the MIT License - see the LICENSE file for details.