# mage-os/theme-adminhtml-m137
> M137 Admin Theme
`composer require mage-os/theme-adminhtml-m137`
Canonical URL: https://packagento.com/mage-os/theme-adminhtml-m137
## At a glance
- **Vendor**: mage-os (https://packagento.com/mage-os.md)
- **Latest version**: 1.3.4 — released 2026-02-25
- **Pricing**: Free
- **Package type**: Magento 2 theme
- **Status**: active, accepting new buyers
## Installation
Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.
1. **Sign in or create an account** at https://packagento.com/customer/account/.
2. **Add the package to your account.** Open https://packagento.com/mage-os/theme-adminhtml-m137 and complete the free checkout. A licence is minted automatically.
3. **Create or pick a project, then activate the licence on it.**
- Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
- Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.
4. **Add the project credentials to your Magento codebase.**
Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:
```json
{
"http-basic": {
"packagento.com": {
"username": "ppk_live_...",
"password": "psk_live_..."
}
}
}
```
Add the Packagento Composer repository to `composer.json`:
```json
{
"repositories": [
{ "type": "composer", "url": "https://packagento.com" }
]
}
```
5. **Install and apply.**
```bash
composer require mage-os/theme-adminhtml-m137:*
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```
## What it does
M137 Admin Theme
## README
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](https://www.figma.com/community/file/1486802857979032188)
### Installation
Theme requires [module-theme-adminhtml-switcher](https://github.com/mage-os-lab/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 git@github.com:mage-os/theme-adminhtml-m137.git ./app/design/adminhtml/MageOS/theme-adminhtml-m137/
git clone git@github.com: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
- [x] Dashboard
- [x] Sales
- [x] Orders
- [x] Order
- [x] Billing Address Edit
- [x] Shipping Address Edit
- [x] Edit
- [x] Invoices
- [x] Invoice
- [x] Billing Address Edit
- [x] Shipping Address Edit
- [x] Shipments
- [x] Shipment
- [x] Credit Memos
- [x] Credit Memo
- [x] Billing Agreements
- [x] Billing Agreement
- [x] Transactions
- [x] Transaction
- [x] Catalog
- [x] Products
- [x] Product
- [x] Advanced Price Popup
- [x] Field Category
- [x] Section: Configuration, Popup
- [x] Wizard, steps
- [x] Section: Configuration, Popup, Columns
- [x] Section: Review, Icon
- [x] Section: Images And Videos
- [x] Section: Customizable Options, UI collapsible
- [x] Product Salable Quantity, Icon, Tooltip
- [x] Schedule Design Update, Datepicker
- [x] Section: Bundle Items
- [x] Section: Product in Websites, Copy Data
- [x] Simple Products
- [x] Configurable Products
- [x] Bundle Products
- [x] Virtual Products
- [x] Downloadable Products
- [x] Grouped Products
- [x] Categories
- [x] Category
- [x] Sidebar
- [x] Icons (folder, chevron)
- [x] Category State Icons / Colour
- [x] Media Gallery
- [x] Customers
- [x] All Customers
- [x] Customer
- [x] Section gaps
- [x] Customer View
- [x] Account Information
- [x] Addresses
- [x] Orders
- [x] Shopping cart
- [x] Newsletter
- [x] Billing Agreements
- [x] Product Reviews
- [x] Wish List
- [x] Now Online
- [x] Login as Customer Log
- [x] Customer Groups
- [x] Group
- [x] Marketing
- Promotions
- [x] Catalog Price Rule
- [x] Price Rule
- [x] Partially hidden on Add
- [x] Cart Price Rules
- [x] Price Rules
- Communications
- [x] Email Templates
- [x] Email Template
- [x] Insert Variable Modal
- [x] Preview Template
- [x] Newsletter Templates
- [x] New Newsletter Template
- [x] Newsletter Template
- [x] Insert Widget Button / TinyMCE
- [x] CMS Page Link
- [x] Catalog Category Link
- [x] Catalog New Products List
- [x] Catalog Product Link
- [x] Catalog Products List
- Conditions (field types, rule content)
- [x] Input
- [x] Datepicker
- [x] Category
- [x] Select
- [x] Data Grid
- [x] Orders and Returns
- [x] Insert Image Button
- [x] Insert Variable Button / TinyMCE
- [x] Loader overlay BGC inside modal
- [x] Newsletter Queue
- [x] Newsletter Queue
- [x] Insert Widget Button / TinyMCE
- [x] CMS Page Link
- [x] CMS Static Block
- [x] Catalog Category Link
- [x] Catalog New Products List
- [x] Catalog Product Link
- [x] Catalog Products List
- Conditions (field types, rule content)
- [x] Input
- [x] Datepicker
- [x] Category
- [x] Select
- [x] Data Grid
- [x] Orders and Returns
- [x] Recently Compared Products
- [x] Recently Viewed Products
- [x] Insert Image Button
- [x] Insert Variable Button / TinyMCE
- [x] Admin Data Grid Header Row
- [x] Newsletter Subscribers
- [x] Subscriber Grid Mass Action Select
- [x] Subscriber Grid Mass Action Mass Select
- SEO & Search
- [x] URL Rewrites
- [x] URL Rewrite
- [x] Add URL Rewrite for
- [x] Custom
- [x] For Category
- [x] For Product
- [x] For CMS page
- [x] Search Terms
- [x] Search Term
- [x] Search Synonyms
- [x] Search Synonym
- [x] Site Map
- [x] Site Map
- User Content
- [x] All Reviews
- [x] Review
- [x] Pending Reviews
- [x] Pending Review
- [x] Content
- Elements
- [x] Pages
- [x] Page
- [x] Blocks
- [x] Block
- [x] Widgets
- [x] Widget
- [x] Templates
- Media
- [x] Media Gallery
- Design
- [x] Configuration
- [x] Website / Store / Store View
- [x] Themes
- [x] Theme
- [x] Sch
_(README truncated for .md surface. Full README on https://packagento.com/mage-os/theme-adminhtml-m137.)_
## Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
### [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
- Theme is based on [M137 Design System](https://www.figma.com/community/file/1486802857979032188)
- M137 Admin Theme Init
## Recent Versions
| Version | Released |
|---|---|
| 1.3.4 | 2026-02-25 |
| 1.3.3 | 2026-02-03 |
| 1.3.2 | 2025-10-10 |
| 1.3.1 | 2025-09-09 |
| 1.3.0 | 2025-08-12 |
| 1.2.0 | 2025-06-17 |
| 1.1.1 | 2025-04-22 |
| 1.1.0 | 2025-04-15 |
| 1.0.0 | 2025-04-09 |
## Dependencies
### Require
| Package | Constraint |
|---|---|
| mage-os/module-theme-adminhtml-switcher | ^1.0 |
| magento/framework | ^103.0 |
## Quality
Latest release (1.3.4) passes the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.
### Compatibility
Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.
| 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. Never affect the Compatibility verdict — 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.
| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Pass | 0 | |
| PHPMD | Pass | 0 | |
| Cpd | Pass | 0 | |
| Composer validate | Pass | 0 | |
#### PHPStan
Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.
| 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 per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.
#### 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
Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.
| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 | |
| Malware scan | Pass | 0 | |
## Licence and pricing
Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.
Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.
## Install via Claude Code or any MCP client
The Packagento MCP server can run the licence + project + Composer steps above in one tool call:
```
purchase_and_install_packages(
composer_names=["mage-os/theme-adminhtml-m137"],
project_id="proj_xxx"
)
```
This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.
## Vendor
mage-os is a Magento 2 vendor on Packagento. See https://packagento.com/mage-os.md for their full catalogue.