Carprice-ui NPM

Carprice UI-kit

Библиотека React-компонентов Carprice. Актуальную версию можно посмотреть на https://ui-kit.carprice.ru

Для разработки компонентов используется библиотека storybook.

Для запуска на локальном компьютере необходимо выполнить команды:

yarn install

yarn storybook

По адресу http://localhost:9001 будет доступен storybook со всеми компонентами.

Для подключения в других проектах необходимо в проектах выполнить: yarn add git+ssh://git@bitbucket.org:carprice/ui-kit.git#VERSION

VERSION - актуальная версия UI-kit. Версию можно посмотреть в bitbucket в tags.

После настроить webpack на обработку css. В конфиге в module.rules необходимо добавить следующую обработку:

{
  test: /\.css$/,
  include: [/node_modules\/carprice-ui/],
  loaders: [
    'style-loader',
    'css-loader',
  ]
}

Использование компонентов:

import Header from 'carprice-ui/dist/Header';
import 'carprice-ui/dist/Header/index.css'

Чтобы не подтягивать css всех компонентов, подключаем css непосредственно для используемого компонента. css можно подключить один раз в основном компоненте и использовать его где необходимо.

При параллельной разработке проекта и доработке ui-kit выгодно локально слинковать проекты. Для этого в проекте ui-kit выполнить

yarn link

Во втором проекте выполнить

yarn link carprice-ui

При локальном изменении компонентов в ui-kit, необходимо выполнить

yarn build

После во внешнем проекте измененные компоненты подтянутся автоматически.

####DEPLOY

Для управления версиями пользуемся тегами git.

Для деплоя необходимо ветку dev смерджить в мастер. После этого произойдет обновление https://ui-kit.carprice.ru Далее в мастере необходимо создать тег с новой версией и запушить в репозиторий.

#####Версионирование:

v1.2.3

1 - мажорная версия (обновляется при потери совместимости компонентов старых версий)

2 - минорная версия (обновляется при добавлении новых фичей и компонентов)

3 - патч (обновляется при доработках и исправлениях)