mage-os / theme-adminhtml-m137

mage-os/theme-adminhtml-m137

M137 Admin Theme

  • Artem Kozynets
magento2-theme Compatibility: 2.4.7-2.4.9 Code Quality: Pass Tests: N/A Security: Pass MIT

M137 Admin Theme

This is the Mage-OS Admin Theme

It is based on top of out of the box Magento/backend theme

Design reference: M137 Design System

[image: M137 - Building Better Commerce]

Installation

Theme requires module-theme-adminhtml-switcher to be installed

composer require mage-os/theme-adminhtml-m137
bin/magento module:enable MageOS_ThemeAdminhtmlSwitcher
bin/magento setup:upgrade

Contribution

Install the theme and the module locally

git clone [email protected]:mage-os/theme-adminhtml-m137.git ./app/design/adminhtml/MageOS/theme-adminhtml-m137/
git clone [email protected]:mage-os/module-theme-adminhtml-switcher.git ./app/code/MageOS/ThemeAdminhtmlSwitcher/

Features

  • UI update, minimalism and the aesthetic of the interface
  • New typography: Inter font family
  • New color schema, Hue Chroma Tone (HCT) color space
  • Brand new icons: Mage-OS, Magento Open Source, Page Builder

Feature/Page Coverage

  • Dashboard
  • Sales
    • Orders
      • Order
        • Billing Address Edit
        • Shipping Address Edit
        • Edit
    • Invoices
      • Invoice
        • Billing Address Edit
        • Shipping Address Edit
    • Shipments
      • Shipment
    • Credit Memos
      • Credit Memo
    • Billing Agreements
      • Billing Agreement
    • Transactions
      • Transaction
  • Catalog
    • Products
      • Product
        • Advanced Price Popup
        • Field Category
        • Section: Configuration, Popup
          • Wizard, steps
          • Section: Configuration, Popup, Columns
        • Section: Review, Icon
        • Section: Images And Videos
        • Section: Customizable Options, UI collapsible
        • Product Salable Quantity, Icon, Tooltip
        • Schedule Design Update, Datepicker
        • Section: Bundle Items
        • Section: Product in Websites, Copy Data
      • Simple Products
      • Configurable Products
      • Bundle Products
      • Virtual Products
      • Downloadable Products
      • Grouped Products
    • Categories
      • Category
        • Sidebar
        • Icons (folder, chevron)
          • Category State Icons / Colour
        • Media Gallery
  • Customers
    • All Customers
      • Customer
        • Section gaps
        • Customer View
        • Account Information
        • Addresses
        • Orders
        • Shopping cart
        • Newsletter
        • Billing Agreements
        • Product Reviews
        • Wish List
    • Now Online
    • Login as Customer Log
    • Customer Groups
      • Group
  • Marketing
    • Promotions
    • Catalog Price Rule
      • Price Rule
        • Partially hidden on Add
    • Cart Price Rules
      • Price Rules
    • Communications
    • Email Templates
      • Email Template
        • Insert Variable Modal
        • Preview Template
    • Newsletter Templates
      • New Newsletter Template
      • Newsletter Template
        • Insert Widget Button / TinyMCE
          • CMS Page Link
          • Catalog Category Link
          • Catalog New Products List
          • Catalog Product Link
          • Catalog Products List
            • Conditions (field types, rule content)
            • Input
            • Datepicker
            • Category
            • Select
            • Data Grid
          • Orders and Returns
        • Insert Image Button
        • Insert Variable Button / TinyMCE
        • Loader overlay BGC inside modal
    • Newsletter Queue
      • Newsletter Queue
        • Insert Widget Button / TinyMCE
          • CMS Page Link
          • CMS Static Block
          • Catalog Category Link
          • Catalog New Products List
          • Catalog Product Link
          • Catalog Products List
            • Conditions (field types, rule content)
            • Input
            • Datepicker
            • Category
            • Select
            • Data Grid
          • Orders and Returns
          • Recently Compared Products
          • Recently Viewed Products
        • Insert Image Button
        • Insert Variable Button / TinyMCE
      • Admin Data Grid Header Row
    • Newsletter Subscribers
      • Subscriber Grid Mass Action Select
      • Subscriber Grid Mass Action Mass Select
    • SEO & Search
    • URL Rewrites
      • URL Rewrite
      • Add URL Rewrite for
        • Custom
        • For Category
        • For Product
        • For CMS page
    • Search Terms
      • Search Term
    • Search Synonyms
      • Search Synonym
    • Site Map
      • Site Map
    • User Content
    • All Reviews
      • Review
    • Pending Reviews
      • Pending Review
  • Content
    • Elements
    • Pages
      • Page
    • Blocks
      • Block
    • Widgets
      • Widget
    • Templates
    • Media
    • Media Gallery
    • Design
    • Configuration
      • Website / Store / Store View
    • Themes
      • Theme
    • Schedule
      • Design Change
  • Reports
    • Marketing
    • Products in Cart
    • Search Terms
      • Search Term
    • Abandoned Carts
    • Newsletter Problem Reports
    • Reviews
    • By Customers
      • Customer Review
    • By Products
      • Product Review
    • Sales
    • Orders
    • Tax
    • Invoiced
    • Shipping
    • Refunds
    • Coupons
    • PayPal Settlement
      • View Transaction
    • Customers
    • Order Total
    • Order Count
    • New
    • Products
    • Views
    • Bestsellers
    • Low Stock
    • Ordered
    • Downloads
    • Statistics
    • Refresh Statistics
  • Stores
    • Settings
    • All Stores
      • Website
      • Store
      • Store View
    • Configuration
      • General
      • General
      • Web
      • Currency Setup
      • Store Email Addresses
      • Contacts
      • Reports
      • Content Management
      • New Relic Reporting
      • Advanced Reporting
      • Catalog
      • Catalog
      • Inventory
      • XML Sitemap
      • RSS Feeds
      • Email to a Friend
      • Security
      • Security.txt
      • Google reCAPTCHA Admin Panel
      • Google reCAPTCHA Storefront
      • Customers
      • Login as Customer
      • Newsletter
      • Customer Configuration
      • Wish List
      • Promotions
      • Persistent Shopping Cart
      • Sales
      • Sales
      • Sales Emails
      • PDF Print-outs
      • Tax
      • Checkout
      • Shipping Settings
      • Multishipping Settings
      • Delivery Methods
      • Google API
      • Payment Methods
      • 3D Secure
      • Services
      • Magento Web API
      • OAuth
      • Advanced
      • Admin
      • System
      • Developer
    • Terms and Conditions
      • Condition
    • Order Status
      • Status
    • Inventory
    • Sources
      • Source
    • Stocks
      • Stock
    • Taxes
    • Tax Rules
      • Rule
    • Tax Zones and Rates
      • Tax Zone and Rate
    • Currency
    • Currency Rates
    • Currency Symbols
    • Attributes
    • Product
      • Text Field
      • Text Area
      • Text Editor
      • Page Builder
      • Date
      • Date and Time
      • Yes/No
      • Multiple Select
      • Dropdown
      • Price
      • Media Image
      • Fixed Product Tax
      • Visual Swatch
      • Text Swatch
    • Attribute Set
      • Attribute Set
    • Rating
      • Rating
  • System
    • Data Transfer
    • Import
      • Import Result Step
    • Export
      • _Export Steps
    • Import/Export Tax Rates
      • Import/Export Tax Rates Result Step
    • Import History
    • Extensions
    • Integrations
      • Integration
    • Tools
    • Cache Management
    • Index Management
    • Permissions
    • All Users
      • Users
    • Locked Users
    • User Roles
      • User Role
    • Action Logs
    • Bulk Actions
      • Action Details
    • Other Settings
    • Notifications
    • Custom Variables
      • Custom Variable
    • Manage Encryption Key
  • Find Partners & Extensions

