1---
2name: sap-fiori-guidelines
3description: SAP Fiori design guidelines for building enterprise applications. Use this skill when designing, building, or reviewing SAP Fiori applications, implementing SAPUI5 or UI5 Web Components, working with SAP enterprise UX patterns, or needing guidance on buttons, forms, tables, object pages, list reports, navigation, messaging, colors, typography, accessibility, AI/Joule integration, or any SAP Fiori UI element. Triggers on mentions of Fiori, SAPUI5, UI5, SAP UX, SAP design system, or enterprise application design following SAP standards.
4metadata:
5 source: https://skillmd.com/skills/sap/sap-fiori-guidelines
6---
7
8# SAP Fiori Design Guidelines
9
10Comprehensive guidance for designing and building SAP Fiori applications following official SAP design system standards.
11
12## When to Use This Skill
13
14- Designing or building SAP Fiori applications
15- Implementing SAPUI5 or UI5 Web Components
16- Following SAP enterprise UX patterns
17- Choosing UI elements for SAP applications
18- Implementing navigation, messaging, or data visualization
19- Ensuring accessibility and inclusive design
20- Applying colors, typography, or visual styling
21- Designing AI-powered features, Joule integration, or guided prompts
22
23## Core Principles
24
25SAP Fiori is built on five principles:
26
271. **Role-based** - Designed for specific user roles and tasks
282. **Adaptive** - Works across devices and screen sizes
293. **Coherent** - Consistent experience across all SAP applications
304. **Simple** - Focused on essential tasks, reduces complexity
315. **Delightful** - Engaging and intuitive user experience
32
33## Technology Options
34
35| Technology | Use Case |
36|------------|----------|
37| SAPUI5 | Full SAP Fiori applications, SAP BTP, S/4HANA |
38| UI5 Web Components | Framework-agnostic, React/Vue/Angular integration |
39| SAP Fiori Elements | Metadata-driven apps with OData services |
40
41## Reference Documentation
42
43Read the appropriate reference file based on your task:
44
45### UI Elements
46
47| Reference | Contents |
48|-----------|----------|
49| `references/ui-actions.md` | Buttons, links, toggle buttons, menu buttons |
50| `references/ui-inputs.md` | Input fields, selects, checkboxes, radio buttons, sliders, date/time pickers, filter bar |
51| `references/ui-containers.md` | Panels, cards, dialogs, popovers, toolbars, forms, shell bar, user menu, notification center |
52| `references/ui-display.md` | Avatars, progress indicators, busy indicators, illustrated messages |
53| `references/ui-lists-tables.md` | Responsive tables, grid tables, analytical tables, grid lists, lists |
54| `references/ui-navigation.md` | Icon tab bar, segmented button, side navigation, shell search |
55| `references/ui-messages.md` | Message strips, message strip web component |
56| `references/ui-ai.md` | AI button, AI notice, AI writing assistant, AI acknowledgment, guided prompts, quick prompts, regenerate, home page banner |
57| `references/ui-upload.md` | Upload set with table plugin |
58
59### Page Types & Floorplans
60
61| Reference | Contents |
62|-----------|----------|
63| `references/page-types.md` | Object page, list report, analytical list page, overview page, dynamic page layout, page header |
64
65### Foundations
66
67| Reference | Contents |
68|-----------|----------|
69| `references/foundations-visual.md` | Colors, typography, iconography, theming, content density |
70| `references/foundations-interaction.md` | States, cursors, screen reader support |
71| `references/foundations-writing-and-wording.md` | UX writing, UI text guidelines |
72| `references/foundations-best-practices.md` | Navigation, messaging, object handling, action placement |
73| `references/foundations-ai-and-joule-design.md` | AI design patterns, Joule assistant, situation handling, AI guidelines |
74| `references/foundations-integration-and-services.md` | Fiori launchpad, integration patterns |
75
76### SAP Fiori Elements & S/4HANA
77
78| Reference | Contents |
79|-----------|----------|
80| `references/fiori-elements.md` | Smart templates, list report, object page, table features, AI input assistance |
81| `references/sap-s4hana.md` | S/4HANA specific design: navigation menu, product home page, AI error explanation |
82
83## Quick Reference
84
85### Button Types and Usage
86
87| Type | Usage |
88|------|-------|
89| Emphasized | Primary action - **one per page/dialog** |
90| Default/Ghost | Secondary actions |
91| Transparent | Toolbar actions, low emphasis |
92| Accept (green) | Positive semantic actions (Approve, Accept) |
93| Reject (red) | Negative semantic actions (Reject, Delete) |
94
95### Semantic Colors
96
97| Color | Meaning | Usage |
98|-------|---------|-------|
99| Neutral | Default state | Regular UI elements |
100| Positive (Green) | Success, good status | Approval, completion |
101| Critical (Orange) | Warning | Needs attention |
102| Negative (Red) | Error, bad status | Rejection, errors |
103| Information (Blue) | Informational highlight | Neutral information |
104
105### Message Types
106
107| Type | Usage |
108|------|-------|
109| Error | Prevents task completion, requires user action |
110| Warning | Potential issue, user can proceed |
111| Success | Confirms completed action |
112| Information | Neutral information |
113
114### Navigation Patterns
115
116| Pattern | When to Use |
117|---------|-------------|
118| Drill-down | Navigate to object details with back navigation |
119| Full-screen | Replace current view entirely |
120| Flexible Column Layout | Master-detail views in columns |
121| Dialog/Popover | Temporary overlay for quick tasks |
122
123### AI Components
124
125| Component | When to Use |
126|-----------|-------------|
127| AI Button | Trigger AI-powered actions |
128| AI Acknowledgment | Show AI contribution transparency |
129| Guided Prompts | Help users formulate AI requests |
130| Quick Prompts | Provide predefined AI interaction shortcuts |
131| Regenerate | Allow users to request new AI-generated content |
132| AI Writing Assistant | Inline AI text assistance |
133| Local AI Notice | Inform users about on-device AI processing |
134
135## Implementation Checklist
136
137When building a Fiori application:
138
139- [ ] Single emphasized button per page/dialog
140- [ ] Proper semantic colors for status indication
141- [ ] Message handling with Message Popover
142- [ ] Accessible labels and ARIA attributes
143- [ ] Responsive layout for different screen sizes
144- [ ] Consistent navigation patterns
145- [ ] Form validation with value states
146- [ ] Loading indicators for async operations
147- [ ] AI features follow Joule design patterns where applicable
148
149## Key Guidelines
150
151### Buttons
152- Use text buttons for primary, secondary, and semantic actions
153- Icon-only buttons only for universally recognized metaphors
154- Always provide tooltips for icon buttons
155- Button text: imperative verb (Save, Edit, Create)
156
157### Forms
158- Group related fields logically
159- Use proper field labels (always visible)
160- Show validation errors with value states
161- Provide clear error messages
162
163### Tables
164- Use responsive table for most cases
165- Grid table for complex data analysis
166- Analytical table for aggregation needs
167- Always provide column headers
168
169### Messages
170- Message Popover for multiple messages
171- Message Box only for interrupting errors
172- Toast for transient success confirmations
173- Inline validation for form fields
174
175### AI Integration
176- Use AI Button for AI-triggered actions
177- Show AI Acknowledgment for transparency
178- Provide Guided Prompts to help users interact with AI
179- Always include Local AI Notice when processing happens on-device
180- Follow responsible AI principles in all AI-powered features
181
182## External Resources
183
184- SAP Fiori Design Guidelines: https://experience.sap.com/fiori-design-web/
185- SAPUI5 SDK: https://ui5.sap.com/
186- UI5 Web Components: https://sap.github.io/ui5-webcomponents/
187
188---
189
190When implementing specific components, always read the relevant reference file for detailed guidance and examples.