Приложения к сайту связывают мобильные и desktop‑клиенты с локальным сайтом MacFullStack, не превращая их в отдельные стек‑проекты.
Они живут вне ~/MacFullStack/www — например в ~/companion-apps/… — и хранятся как метаданные в .macstack.json проекта. MacFullStack не меняет код companion‑приложения: запоминает только путь и даёт быстрые действия.
Что такое companion‑приложение
- Внешняя папка iOS/Android/desktop‑проекта, а не PHP‑сайт
- Связь от одного проекта MacFullStack к этой папке
- Безопасные метаданные: удаление связи не удаляет папку на диске
Используйте companions для мобильных приложений, React Native/Flutter, desktop‑frontend’ов, прототипов дизайна или вспомогательных админок, которые относятся к сайту.
В приложении
- Откройте Проекты, выберите карточку и нажмите Приложения…
- В листе показаны текущие приложения и кнопки Папка · Редактор · Терминал
- Чтобы добавить новое приложение:
- Заполните Имя и выберите Платформу
- Укажите абсолютный Путь к папке приложения (желательно вне
~/MacFullStack/www) - Нажмите Добавить приложение
- Чтобы отвязать приложение, используйте Удалить связь — ссылка пропадёт из
.macstack.json, но папка на диске останется.
Лицензия
- Free: можно просматривать уже привязанные приложения (если они созданы на Pro/Teams), но нельзя добавлять и удалять
- Pro / Teams: полное управление списком companion‑приложений из UI и CLI
CLI
CLI отражает те же действия:
macstack projects companions list --name blog --json
macstack projects companions add --name blog --app-name "Shop iOS" --kind ios --path /Users/me/companion-apps/shop-ios --json
macstack projects companions remove --name blog --id <uuid> --json
macstack projects companions open --name blog --id <uuid> --target folder --json
listпоказывает все приложения, привязанные к проектуaddвалидирует путь (должен быть абсолютным и уникальным для проекта) и записывает метаданныеremoveудаляет только связь, папку не трогаетopenиспользует те же помощники, что и кнопки Папка / Редактор / Терминал на карточке проекта