Пункт первый
Коротко и по делу.
diff --git a/AGENTS.md b/AGENTS.md index 6c18247..8b3c5d3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,4 @@ - + # Vibe42 — учебная песочница: сайты, боты и первые приложения Workspace юзера `Zulfija`. Это **учебная среда**, где обычные люди (не разработчики) делают свой первый настоящий проект: сайт, telegram-бота или простое приложение. @@ -23,7 +23,7 @@ Workspace юзера `Zulfija`. Это **учебная среда**, где о | Что хочет юзер | Стек (ЖЁСТКО) | Рецепт | |----------------|---------------|--------| -| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist | **Статика:** `index.html` + `style.css` + `script.js`, ванильный JS. БЕЗ сборки, БЕЗ React/Vue/Vite, БЕЗ npm. Tailwind — только CDN. | старт с `design.md`, публикация в `pages` | +| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist | **Статика:** `index.html` + `style.css` + `script.js`, ванильный JS. БЕЗ сборки, БЕЗ React/Vue/Vite, БЕЗ npm. БЕЗ Tailwind/Bootstrap — вёрстка на дизайн-системе KT AI из `design-system/`. | старт с `design.md`, публикация в `pages` | | Telegram-бот | **Node.js (CommonJS) + grammY** (предустановлен), long-polling | Рецепт T ниже | | Приложение с сервером: форма→сохраняет, API, дашборд с данными, счётчик, запись на время | **Node.js (CommonJS), сервер на `node:http` БЕЗ зависимостей + хранение в `data.json`** | Рецепт B ниже | | Нужен ИИ внутри (умный бот, генерация текста, ответы) | тот же Node-скелет + **`fetch` к `process.env.AI_BASE_URL`** (без SDK) | блок «ИИ» ниже | @@ -839,6 +839,10 @@ git push origin HEAD:pages --- -## 🎨 design.md +## 🎨 design.md + дизайн-система KT AI -Рядом лежит `design.md` с готовой палитрой, типографикой и стартер-шаблоном `index.html`. **Начинай с него.** Не выдумывай новые цвета — модифицируй существующие. +Рядом лежит `design.md` — **прочитай его перед первой строкой вёрстки**. В нём каркас `index.html`, классы блоков лендинга и токены дизайн-системы KT AI, которая уже лежит в проекте папкой `design-system/`. + +Правило простое: **весь UI собирается из классов и токенов ДС**. Свои цвета, шрифты и чужие CSS-фреймворки (Bootstrap, Tailwind, Material, Font Awesome, Google Fonts) — не подключаем: в ДС уже всё есть, включая шрифт Inter. + +Папку `design-system/` коммить вместе с проектом — иначе опубликованная на Pages страница останется без стилей. diff --git a/design.md b/design.md index 1a16f8b..fb49a5b 100644 --- a/design.md +++ b/design.md @@ -1,132 +1,207 @@ - -# Design system — Vibe42 песочница + +# Дизайн-система KT AI — по ней собирается весь UI -Базовые цвета и типографика для лендингов. Начинай с этого, можно отклоняться. +В папке проекта лежит `design-system/` — это **дизайн-система KT AI** +(источник: `github.com/erjan-A/kt-ai-design-system`, MIT, версия в `design-system/VERSION`). +Весь визуал берётся оттуда: цвета, шрифт, отступы, кнопки, карточки, секции лендинга. -## Палитра +**Не выдумывай свой стиль и не тащи чужие фреймворки.** Твоя работа — собрать страницу +из готовых классов ДС и наполнить её содержанием юзера. -| Token | Hex | Использование | -|-------|-----|---------------| -| `--ink` | `#0F1218` | Тёмный фон / основной текст | -| `--cyan` | `#00E5FF` | Основной акцент (кнопки, лого) | -| `--cyan-50` | `#E8FCFF` | Светлая подложка для акцентов | -| `--white` | `#FFFFFF` | Основной фон | -| `--gray-500` | `#5B6573` | Вторичный текст | -| `--gray-100` | `#F2F4F7` | Сепараторы / тонкие фоны | +Если папки `design-system/` в проекте нет (старый проект) — принеси её один раз: -## Типографика - -```css -font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, system-ui, sans-serif; +```bash +cp -r /srv/opencode/design-system/kt-ai design-system ``` -| Уровень | Размер | Вес | line-height | -|---------|--------|-----|-------------| -| h1 (hero) | 56px | 800 | 1.05 | -| h2 (section) | 36px | 700 | 1.15 | -| h3 | 22px | 700 | 1.3 | -| body | 17px | 400 | 1.6 | +--- -На мобиле — h1 → 36px, h2 → 28px. +## 🔒 Три правила, которые нельзя нарушать -## Лейаут +1. **Цвета и размеры — только токенами** `var(--kt-ai-…)`. Сырой hex (`#0F1218`, `#fff`) в вёрстке + запрещён: он ломает светлую/тёмную тему. +2. **Никакого Bootstrap / Tailwind / Material / Font Awesome / Google Fonts.** Шрифт (Inter) уже + внутри ДС и работает офлайн. Всё, что нужно лендингу, в ДС уже есть. +3. **Свой `
-Подзаголовок: кому это и почему стоит остаться.
+Одно-два предложения пояснения к секции.
+Коротко и по делу.
Коротко и по делу.
Коротко и по делу.