Package layout
This page explains the expected ModernUI package layout and where each part belongs inside MetaTrader 5.
ModernUI.zip is the package the ModernUI Launcher EA downloads from MQL5 Market — see Download from MQL5 Market for how to fetch it inside MT5. The launcher itself is shipped as a compiled .ex5 and is not part of this zip.
Typical package structure
A ModernUI package is normally organised like this:
ModernUI/
Include/
ModernUI/
ModernUI.mqh
...library headers...
Images/
ModernUI/
ModernUI_Icons_16.png
ModernUI_Icons_20.png
ModernUI_Icons_24.png
Experts/
ModernUI/
Examples/
...example EAs...
Docs/
ModernUI/
README.md
QUICK_START.md
FAST_WRAPPERS.md
...offline docs...
Your package may be wrapped in a top-level folder or zip name, but the important folders are Include, Images, Experts, and Docs.
Include folder
The include folder contains the library source files.
Copy:
Include/ModernUI/
To:
MQL5/Include/ModernUI/
After installation, this file should exist:
MQL5/Include/ModernUI/ModernUI.mqh
Most EAs and indicators should include ModernUI with:
#include <ModernUI\ModernUI.mqh>
Images folder
The package includes optional runtime icon atlas images under:
Images/ModernUI/
Copy them to:
MQL5/Images/ModernUI/
These files improve the quality of common toolbar and button icons. If they are not present, ModernUI falls back to canvas-drawn icons.
Experts examples folder
Example Expert Advisors live under:
Experts/ModernUI/Examples/
Copy them to:
MQL5/Experts/ModernUI/Examples/
The examples are useful for:
- checking the install
- seeing working
MuiRootsetup - learning event forwarding
- testing controls
- copying panel composition patterns
Docs folder
Offline docs may be included under:
Docs/ModernUI/
These are useful when working locally, but the website documentation is the main long-term reference.
The website docs are easier to search, update, link, and maintain.
Important folders at a glance
| Folder | Purpose | Installed into MT5? |
|---|---|---|
Include/ModernUI |
Library headers and source | Yes, copy to MQL5/Include/ModernUI |
Images/ModernUI |
Optional built-in icon atlas PNGs | Recommended, copy to MQL5/Images/ModernUI |
Experts/ModernUI/Examples |
Runnable example EAs | Optional but recommended |
Docs/ModernUI |
Offline Markdown docs | Optional reference |
Examples you may see
Common examples include:
BasicPanel.mq5
FriendlyAliases_Demo.mq5
KitchenSink.mq5
DataTable.mq5
FastWrappers_CompactTradePanel_Demo.mq5
FastWrappers_Phase2A_Demo.mq5
FastWrappers_Phase2B_Demo.mq5
FastWrappers_Phase4A_Demo.mq5
ModernUI_Performance_StressTest.mq5
Some packages may also include showcase demos under:
Experts/ModernUI/Examples/Demos/
Trade-style showcase demos are UI demonstrations only unless you add your own execution logic.
What not to move manually
Avoid editing or rearranging internal ModernUI include files unless you know what you are changing.
The safest setup is to keep the entire Include/ModernUI folder together and use the standard umbrella include.
Vendor prefix note
Some distribution systems may place includes under a vendor prefix. If your package is intentionally shipped that way, use the include path documented by that package.
For the standard layout used in these docs, the include is:
#include <ModernUI\ModernUI.mqh>
Next step
You now have the foundation: what ModernUI is, who it is for, what is included, how to install it, and how to compile a first panel.
Continue with Build UIs Faster to learn the fast wrapper layer.