From f5637f8b2c3e3bb541c16db573c5255e594fd67c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=A2=D0=B8=D0=BC=D1=83=D1=80=20=D0=93=D0=BE=D1=80=D0=BE?=
 =?UTF-8?q?=D0=B4=D0=B5=D1=86=D0=BA=D0=B8=D0=B9?=
 <gorodetskiy.timur@tnsu.kz>
Date: Thu, 13 Aug 2026 12:48:31 +0500
Subject: [PATCH] =?UTF-8?q?=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D0=BB=20?=
 =?UTF-8?q?=D0=B2=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0?=
 =?UTF-8?q?=D1=86=D0=B8=D1=8E=20=D0=BA=D0=B0=D0=BA=20=D0=BD=D0=B0=D1=81?=
 =?UTF-8?q?=D1=82=D1=80=D0=BE=D0=B8=D1=82=D1=8C=20=D0=B4=D0=BE=D1=81=D1=82?=
 =?UTF-8?q?=D1=83=D0=BF=20=D0=BA=20=D0=BF=D0=B0=D0=BA=D0=B5=D1=82=D1=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 55 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index d1d083a..eb78b93 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,43 @@
 
 > Внутренняя память проекта (решения, план, прогресс) — в [PROJECT.md](./PROJECT.md).
 
-## Установка
+## Первичная настройка (один раз на каждого разработчика)
+
+Пакет лежит в приватном registry (Gitea), поэтому перед первой установкой нужно один
+раз настроить доступ. Дальше про это можно забыть.
+
+**Шаг 1. Создать токен в Gitea:**
+1. Открой http://git.tnsu.kz → кликни на свой аватар справа вверху → **Настройки**.
+2. Слева: **Приложения**.
+3. В блоке «Управление токенами» → **Создать новый токен**:
+   - Имя: например `npm-read`.
+   - Права (scopes): найди строку **`package`** и поставь **«Прочитанные»** (Read).
+     Остальное — «Нет доступа».
+4. Нажми **Генерировать токен** и **сразу скопируй** его (показывается один раз).
+
+**Шаг 2. Прописать токен у себя на компьютере.**
+Создай (или дополни) файл `.npmrc` в своей домашней папке
+(`C:\Users\<твоё-имя>\.npmrc`) одной строкой:
+
+```
+//git.tnsu.kz/api/packages/timur.gorodetskiy/npm/:_authToken=ВСТАВЬ_СВОЙ_ТОКЕН
+```
+
+> ⚠️ Токен — это как пароль. Он лежит в домашней папке, **вне проекта**, и в git не попадает.
+> Никогда не коммить его и не вставляй в код.
+
+Всё. Теперь `npm i` в любом проекте, где подключён `@tnsu/ui-kit`, будет работать.
+
+## Установка в проект
+
+Убедись, что в корне проекта есть файл `.npmrc` со строкой (для request-portal он уже
+закоммичен):
+
+```
+@tnsu:registry=http://git.tnsu.kz/api/packages/timur.gorodetskiy/npm/
+```
+
+Затем:
 
 ```powershell
 npm i @tnsu/ui-kit
@@ -18,7 +54,7 @@ npm i @tnsu/ui-kit
 
 ```ts
 import { Button } from '@tnsu/ui-kit';
-import '@tnsu/ui-kit/styles.css'; // один раз в точке входа web part
+import '@tnsu/ui-kit/styles.css'; // один раз в корневом компоненте web part
 
 <Button variant="primary">Отправить</Button>;
 ```
@@ -29,13 +65,24 @@ _Наполняется по мере переноса. Полная витри
 
 | Компонент | Описание | Статус |
 |-----------|----------|--------|
-| Button    | Кнопка, варианты primary/accent/secondary/ghost/danger | ⏳ переносится |
+| Button    | Кнопка, варианты primary/accent/secondary/ghost/danger | ✅ готов |
 
-## Разработка
+## Разработка пакета
 
 ```powershell
-npm i            # поставить зависимости
-npm run build    # собрать пакет в dist/
-npm run dev      # сборка в watch-режиме
-# npm run storybook — витрина (добавим на шаге 5)
+npm i             # поставить зависимости
+npm run build     # собрать пакет в dist/
+npm run dev       # сборка в watch-режиме
+npm run storybook # витрина компонентов (localhost:6006)
 ```
+
+### Публикация новой версии
+
+```powershell
+# 1. поднять version в package.json (напр. 0.0.1 → 0.0.2)
+npm run build
+npm publish
+```
+
+> npm не даёт перезаписать уже опубликованную версию — перед публикацией всегда
+> бампай `version` в package.json.