Оформление сгенерированного приложения задаётся в Project settings → Branding. Для поддерживаемых настроек не нужны собственный CSS или правки generated-файлов. Branding меняет ваше приложение, а не интерфейс генератора, права, языки данных или шрифты.
Начните с черновика
- Откройте проект и Project settings → Branding.
- Оставьте Enable Branding включённым. Решите, нужна ли посетителям Enable secondary theme.
- Настройте Content, затем независимый блок Login. Выберите цвет круглым picker внутри поля или введите
#RRGGBB; очистите цвет для стандартного значения. - Проверьте светлый и тёмный макеты рядом с каждым блоком. На узком экране они перемещаются под настройки. Это статичные иллюстрации несохранённого черновика, без данных приложения и выполнения custom-кода.
- Нажмите Save project settings, проверьте Generate → Preview changes, выполните Generate и пересоберите приложение обычным способом выпуска. Загрузка изображения или изменение превью не выполняют эти шаги.
Reset позволяет отказаться от черновика настроек. При уходе с несохранёнными правками интерфейс уточняет действие. Только изменения оформления не требуют миграции БД и не развёртывают приложение автоматически.
Названия Content, компания и главная
| Настройка | Поведение |
|---|---|
| Application title | Название приложения; пустое поле использует Project title из General. |
| Short title | Сокращённое название там, где оно используется. |
| Company name | Необязательная подпись по центру под Log out, также используется на Login. |
| Welcome title / Welcome text | Текст обычной сгенерированной главной; не заменяет содержимое Demo или собственного дашборда. |
| Support label / Support URL | Необязательная общая ссылка поддержки с HTTPS или mailto. |
Явно заданный Application title заменяет подпись Administration над логотипом Content; дублирования названия снизу нет. Без него остаются стандартная подпись и подстановка Short title/Project title. Название и логотип Content центрируются. Branding не переименовывает технические Project name, Go module или таблицы. Change password доступен иконкой верхней панели при наличии прав; роли и ограничения Demo не меняются.
Для собственной React-главной используйте General → Custom dashboard и сохраняемую точку расширения из custom admin.
Независимые цвета Content и Login
В обоих блоках видны группы Primary (Light) и Secondary (Dark):
| Блок | Доступные цвета |
|---|---|
| Content | Accent, Background, Surface, Text, Menu |
| Login | Accent, Background, Surface, Text |
Background в Content — фон страницы, Surface — карточки, формы, таблицы и поля. Menu задаёт отдельный фон меню с читаемыми подписями, выбранным состоянием и наведением. У Login свои фон страницы, поверхность формы, акцент и обычный текст, включая заголовок. Пустые цвета Login используют стандартные светлые/тёмные значения и никогда не наследуют Content.
Оттенки текста, ссылок и фокуса подбираются с учётом реальных поверхностей. Заданный цвет может стать светлее или темнее ради читаемости: заголовок на фоне страницы не обязан иметь тот же оттенок, что поле на карточке. Статусные цвета ошибок, предупреждений и успеха остаются отдельными. Палитра проекта не меняет фиксированную палитру генератора.
Название и изображения Login
У Login собственный Application title. Пустое поле скрывает строку названия; Content Application title, Short title и Project title не подставляются. Login title — заголовок формы со стандартным Sign in; Login description — дополнительный текст.
Загрузите Login image · Light и при необходимости Login image · Dark. При отсутствии тёмного используется светлое изображение Login. Если изображения нет, показывается стандартный замок. Логотипы Content на Login не используются; выбора значка нет. Изображение, названия, описание, компания и поддержка центрированы; поля учётных данных сохраняют обычное выравнивание.
Логотипы, favicon и исходные файлы
В Content доступны Logo · Light, необязательный Logo · Dark с подстановкой светлого и Favicon. Логотипы и изображения Login принимают PNG/JPEG/WebP до 2 MiB; Favicon — PNG до 256 KiB. Загрузчик проверяет содержимое и размеры файла. SVG/HTML, произвольные локальные пути и внешние URL изображений не поддерживаются.
Используйте загрузку, замену или удаление на плитке; действия доступны при наведении, клавиатурном фокусе и на сенсорном устройстве. Remove очищает ссылку в черновике, а не удаляет сохранённый исходный файл.
Исходники хранятся в .admingen/branding/, ссылки — в модели. Включайте в систему версий и модель, и файлы. Generate копирует нужные ресурсы в admin/public/branding/; эта копия принадлежит генератору. Файлы Branding отделены от хранилищ Image/File записей и не требуют миграции загруженных данных БД.
Выключить и вернуть оформление
Выключенный Enable secondary theme принудительно оставляет Light даже при тёмной теме ОС или прежнем выборе Dark и скрывает переключатель Content/Login. Цвета и предыдущий выбор сохраняются для повторного включения.
Выключенный Enable Branding скрывает настройки/превью, сохраняя все значения, файлы и выбор дополнительной темы. После Save и Generate приложение использует стандартные названия, цвета и обычную доступность светлой/тёмной тем без заданных логотипов, поддержки и приветствия. Повторное включение возвращает сохранённое оформление. Если флаги не заданы в существующем проекте, сохраняется включённое поведение.
Что проверить после генерации
В готовом приложении проверьте доступные темы: меню, вход, длинную форму, карточку только для чтения, Content language и клавиатурный фокус. Превью не выполняет собственные экраны и не проверяет авторизацию API. Сохранение макета в Admin editor, настройка доступа в Content, генерация и публикация остаются отдельными действиями.