One brand
Black structure. Violet and blue energy. Lime signal. Every product shares the same recognizable source.
↗MERZIGO ENTREPRISE UI · V2
A controlled visual language for building precise operational tools and memorable expressive products—without losing the Merzigo signal.
01 · Design philosophy
The system does not make every Merzigo screen identical. It gives different products a controlled language for making the right choices.
Black structure. Violet and blue energy. Lime signal. Every product shares the same recognizable source.
↗Behavior and accessibility stay shared. Experience context changes treatment—not interaction logic.
↗Primitive, semantic and component layers keep design decisions intentional and implementation stable.
↗Operational prioritizes throughput. Expressive prioritizes immersion. Both remain unmistakably Merzigo.
↗“Systems, not screens. Clarity over decoration. Recognition without repetition.”
02 · Experience architecture
Choose the mode from the user’s context, session length and information density—not whether the audience sits inside or outside the company.
OPERATIONAL EXPERIENCE
EXPRESSIVE EXPERIENCE
Merzigo content connected with audiences across 34 territories.
03 · Foundations
All products use the same palette. Recognition comes from disciplined roles—not product-specific colors or equal visual weight.
OPERATIONAL BALANCE
Guideline, not a CSS ruleACID LIME IS A SIGNAL
Use Lime for the exceptional KPI, important status or singular call to attention. It is not a generic success color.
BRAND COLOR SCALES
Complete ramps for interaction, depth and signal. The 500 step preserves the core brand values.50 → 950500 · #8826FF500 · #2F00FF500 · #CCFA00SYSTEM STATUS SCALES
Status colors carry meaning independently from the brand palette. Lime is never used as generic success.50 → 950500 · #16845B500 · #B66B0A500 · #D92F40500 · #06779BNEUTRAL SCALE
Canvas tones are truly neutral so brand energy keeps its impact.SEMANTIC GRADIENTS
Approved recipes. No local gradient improvisation.gradient-brand-primarygradient-brand-darkgradient-brand-atmosphericgradient-brand-signal04 · Brand assets
Download production-ready wordmarks, symbols and the official Merzigo Sans family from one controlled source.
All light/dark wordmark and symbol variants in original and optimized sizes.
Regular 400, Medium 500/600 and Bold 700/900 OTF files.
Preserve contrast, never apply effects to the logo, and always use the official files in this pack. Prefer the wordmark for primary brand communication and the symbol for compact spaces and product iconography.
05 · Typography
Merzigo Sans is the official interface and brand typeface, tuned for clear operational reading and confident expressive moments.
DISPLAY / BOLDAa
UI / REGULARAa
CONTROL / MEDIUMAa
One brand. Two experiences.
64–96 / 0.95Expressive hero onlyDesign foundations
40–56 / 1.0Primary page titleSemantic tokens
28–36 / 1.1Documentation sectionInterfaces that unlock content value.
16 / 1.6Long-form and UI copyMZ-2048 · APPROVED
11–13 / 1.4IDs, metadata, tokensOFFICIAL BRAND FAMILY Merzigo Sans is bundled locally and used across this showroom. Download Regular, Medium and Bold OTF files ↓
06 · Shape & spacing
A 4px micro-grid, 8px macro rhythm and restrained corner system create precision without turning every component into a polygon.
SIGNATURE ANGLE · 30°Derived from the Merzigo mark. Use it for hero frames, media, selected states and major transitions—not every button or field.
RADIUS SCALE
Sharper by designSPACING SCALE
4px micro grid · 8px macro rhythm481216243248648096BORDER SYSTEM
Structure before shadowELEVATION
Mode-aware depth07 · Token architecture
Three layers keep brand changes safe, themes intentional and component APIs semantic. Components never need to know a raw hex value.
CSS VARIABLES · LIVEBrand color, neutral, spacing, radius and motion scales.
--violet-500--space-6--portal-cut-surface--technical-grid-sizeTheme-aware decisions expressed by purpose rather than appearance.
--color-text-primary--color-border-default--color-focus--color-successSpecific values used only where shared component anatomy needs them.
--button-primary-background--brand-mark-tile--portal-outline--sidebar-active-indicatorSEMANTIC TOKENS · LIVE THEME
Use the Light / Dark / System control above. Every value and example updates together.--color-background-primary--color-surface--color-text-primary--color-text-muted--color-border-default--color-interactive-primary--color-focus--color-success08 · Materials & motion
Glass is an Expressive material, not the definition of Expressive design. Motion explains change first and creates atmosphere only when the context earns it.
GLASS-SUBTLEQuiet separation8px blur · 10% fillGLASS-STANDARDFloating controls18px blur · 55% fillGLASS-HEROFeature moment28px blur · 64% fillSolid fallback Every material remains legible when backdrop-filter is unavailable.
Reduced transparency Glass becomes an opaque, high-contrast surface.
Sharp silhouette Portal cuts replace soft glass capsules.
Fast state change. No ambient movement.
Choreographed depth and reveal, used sparingly.
09 · Components / Actions
Buttons initiate an action. Treatment can respond to experience context, while anatomy, keyboard behavior and semantic APIs stay shared.
LIVE PREVIEW · OPERATIONAL
Click the preview button to toggle loading.Use Primary once per action cluster. Secondary supports alternative paths. Destructive always states the irreversible result.
Visible label, 44px touch target where needed, native disabled state and an announced loading label. Never rely on color alone.
Black, white-on-dark or the approved Violet → Blue gradient are contextual. Lime is exceptional, never the default submit color.
<Button
variant="primary"
size="md"
loading={false}
disabled={false}
>
Approve content
</Button>10 · Components / Forms
Forms are explicit, forgiving and structured. Labels remain visible, focus is unmistakable and validation waits until it can be useful.
40pxACCESSIBLEKEYBOARD READYDRAG + SELECTLOCALIZED4 STATESPlaceholder text never carries the only label.
Do not punish incomplete input during every keystroke.
Say what happened and exactly how to resolve it.
Use native select for short lists, a listbox for richer options and combobox when users need to filter.
4 OPTIONS2 SELECTED6 OPTIONSSelect for one short bounded list; multi-select for a small set; combobox when users know what they are looking for.
Arrow keys move through options, Enter commits, Escape closes and typeahead jumps to a matching value.
Labels stay visible, selected values remain readable and validation explains exactly what is missing.
11 · Components / Handbook
A practical operating manual for choosing, composing and shipping Merzigo components with consistent behavior, hierarchy and motion.
Choose components from the user’s task and decision—not from visual preference.
Default, hover, focus, loading, empty, error and disabled states are part of the component.
Operational and Expressive modes may change treatment, never interaction logic.
Keep the common path calm; disclose advanced controls when context makes them useful.
Animate entry, exit, hierarchy and state. Never add movement without information.
Errors describe what happened, preserve input and give one clear next action.
USE BEFORE BUILDINGWhat decision or task must become easier?
Can an existing component and behavior solve it?
What happens before, during, after and when it fails?
Keyboard, contrast, responsive and reduced-motion checks.
Operational motion confirms. Expressive motion orients and stages. Both remain interruptible.
140ms · operational180ms · stagger 30ms320ms · expressiveShow where an overlay came from, confirm a state change and preserve spatial continuity.
No looping decoration in operational workflows. Motion stops when its message is understood.
Replace travel and scale with instant state changes or short opacity transitions.
11.1 · Components / AI handoff
Give an AI agent this design-system link and the generated prompt. It receives a reading order, preservation rules, implementation sequence and definition of done—enough to update a real product, not merely imitate a screenshot.
The current page URL is inserted automatically. Add the app or repository the agent can access, choose a direction, then copy one complete prompt.
The prompt separates product truth from design-system truth, tells the agent exactly what to inspect and requires implementation plus verification—not a visual audit alone.
Localhost note The agent must run on the same machine. Otherwise use a reachable URL or attach screenshots and exported files.
You are a senior product designer and frontend engineer. Update the target product so it uses the Merzigo Entreprise UI v2 design language. Work autonomously from audit through implementation and verification. Do not stop after suggestions or a component map; make the changes unless access, missing source files or a destructive decision genuinely blocks you.
DESIGN-SYSTEM REFERENCE
http://localhost:3000
TARGET PRODUCT
[PASTE THE TARGET APP URL OR REPOSITORY PATH HERE]
OBJECTIVE
Transfer the design system—not the showroom demo—into the target product. Preserve the target product's business logic, content, information architecture, routes, data contracts, permissions, analytics and core workflows. The target product remains the source of truth for what the product does; the Merzigo reference is the source of truth for visual language, component behavior and interaction quality.
REFERENCE READING ORDER
Open the design-system reference and inspect these sections before editing:
1. Intent and mode: http://localhost:3000#philosophy and http://localhost:3000#experience-modes
2. Foundations: http://localhost:3000#color, http://localhost:3000#typography, http://localhost:3000#shape-spacing, http://localhost:3000#tokens and http://localhost:3000#materials-motion
3. Product shell and composition: http://localhost:3000#navigation and http://localhost:3000#workspace-patterns
4. Components and states: http://localhost:3000#buttons, http://localhost:3000#forms, http://localhost:3000#cards, http://localhost:3000#detail-panel, http://localhost:3000#utility-patterns and http://localhost:3000#component-index
5. Data interfaces: http://localhost:3000#data-grid and http://localhost:3000#data-visualization
6. Quality bar: http://localhost:3000#accessibility, http://localhost:3000#developer-api and http://localhost:3000#do-dont
If you cannot browse the reference, do not invent the design language. Ask for a reachable public URL, screenshots or the exported design-system files. A localhost URL is reachable only when you run on the same machine.
EXPERIENCE DIRECTION
Choose Operational or Expressive per screen from the user task, session length and information density. A product may switch modes between screens, but never mix both modes inside one view.
NON-NEGOTIABLE VISUAL RULES
- Use Merzigo Sans for interface and brand typography. Preserve sensible system fallbacks.
- Use black and neutrals for structure; Violet and Blue for interaction and energy; Lime only as a rare exceptional signal. Semantic success is green, warning is amber, danger is red and information is cyan.
- Use semantic tokens instead of scattering raw hex values through components.
- Use a 4px micro-grid, an 8px macro rhythm and restrained corner radii.
- Use the portal cut only on approved high-signal surfaces. Cut the top-right corner: 8px for marks, 12px for cards and bounded surfaces, 16px for page headers and command surfaces.
- Use a 2px Violet/Blue signal rail to connect related portal surfaces. Lime stays below 5% of a composition.
- Technical grids use a 28px cell and stay inside identity or terminal surfaces; never apply them as page-wide decoration.
- Form controls use one visible 2px focus border. Do not stack border, outline and halo.
- Motion explains entry, exit, hierarchy or state. Keep it interruptible and provide a reduced-motion equivalent.
- Do not add borders to every button or navigation item. Use spacing, surface, text weight and one deliberate active indicator to create hierarchy.
PRODUCT COMPOSITION RULES
- The 56px Topbar owns product identity, global modules, global search and account utilities.
- A contextual Sidebar owns only the active module's local hierarchy. Do not duplicate global navigation.
- On narrow screens, reduce the Sidebar to a 56px icon rail before moving it into an overlay.
- A Portal Header contains page identity, description, stable module context and at most one page-level action.
- A Metric Strip follows a header only when the metrics orient the current workspace.
- A Data Terminal orders technical rail, query controls, result utilities and work surface. Keep filters separate from display controls.
- Portal Cards represent one bounded object, metric or action and have one dominant hit area.
- Master-detail layouts preserve the selected source row while detail loads independently. On mobile, promote detail to a full-width view with a clear return path.
- Choose charts by the question: line for continuous trends, horizontal bars for ranking, donut or stacked bars for small stable compositions, and heatmaps for density across two dimensions.
IMPLEMENTATION METHOD
1. Inspect the target before editing. Inventory routes, layouts, shared components, tokens, states, responsive behavior, accessibility semantics and installed UI primitives.
2. Produce a concise mapping: target pattern → closest Merzigo pattern → reuse/extend/new → relevant state and responsive risks.
3. Establish primitive, semantic and component tokens first. Support light and dark themes without duplicating component CSS.
4. Update the app shell and shared primitives before page-specific surfaces. Reuse the target project's framework, architecture and installed accessible primitives.
5. Migrate representative high-traffic screens, then complete remaining in-scope screens consistently. Preserve working content and behavior throughout.
6. Cover default, hover, focus, active, selected, loading, empty, error, disabled, success and permission states wherever they apply.
7. Verify at desktop and mobile widths, in light and dark themes, with keyboard-only use and reduced motion enabled.
8. Fix issues found during verification. Do not leave the task at the audit or mockup stage.
IMPLEMENTATION RULES
- Keep component APIs semantic: variant, tone, density, experience and state.
- Extend an existing Merzigo pattern before inventing a new one.
- Keep native semantics and visible labels. Icon-only actions need an accessible name and an appropriate tooltip.
- Meet WCAG 2.2 AA and never rely on color alone.
- Preserve validation behavior, form values, loading, empty, error, permission and recovery states.
- Do not copy the showroom's titles, people, metrics or sample records into the product.
- Do not replace real product imagery with CSS-drawn representational art.
- Do not rewrite working business logic unless a styling integration requires a minimal, explained change.
- Do not introduce a second overlapping component library merely to reproduce the look.
DEFINITION OF DONE
- The target product is recognizable as the same product and works as before.
- Shared token and component layers carry the visual system; page files do not contain repeated one-off styling.
- Operational/Expressive mode, density and theme choices are intentional and consistent.
- Every changed workflow includes its relevant loading, empty, error, disabled and success states.
- Desktop and mobile layouts work without clipped controls or hidden primary actions.
- Keyboard order, focus return, accessible names, contrast and reduced motion are verified.
- No showroom sample content or unexplained design-system exception remains.
- The project's lint, type-check, tests and production build pass when those commands exist.
FINAL RESPONSE
Report:
1. What you audited and the mapping you used.
2. What you implemented, grouped by tokens, shared components and screens.
3. What you verified and the commands/checks that passed.
4. Any intentional exception, missing asset or remaining blocker.
Begin by inspecting both references and stating the implementation order briefly, then continue directly into the changes without waiting for approval.These anchors are embedded in the generated prompt so a browsing agent reads intent before pixels and quality rules before completion.
Understand the philosophy, then select Operational or Expressive from the task—not from decoration.
Extract color, type, spacing, shape, material and semantic token decisions before component styling.
Map the target shell and shared controls to product-proven navigation, workspace and component patterns.
Finish with data behavior, accessibility, implementation guidance and explicit do/don’t decisions.
The agent is instructed to keep working until the target behaves correctly, passes its checks and uses the shared system without copying showroom content.
How to use: open this section, enter the target, copy the generated prompt and send it to the agent together with access to the target project. No additional design explanation should be necessary.
12.1 · Components / Compositions
Repeated Atlas workflows establish a shared composition for page identity, live context, dense filtering, result utilities and in-place detail. Products should compose these patterns before inventing screen-specific chrome.
Filter the content universe, compare signals and move decisions forward.
matching titles
matching films
matching series
QUERY / FILTER / RESULTSThese values were refined in a working product. Reuse them as a family so portal surfaces stay related across themes and modules.
Use 8px for marks, 12px for cards and 16px for command surfaces. Cut only the top-right corner.
8 / 12 / 16pxUse a 28px grid inside headers and terminal rails. Fade it before dense content begins.
28px · ≤ 4.5% lineLight surfaces keep a violet atmosphere, not flat white. A white brand mark always sits on a dark tile.
semantic contrastBlack frames structure, Violet and Blue mark energy, and Lime appears only for live or exceptional signals.
2px rail · <5% LimeCreation cards and activity terminals reuse the same cut, rail and state rules without copying the full catalog layout.
Quarterly candidates, priority territories
Keep filters visible and explain where future items will appear.
Keep title and description on the left; stable module metadata, live state and one page-level action on the right. Stack them on narrow screens.
Group scope and filters first. Separate saved views, columns, density and pagination so users can distinguish “what is shown” from “how it is shown.”
Use 36px Compact, 44px Standard and 52px Comfortable rows. Standard is the default; persist the choice per user, not per page.
Keep the selected source row visible while the detail pane loads independently. On mobile, promote detail to a full-width view with a clear return path.
Wrap filters by priority and intentionally choose horizontal scrolling or summary cards. Never squeeze every desktop column into a mobile table.
Empty, no results and request failure are different states. Preserve filters and selection, explain what happened and offer one relevant next action.
13 · Components / Cards
Cards package a single idea, decision or destination. Their anatomy stays consistent while media, hierarchy and action density respond to the content.
OPERATIONAL TREATMENTGlobal · Rights clear
EMEA · Review due today
Start a rights, edit or distribution workflow with the required context.
A card represents one object, metric or action. Split competing destinations instead of adding more controls.
Use one primary hit area and keep nested actions explicit. Focus and hover cover the same interactive region.
Every card family uses the same top-right portal cut. Keep its depth consistent instead of resizing it by card type.
14 · Components / Overlays
A right-side detail panel keeps users in context while they inspect, edit or resolve one record. It complements dense lists without replacing full-page workflows.
Enough room for structured edits without feeling like a second page.
Use a light scrim and preserve the source selection behind the panel.
Close button, Escape and scrim all return focus to the trigger.
15 · Components / Completion set
The remaining shared patterns are specified here with usable states, semantic structure and keyboard-ready behavior. The component index is now fully stable.
BREADCRUMB · STEPPER · COMMAND PALETTELIST · TIMELINE · ACTIVITY FEED3 RECORDSRELEASE WINDOWAdded final cut and EMEA notes.
10:42Germany and France moved to Q4.
09:18Processing completed successfully.
YesterdayMENU · ACCORDION · MODAL16 · Component index
All shared patterns now have a stable specification or a product-proven reference. Operational and Expressive experiences use the same behavior and accessibility foundation.
17 · Data / Critical component
The grid is a workflow surface, not a styled HTML table. Selection, density, filtering, row actions and contextual detail belong to one coherent system.
| CONTENT TITLE | PLATFORM | TERRITORY | STATUS | Actions | ||
|---|---|---|---|---|---|---|
01 Series · S01 E04 | YouTube | Global | 184.2M | Approved | ||
02 Series · S02 E08 | EMEA | 92.7M | Review | |||
03 Documentary · Feature | YouTube | LATAM | 66.4M | Processing | ||
04 Series · S03 E01 | TikTok | Global | 48.1M | Approved | ||
05 Factual · S02 E12 | YouTube | MENA | 31.8M | Blocked | ||
06 Drama · Feature | APAC | 29.4M | Review |
36px compact · 44px standard · 52px comfortable
Tab, arrows, Space selection, Enter action
Sticky identity column + horizontal scroll
Required above ~200 visible records
Tabular figures · right aligned
Truncate with a focusable full-value affordance
A grid specification is incomplete without recovery and progress.
18 · Data visualization
Charts use dedicated visualization tokens. Hue communicates grouping; semantic colors appear only when their meaning actually applies.
vs previous 90d
vs previous 90d
vs previous 90d
Each chart keeps a visible title, units, legend and text equivalent. Interaction may reveal detail, but never hides the core comparison.
Türkiye selected for comparison.
Change over continuous time
Compare named categories
Show a small, stable composition
Find peaks across two dimensions
Prefer shades of one hue for ordered magnitude.
Use the controlled visualization palette, not brand colors by default.
Lime identifies the selected or important series only.
19 · Accessibility
WCAG 2.2 AA is the minimum standard for every mode, theme and component state. Premium design that excludes is unfinished design.
WCAG 2.2 AA minimum. Text, icons and focus all pass in both themes.
Every action is reachable, ordered logically and operable without a pointer.
A visible 2px focus indicator is never removed or hidden by overflow.
Reduced Motion removes choreography while preserving state comprehension.
Reduced Transparency replaces glass with solid, high-contrast surfaces.
Interactive targets reach 44×44px when touch is a primary input.
Labels, descriptions and errors are programmatically associated.
Meaning is never communicated with color alone; text and shape reinforce it.
VISIBLE FOCUS
Focus is a brand moment and a navigation tool.2px · color-focus · single borderCollapse spatial movement to instant or opacity-only state change.
Replace blur with an opaque semantic surface and preserve hierarchy.
Reading and actions remain available at 400% zoom without two-dimensional scrolling.
20 · Developers
APIs describe purpose. Experience, theme and density flow through shared context without splitting the component ecosystem.
<MerzigoProvider
theme="system"
experience="operational"
density="compact"
>
<Button variant="primary" size="md">
Approve
</Button>
<Badge tone="success">Approved</Badge>
</MerzigoProvider>SEMANTIC · TYPED<Button variant="primary" /><PurpleRoundedButton />Consume semantic CSS variables in application surfaces.
Choose semantic variants with typed props.
Theme, density and experience cascade predictably.
21 · Reference
Rules are most useful at decision time. These paired examples clarify the difference between using the language and simply decorating with it.
Let Violet and Blue identify interactions and major expressive moments.
Neutral space is what gives the brand palette room to feel powerful.
Reserve it for the singular KPI, special status or exceptional signal.
Success is semantic green. Brand signal and system status are different jobs.
Use the portal cut for media, heroes and a few high-signal transitions.
Buttons, fields and tables should stay precise and familiar.
Place controlled glass over content or atmospheric brand surfaces.
Operational interfaces stay mostly solid, bordered and efficient.
22 · Changelog
Changes are deliberate, documented and designed to improve shared decisions rather than create local exceptions.
One brand. Two experiences.
27 AUGUST 2026Introduced shared Operational and Expressive modes, replacing audience-based tracks.
Primitive, semantic and component tokens now power intentional light and dark themes.
Sharper geometry, controlled portal cuts and three accessible glass levels.
Interactive guidance for buttons, forms, navigation, cards, data grid and visualization.
Added product-proven App Shell, icon rules, Portal Cards, chart patterns, technical grids and signal rails.
Product-validated page headers, query and results toolbars, three density modes, master-detail behavior and recoverable states.
If a pattern appears twice, bring it into the system. Every contribution needs a use case, accessibility review, API rationale and migration note.