Открыть демо
GitHubEng

Документация

Freim Deploy — платформа деплоя на своём сервере. FreimSite — шаблон сайта, который на ней растёт. Здесь написано, что делает каждый, как они соединяются и где лежит справочник.

Freim Deploy

Платформа деплоя на вашем VDS: сборка из Git, автоматический HTTPS, история релизов с откатом за секунду. Node 22, SQLite, Caddy и systemd — без Docker, без Kubernetes и без стороннего аккаунта, который видит, что вы выкатываете.

Одна панель управляет несколькими серверами и любым числом проектов по SSH. Фреймворк определяется сам: Next.js, Astro, Nuxt, SvelteKit, Remix, Python и обычная статика. Деплой запускается кнопкой, командой или по git push, когда подключён вебхук.

Как поставить

FreimSite

Официальный шаблон сайта под платформу: стартер на Astro 7, а не конструктор страниц. SEO-каркас, острова, ноль JavaScript по умолчанию и два десятка контент-коллекций со схемами Zod — форма контента проверяется на сборке, а не угадывается.

От обычного стартера его отличает разметка, а не инструменты: каждый блок, который клиент может захотеть поправить, несёт контракт из data-атрибутов. Его читает и пишет отдельное приложение — CMS-портал. Открывать редактор кода клиенту для этого не нужно ни разу.

Открыть шаблон

Как они соединяются

По отдельности каждый мало что значит: шаблон — это репозиторий, пока его никто не собирает, а платформа — движок сборки, пока ей нечего выкатывать. Вместе получается путь от репозитория до клиента, который правит свой сайт сам.

  1. 01РепозиторийСайт начинается из FreimSite — или из любого репозитория, который платформа умеет собрать.
  2. 02ПанельFreim Deploy забирает код, определяет фреймворк и собирает релиз.
  3. 03Живой сайт со своим доменомHTTPS выпускается сам; релиз выезжает, только когда пройдёт проверку.
  4. 04Клиент правит самОн открывает CMS-портал, кликает по заголовку или цене прямо на живой странице и печатает.
  5. 05Коммит и деплойПравка становится коммитом в Git, платформа её выкатывает. Редактор кода клиент не открывает никогда.

Справочник

Страницы справочника лежат в публичных репозиториях обычным markdown и написаны по-английски — обе половины.

Freim Deploy — платформа

  • first-deploy.mdОт свежей установки до первого сайта на HTTPS
  • frostdeploy-json.mdФайл конфигурации проекта: сборка, команда запуска, статика, монорепы, python-воркеры, несколько сервисов из одного репозитория
  • environment-variables.mdПеременные сборки против переменных выполнения: какие доезжают до сборки и почему секреты — нет
  • domains.mdАдреса платформы, свои домены, wildcard-запись, сертификаты, www и редиректы
  • servers.mdКак добавить в панель ещё сервер и что делает bootstrap
  • operations.mdОбновления, откаты, упавший сайт, бэкапы, секреты, удаление платформы
  • cms-portal.mdПортал, в котором клиент правит контент своего сайта

FreimSite — шаблон

  • quick-start.mdПоставить шаблон и запустить его локально
  • content.mdПравило всех контент-коллекций: редактируемого текста в коде компонентов не бывает
  • cms.mdКак клиент правит сайт: контракт разметки, который читает и пишет CMS-портал
  • deploy.mdВыкладка шаблона на Freim Deploy и почему frostdeploy.json сохраняет своё имя
  • structure.mdУстройство каталогов проекта

Freim Deploy — проприетарный продукт: публичный репозиторий распространяет установщик, документацию и готовые сборки. FreimSite распространяется по лицензии MIT. github.com/ARTFROST1/FreimDeploy