Skip to content

Быстрый старт

Мини-аппы — это server-driven UI на движке Stac. Экран описывается JSON-деревом виджетов, а приложение Mirea Ninja рендерит его в нативный Flutter-интерфейс. Все экраны и запросы проходят через наш защищённый прокси платформы.

За 3 минуты

  1. Открой Сервисы → Мини-аппы → Создать в приложении.
  2. Заполни название, slug и описание — slug станет адресом apps/<slug>.
  3. Выбери источник «JSON в приложении» и вставь экран (шаблон уже подставлен).
  4. Жми «Предпросмотр» — экран отрисуется тут же, до отправки.
  5. Отправь на модерацию. После одобрения апп появится в каталоге.

Минимальный экран

json
{
  "type": "scaffold",
  "body": {
    "type": "padding",
    "padding": { "left": 16, "right": 16, "top": 16 },
    "child": {
      "type": "column",
      "crossAxisAlignment": "stretch",
      "children": [
        { "type": "appSectionTitle", "title": "Мой первый апп" },
        { "type": "appCard", "child": {
          "type": "column",
          "children": [
            { "type": "text", "data": "Привет, ниндзя! 🥷" },
            { "type": "sizedBox", "height": 12 },
            { "type": "appButton", "label": "Расписание",
              "expanded": true,
              "onPressed": { "actionType": "openDeepLink",
                             "location": "/schedule" } }
          ]
        }}
      ]
    }
  }
}

Шаблоны

В форме создания есть готовые мультистраничные шаблоны («Список + детали», «Чеклист», «Опрос») — выбери и адаптируй. Чеклист показывает, как hosted-апп работает без сервера: состояние и хранилище держат данные на устройстве и в Postgres.

Несколько страниц

Hosted-апп может состоять из любого числа экранов: в форме публикации жми «Добавить экран» и задай каждому путь (/, /stats, /about, …). Между ними навигирует экшен openPage, назад — pop.

Что дальше

Смотри справочник виджетов (включая нативные компоненты app*), экшены для интерактива и диплинки, чтобы открывать экраны Mirea Ninja прямо из твоего аппа.

Пример вживую

В каталоге опубликован апп «Витрина возможностей» (slug showcase) — открой его и потыкай: 6 экранов со всеми нативными виджетами и действиями платформы, каждый собран из JSON, как на этой странице.

Работает на Stac