# Maketa — полное описание для нейросетей (llms-full)

> Полный машиночитаемый дамп продукта и документации Maketa. Источник истины: https://maketa.pro
> Обновлено: 2026-08-31.

## Что такое Maketa
Maketa — бесплатный онлайн-конструктор экранов мобильных приложений и лендингов. Работает в браузере, без установки; первый макет собирается без регистрации. Предназначен для НЕ дизайнеров: заказчиков заказной разработки, продакт-менеджеров, аналитиков, студий. Пользователь перетаскивает готовые блоки мышкой и делится ссылкой. Maketa — не замена Figma, а способ быстро и без обучения объяснить дизайнеру или разработчику, как должен выглядеть экран приложения. Продукт студии заказной разработки demda.pro (https://demda.pro). Цена — 0 ₽; платно только ИИ-функции. Язык — русский.

## Для кого и зачем
- Заказчик без навыков дизайна: нарисовать идею приложения без Figma и без ТЗ, отдать студии/разработчику.
- Продакт/аналитик: быстрый прототип экрана, обсуждение с командой.
- Разработчик и ИИ-агент: программное управление макетом (MCP-сервер, REST API), выгрузка экранов из кода (Flutter, веб).
Основная задача: превратить идею клиента в понятный макет и передать в работу студии demda.pro (лид-магнит воронки).

## Чем отличается от Figma
| Критерий | Maketa | Figma / проф. инструменты |
|---|---|---|
| Порог входа | открыл и рисуешь | учиться неделями |
| Понятно разработчику | да, готовый макет | как повезёт |
| Рамка реального устройства | встроена | плагины/настройка |
| Поделиться | ссылкой в один клик | скриншоты |
| Язык | на русском, без лишнего | перегружено |
| Цена | бесплатно | платно для команд |

## Ключевые возможности
- Инструменты рисования: прямоугольник (со скруглением), эллипс, текст, карандаш, картинка, эмодзи; вставка скриншота из буфера (Ctrl/⌘+V).
- Рамка реального устройства в редакторе (iOS/Android/веб), выбор модели/ОС; режим предпросмотра-эмулятора.
- Совместная работа: единая ссылка на макет + права доступа (редактирование по ссылке / только просмотр / только приглашённые) + именные соавторы по e-mail. Автосохранение на сервере, «Мои макеты».
- Единый аккаунт с demda.pro (клиент или сотрудник входит своими учётными данными).
- Экраны «из кода»: выгрузка экрана Flutter (пакет maketa_sync) или веб-страницы (maketa-sync-web) в макет отдельными объектами; ветки экранов (как в GitHub), дерево, версии.
- MCP-сервер: нейросети (Claude, ChatGPT и др.) читают/создают/меняют объекты макета и синхронизируют экраны из кода.
- Разбор картинки: ручной (выделение элементов) и умный ИИ-разбор скриншота на объекты (платно по токенам, в разработке).
- Тёмная тема, мобильная оптимизация просмотра, экспорт PNG.

## Основные понятия
- Доска (проект) — единица хранения, содержит экраны. Модель сцены — собственный JSON `maketa.board.v1` (единый источник истины для редактора, ИИ и нативных клиентов).
- Экран бывает `design` (правится в редакторе или ИИ) и `code` (выгружен из кода — помечен «из кода», правится, но новый пуш из кода перезапишет; чтобы сохранить вариант — сделать ветку).
- Ветка — редактируемая копия экрана, связана с оригиналом двусторонне.
- Объекты (модель board.v1). Общие поля: id, x, y (абсолютные px), rot (градусы), opacity (0–1), group (id логического блока: кнопка = rect+text одной группой), locked, link (id экрана-цели — переход в прототипе). Цвета — hex или none. Типы и их поля:
  - rect: w, h, fill (#hex|none), stroke (#hex), strokeWidth 0–12, radius — число или массив [tl,tr,br,bl];
  - ellipse: w, h, fill, stroke, strokeWidth;
  - text: text (≤5000), fontSize 8–80, weight 400|500|600|700, color, align left|center|right, lineHeight 1.0–2.0 (деф. 1.35), w (0 = авторазмер); эмодзи — text с emoji:true;
  - path (карандаш): points [[x,y],…] — точки относительны якорю x,y; color, size 1–20;
  - image: w, h, src (только data:image/), radius ≥0 (скругление углов);
  - note: примечание-аннотация (text, n — номер, color); в превью и экспорт не попадает;
  - tabs: нижний таб-бар ОДНИМ объектом: w (деф. 390), h (деф. 62), bg (деф. #FFFFFF), color активного (деф. #3A5BD9), muted неактивных (деф. #B7BECC), active (0-based), items — 2–5 пунктов {text ≤20, icon (0–2 эмодзи), link (id экрана)}; пункт с link — кликабельная зона перехода прототипа.

## Как это работает (3 шага)
1. Открыть редактор https://maketa.pro/app/ и нарисовать экран (или вставить скриншот Ctrl/⌘+V).
2. Нажать «Поделиться» — макет сохраняется, появляется ссылка; права определяют, кто может редактировать.
3. Для ИИ/кода — создать проектный ключ и подключить MCP-сервер или maketa_sync.

## Программное управление (для разработчиков и ИИ)
- REST API база: https://maketa.pro/maketa/api. Полная машиночитаемая схема (OpenAPI 3.1, все ручки, схемы запросов/ответов/ошибок): https://maketa.pro/openapi.json. Доски: POST /create, POST /save (оптимистичная блокировка через baseRev), GET /load, GET /rev (лёгкая сверка ревизии для live-обновлений). Экраны из кода: POST /screen/push (upsert по стабильному ключу, заголовок x-maketa-key), POST /screen/branch. Проектные ключи: POST /project/key, GET /project/keys, POST /project/key/revoke. Агенты: POST /agent/register, GET /agent/boards.
- Удалённый MCP-коннектор (как Figma): URL https://maketa.pro/maketa/api/mcp — добавляется в Claude/ChatGPT, авторизация OAuth 2.1 единым аккаунтом, доступ только к своим доскам. Инструменты: maketa_list_boards, maketa_list_screens, maketa_get_screen, maketa_create_screen, maketa_add_element, maketa_update_element, maketa_move_element, maketa_remove_element, maketa_branch_screen, maketa_push_code_screen, maketa_list_branches, maketa_get_parent.
- MCP headless (без OAuth и браузера): тот же URL /maketa/api/mcp, но Authorization: Bearer mk_pk_… (проектный ключ — инструменты в рамках своей доски, boardId обязателен) или Bearer mk_sb_… (песочный ключ — в рамках досок песочницы). Ключ принимается и в заголовке x-maketa-key.
- Локальный MCP-сервер (stdio) для CI/своих сценариев: tools/maketa-mcp.
- Flutter: пакет maketa_sync обходит render-дерево экрана и пушит его в Maketa как code-экран (каждый виджет — отдельный объект).
- Веб: maketa-sync-web (JS) обходит DOM + getComputedStyle и пушит элементы страницы как объекты. Скрипт: https://maketa.pro/maketa-sync-web.js.
- Правило для ИИ: code-экраны не редактируются как источник кода — для правок дизайна создавайте ветку (maketa_branch_screen).
- Ошибки API — всегда JSON {error, hint}: error — стабильный машинный код (bad_key, key_expired, forbidden, not_found, gone, quota_boards, quota_saves, conflict…), hint — по-русски, что сделать. 429 дополнительно несёт retryAfterMin.

## Путь автономного агента (REST, без человека)
Формулировка «без регистрации» на лендинге относится к браузеру: человек рисует анонимно. Автономному ИИ-агенту нужен песочный ключ — он выдаётся мгновенно, тоже без человека, почты и оплаты:

1. Регистрация: POST https://maketa.pro/maketa/api/agent/register, body {"name":"my-agent","purpose":"макет для клиента"} (оба поля опциональны; лимит 3 регистрации в сутки с IP). Ответ: {"key":"mk_sb_…","expiresAt":<unix ms, +14 дней>,"quotas":{"boards":5,"savesPerDay":200},"docs":"https://maketa.pro/llms.txt"}. Ключ показывается ОДИН раз — на сервере хранится только его хэш.
2. Создать доску: POST /maketa/api/create с заголовком x-maketa-key: mk_sb_… и body {"doc":{"name":"Демо","screens":[{"id":"s_1","name":"Главная","device":"iphone-15","w":390,"h":844,"bg":"#FFFFFF","objects":[]}]}}. Ответ {"id","edit","view"} — доска привязывается к ключу.
3. Наполнить: POST /maketa/api/save с тем же заголовком и body {"id":"<id>","doc":{…экран с объектами…}} — edit-токен не нужен для досок, созданных этим ключом. Пример объектов: rect {"type":"rect","x":20,"y":40,"w":350,"h":120,"fill":"#EEF1F6","radius":16}, text {"type":"text","x":36,"y":64,"text":"Привет!","fontSize":24,"weight":700}, ellipse {"type":"ellipse","x":300,"y":700,"w":56,"h":56,"fill":"#3A5BD9"}.
4. Поделиться: ссылка для людей — https://maketa.pro/app/?b=<id> (доска по умолчанию читается по ссылке: linkAccess=view; ссылка с edit-токеном ?b=<id>&edit=<edit> даёт правку).
5. Повторное чтение: GET /maketa/api/load?id=<id> — анонимно (access:"view") или со своим ключом (access:"edit"). Лёгкая сверка изменений без скачивания doc: GET /maketa/api/rev?id=<id> → {"rev","updatedAt"}.
6. Свои доски со ссылками: GET /maketa/api/agent/boards (заголовок x-maketa-key).

Ограничения песочного ключа: 5 досок (403 quota_boards), 200 сохранений/сутки (429 quota_saves), 14 дней жизни (потом 401 key_expired — регистрируйте новый). Песочный ключ НЕ даёт ИИ-функции (/ai/*) и оплату — у них свои требования (аккаунт с подтверждённым email, токены).

## Политика времени жизни данных
- Песочный ключ агента (mk_sb_): 14 дней с момента регистрации. После истечения — 401 key_expired, новый ключ выдаётся новой регистрацией.
- Доски песочницы: живут, пока жив ключ, плюс 30 дней грейс-периода. Затем удаляются с надгробием: /load и /save отвечают 410 {"error":"gone","deletedAt":…,"reason":"sandbox_expired"}. Доска песочницы, которую забрал (claim) живой аккаунт, становится обычной и не удаляется.
- Повышение до постоянного доступа: владелец доски (человек с аккаунтом) выдаёт в кабинете проектный ключ mk_pk_ — он не истекает, пока не отозван. Агентам, работающим на клиентов студии, ключ выдаёт владелец соответствующей доски.
- Доски по заданиям студии demda.pro при миграциях и обслуживании сохраняются.
- Любое удалённое отвечает 410 Gone (не 404): различайте «никогда не существовало» (404) и «было удалено» (410).

## Частые вопросы
- Нужно ли уметь рисовать или знать Figma? — Нет. Maketa для тех, кто не дизайнер: перетаскиваешь готовые блоки мышкой.
- Это бесплатно? — Да, старт бесплатный и без карты; первый макет без регистрации. Платно — только ИИ-функции (по токенам).
- Как показать макет заказчику или разработчику? — Кнопка «Поделиться» даёт ссылку; все видят один макет; права ограничивают правки.
- Мои макеты сохраняются? — Да, автоматически; с аккаунтом доступны с любого устройства.
- Чем отличается от Figma? — Figma для дизайнеров; Maketa — чтобы быстро и без обучения объяснить, как должно выглядеть. Закрывает разрыв между идеей и понятной задачей.

## Цена и монетизация
Редактор, экраны, шаринг, совместная работа, MCP для своих досок, выгрузка из Flutter/веба — бесплатно (0 ₽, без карты). Платно (по токенам, оплата в рублях) — ИИ-функции: умный разбор скриншота на объекты и последующие ИИ-возможности.

## Компания
Maketa — продукт студии заказной разработки demda.pro (https://demda.pro). Нужен не только макет, а готовое приложение — студия его разрабатывает. Контакт: Telegram https://t.me/demda.

## Ссылки
- Продукт/лендинг: https://maketa.pro/
- Редактор: https://maketa.pro/app/
- Документация: https://maketa.pro/docs/
- OpenAPI 3.1 (все ручки API): https://maketa.pro/openapi.json
- MCP-коннектор: https://maketa.pro/maketa/api/mcp
- Краткая сводка: https://maketa.pro/llms.txt