README

evo-ui is the Livewire + DaisyUI foundation for modern Evolution CMS manager modules. It is a technical package, not a standalone manager module.

The package lets modules such as sArticles and dIssues render modern manager screens without pulling legacy manager CSS, jQuery, Bootstrap, main.js, tabpane.js, Roboto, or CDN assets into the iframe.

What It Provides

x-evo::layout manager iframe shell with local CSS/JS assets.
Evolution manager theme sync for evolight, evolightness, evodark, and evodarkness.
Livewire 4 bridge for Evolution manager routes, sessions, CSRF, assets, and minimal Laravel-style services.
Config-driven module tables with table/list views, filters, sorting, pagination, inline edit, modal edit, row actions, drag reorder, and session state persistence.
Config-driven forms for manager settings and resource-like forms.
Provider-backed issue/workspace surface used by dIssues.
Shared Blade components for buttons, icons, tabs, modals, cards, badges, choices, image fields, rich editors, and table cells.
Guarded module tabs with an optional navigationAside slot for status badges and other navigation accessories.
Gradual wide-workspace typography and readable field descriptions, with a shared sanitizer for administrator-authored inline HTML.

Consumers

sArticles: publications, dictionaries, settings, article editor, sSeo and sLang integration surfaces.
dIssues: issue tables, settings forms, kanban/list issue workspace and conversation preview.
sTask, sSettings, sLang, sSeo, and dDocs also use EvoUI in their migrated manager surfaces; maintained branches may still have legacy screens.

Install In A Module

{
  "require": {
    "evolution-cms/evo-ui": "^1.2"
  }
}

Render an evo-ui-owned manager document:

<x-evo::layout :title="$pageTitle">
    <x-evo::module-tab-shell :tabs="$tabs" model="activeTab">
        <livewire:evo-ui.module-table
            preset="vendor.module.items"
            :context="['moduleUrl' => $moduleUrl]"
        />
    </x-evo::module-tab-shell>
</x-evo::layout>

Publish EvoUI assets after install or update:

php artisan vendor:publish --tag=evo-ui --force

Evolution CMS 3.5.7+ understands EvoUI asset declarations as symlink publishables. The public files under assets/modules/evo-ui are linked to the package runtime when possible, so modules do not keep stale copied CSS or JS after an EvoUI update. On hosting where symlinks are unavailable, vendor:publish falls back to copying the files.

Documentation

Start from docs/. The navigationAside slot and DescriptionHtml helper are new in the forthcoming 1.3 release; consumers using them must require ^1.3 after that release is published.

docs/en/guide/module-integration.md: module shell, assets, provider registration and examples.
docs/en/components/module-table-contract.md: table, list, filters, modal and provider contracts.
docs/en/components/README.md: component catalogue and usage.
docs/en/guide/consumers.md: how sArticles and dIssues currently consume evo-ui.
docs/en/guide/release-checklist.md: first-release readiness checklist.
docs/en/guide/roadmap.md: useful base components to add before migrating sLang and sSeo.

Localized entrypoints:

Localization

UI dictionaries are available in Ukrainian, English, German, French and Polish. Ukrainian is the completeness reference: every supported dictionary must have the same keys and interpolation placeholders. Russian intentionally loads the Ukrainian dictionary instead of maintaining separate translations. Russian documentation entrypoints link to their Ukrainian counterparts, so corrections have a single source.

Update every localized documentation page affected by a public API change. The localization consistency checks run as part of composer test.

Tests

Run the package smoke/contract suite from the package root:

composer test

Run a PHP syntax pass before release:

find src config lang tests -name '*.php' -print0 | xargs -0 -n1 php -l

Release Notes

This package is release-ready when:

all consumer modules use evo-ui-owned iframe documents;
no new screen mixes evo-ui with legacy manager UI bundles;
session state persistence works for table/workspace filters and views;
docs, translations, assets and smoke tests are updated together.

evolution-cms / evo-ui

Package info

Security

Statistics