mage-os / theme-adminhtml-m137
mage-os/theme-adminhtml-m137
M137 Admin Theme
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:
Interfont 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
- Order
- Invoices
- Invoice
- Billing Address Edit
- Shipping Address Edit
- Invoice
- Shipments
- Shipment
- Credit Memos
- Credit Memo
- Billing Agreements
- Billing Agreement
- Transactions
- Transaction
- Orders
- 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
- Product
- Categories
- Category
- Sidebar
- Icons (folder, chevron)
- Category State Icons / Colour
- Media Gallery
- Category
- Products
- Customers
- All Customers
- Customer
- Section gaps
- Customer View
- Account Information
- Addresses
- Orders
- Shopping cart
- Newsletter
- Billing Agreements
- Product Reviews
- Wish List
- Customer
- Now Online
- Login as Customer Log
- Customer Groups
- Group
- All Customers
- Marketing
- Promotions
- Catalog Price Rule
- Price Rule
- Partially hidden on Add
- Price Rule
- Cart Price Rules
- Price Rules
- Communications
- Email Templates
- Email Template
- Insert Variable Modal
- Preview Template
- Email 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
- Insert Widget Button / TinyMCE
- 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
- Insert Widget Button / TinyMCE
- Admin Data Grid Header Row
- Newsletter Queue
- 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-splitbutton, pagebuilder standard/connected buttons toM137 Design Systemv1.1.0 - Refactor
.admin__field-labeland.control-valuetop gap, paypal reports page - Refactor modal
.messagegaps, colors - Style
Newsletter Problems Reportand customer newsletter grid - Refactor
.admin__actions-switchto toM137 Design Systemv1.1.0
[1.3.3] - 2026-02-03
Changed
- Replace
.gifloaders with.svgones
Added
- Theme name as
classattribute tobodytag
[1.3.2] - 2025-10-16
Changed
- Clean up pagebuilder transitions
- Refactor state pagebuilder
.menu-section-titleto global ui logic - Refactor state of
.admin__page-nav-titleif current - Refactor
.media-gallery-image-blockstate 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-titleis 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,Previewin tab, window - Styles for
Newsletter Queue,Add,Edit,Previewin tab, window - State icons for
Categorythree, colour, jstree-marker size
Changed
Url Rewrites,Url RewriteandAdd,Editactions,RewritetypesMedia GalleryjstreeJstreein modal slideRuletree, conditions types, fields, elementsData-grid...inside modals, first column size, control element, columns inside modals
Fixed
- Division in
.lessfiles whenparens-divisionis default
[1.2.0] - 2025-06-17
Added
- View transitions
@view-transition - Scrollbar gutter
scrollbar-gutterto 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
jstreecheckbox 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
.lessfiles whenparens-divisionis 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
- Theme is based on M137 Design System
- M137 Admin Theme Init
| 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.
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.
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.
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
| 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
| 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.
More from mage-os
View vendorGCP event sinks for mage-os/mageos-async-events
Combine the power of LLM and domain knowledge to improve admin experience though a chatbot UI.
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.