UI

  • Attribute, fields in grid type:visual
  • Attribute, fields in grid state error
  • Calendar
  • Color Picker
  • Spinner, Loader
  • Stores > Configuration: form-inline, collapsible
  • PEP > Related Products, Up-Sells, and Cross-Sells > thumbnails
  • Stores > Configuration: Customers > Wish List > General Option > Enabled: No -> borders
  • Stores > Configuration: Catalog > Catalog > Catalog Search > Button:Test Connection
  • Catalog > Products > Product > Customizable Options: gaps, state bgc
  • Stores > Attributes > Attribute Set > Icons
  • Refactor Switch

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog
and this project adheres to Semantic Versioning.

[Unreleased]

[1.3.4] - 2026-02-23

Changed

  • Refactor .actions-split button, pagebuilder standard/connected buttons to M137 Design System v1.1.0
  • Refactor .admin__field-label and .control-value top gap, paypal reports page
  • Refactor modal .message gaps, colors
  • Style Newsletter Problems Report and customer newsletter grid
  • Refactor .admin__actions-switch to to M137 Design System v1.1.0

[1.3.3] - 2026-02-03

Changed

  • Replace .gif loaders with .svg ones

Added

  • Theme name as class attribute to body tag

[1.3.2] - 2025-10-16

Changed

  • Clean up pagebuilder transitions
  • Refactor state pagebuilder .menu-section-title to global ui logic
  • Refactor state of .admin__page-nav-title if current
  • Refactor .media-gallery-image-block state color
  • Allow page action buttons to wrap
  • Remove double background and border colors
  • Remove autofill background css hack
  • Fix background color if the .admin__page-nav-title is not collapsible

[1.3.1] - 2025-09-09

Changed

Version update to support Mage-OS release version consistency

[1.3.0] - 2025-08-12

Added

  • System messages UI improvement: moved to page header actions section, added system icon trigger
  • Update .data-grid... action columns icon
  • Attribute and state icons for attribute set
  • Styles for Email Templates, View, Edit, Preview
  • Styles for Newsletter Templates, Add, Edit, Preview in tab, window
  • Styles for Newsletter Queue, Add, Edit, Preview in tab, window
  • State icons for Category three, colour, jstree-marker size

Changed

  • Url Rewrites, Url Rewrite and Add, Edit actions, Rewrite types
  • Media Gallery jstree
  • Jstree in modal slide
  • Rule tree, conditions types, fields, elements
  • Data-grid... inside modals, first column size, control element, columns inside modals

Fixed

  • Division in .less files when parens-division is default

[1.2.0] - 2025-06-17

Added

  • View transitions @view-transition
  • Scrollbar gutter scrollbar-gutter to prevent layout jumps

Fixed

  • Username text clipping
  • Footer copyright spacing
  • Media search overlapping the upload image message

[1.1.1] - 2025-04-22

Added

  • Styles for jstree checkbox selection root action buttons
  • Indent variable @indent__3xs

Changed

  • Element .mass-select... styles in data grid
  • Element .action-multicheck... styles in data grid

Fixed

  • Appearance of the .action-select, select in scope old
  • Division in .less files when parens-division is default
  • Menu non-scrollable

[1.1.0] - 2025-04-15

Fixed

  • System messages minimum height, admin notification close icon, messages section gaps
  • System messages (notification message) indent

[1.0.0] - 2025-04-09

Added

  • M137 Admin Theme
  • Installation and contribution instructions

[1.0.0-alpha] - 2025-04-08

Added

Versions
Version Stability QA Status Compatibility Released
1.3.4 stable Pass Magento 2.4.7-2.4.9 Details 2026-02-25 16:15:22
1.3.3 stable Not tested Not yet tested Details 2026-02-03 14:30:58
1.3.2 stable Not tested Not yet tested Details 2025-10-10 20:42:28
1.3.1 stable Not tested Not yet tested Details 2025-09-09 13:59:22
1.3.0 stable Not tested Not yet tested Details 2025-08-12 17:19:53
1.2.0 stable Not tested Not yet tested Details 2025-06-17 13:50:25
1.1.1 stable Not tested Not yet tested Details 2025-04-22 17:54:28
1.1.0 stable Not tested Not yet tested Details 2025-04-15 15:52:03
1.0.0 stable Not tested Not yet tested Details 2025-04-09 20:07:56

Requires 2

Package Constraint
magento/framework ^103.0
mage-os/module-theme-adminhtml-switcher ^1.0

Compatibility

Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.

Compatibility matrix (Magento × PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Pass Pass
2.4.8 Pass Pass
2.4.9 Pass Pass

Code Quality

Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge — a phpcs finding can't make a module incompatible.

Static analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

Static analysis results
Tool Status Findings Summary
PHPCS Pass 0
PHPMD Pass 0
Cpd Pass 0
Composer validate Pass 0

PHPStan

Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell → details modal.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Pass Pass
2.4.8 Pass Pass
2.4.9 Pass Pass

Tests

Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.

Unit tests

Unit tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Integration tests

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Security

Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan Pass 0
License
MIT
Authors

More from mage-os

View vendor
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.