Shopease Design System
Comprehensive guidelines for building consistent Shopease e-commerce interfaces
Design Principles
Clarity First
Prioritize clear communication through intuitive layouts, legible typography, and straightforward navigation.
Start with the User
Empathy leads every decision.
Consistency Builds Trust
Maintain visual and functional consistency across all platforms and device sizes.
Typography
Heading 1
Heading 2
Heading 3
Heading 4
Subtitle
Body text. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Caption text. Praesentium officia eveniet dolor.
Usage Guidelines
- • Use Inter font family throughout the application
- • Maintain a minimum line height of 1.5 for body text
- • Never use less than 16px for body copy
- • Limit to 2 font weights per page (e.g., Regular and Semibold)
- • Left-align text for readability, center only for special cases
- • Use sentence case for all UI text except proper nouns
Color Palette
Black (#000000)
Background (#121212)
Surface (#1E1E1E)
Surface Darker (#2D2D2D)
Primary (Orange 500)
Primary Darker (Orange 600)
Text Secondary (Neutral 400)
Text Primary (White)
Color Usage Rules
- • Primary orange (#FF5733) should be used for primary actions, important highlights, and interactive elements
- • Never use pure black (#000000) for text - use white or neutral-400 for better readability
- • Maintain a minimum contrast ratio of 4.5:1 for text against background
- • Use the surface colors (#1E1E1E, #2D2D2D) for cards, modals, and elevated components
- • Reserve red only for destructive actions and error states
Buttons
Standard Buttons
Icon Buttons
Button States
Button Guidelines
- • Primary buttons should be used for the most important actions on a page
- • Secondary buttons are for less prominent actions
- • Buttons should have a minimum width of 120px for touch targets
- • Maintain consistent padding: 12px vertical, 24px horizontal
- • Always include a loading state for buttons that trigger async actions
- • Disabled buttons should still meet contrast requirements (4.5:1)
- • Icon buttons should have a minimum touch target of 48x48px
Button Sizes
Form Elements
Input Fields
Checkboxes & Radios
Toggle Switch
Form Guidelines
- • Always pair form fields with clear, visible labels
- • Use placeholder text sparingly and only for examples
- • Group related form fields together with proper spacing
- • Provide clear error messages near the problematic field
- • Use autocomplete attributes where appropriate
- • Ensure all form controls are keyboard accessible
- • Validate forms progressively (as user types when possible)
Promo Code Example
Cards
Organic Apples
New$4.99
Whole Wheat Bread
Limited$2.49
Almond Milk
Sale$4.99
$3.99
Card Guidelines
- • Cards should have consistent padding (16px on desktop, 12px on mobile)
- • Maintain a 16:9 aspect ratio for product images
- • Include essential product information: title, price, rating, and CTA
- • Use badges sparingly to highlight special status (sale, new, etc.)
- • Ensure cards have sufficient contrast against their background
- • Cards should be responsive and stack on smaller screens
- • Include hover states with subtle elevation and shadow
Navigation & Tabs
Pagination
Breadcrumbs
Navigation Guidelines
- • Primary navigation should be visible at all times
- • Secondary navigation can be in sidebars or accordions
- • Breadcrumbs help users understand their location in the hierarchy
- • Tabs should have clear visual indicators for the active state
- • Pagination controls should be accessible via keyboard
- • Accordions are useful for progressive disclosure of content
Feedback Elements
Alerts
Order Successful
Your order #12345 has been placed successfully.
Payment Failed
Your payment method was declined. Please try again.
Low Stock
Only 3 items left in stock. Order soon!
New Feature
Try our new wishlist feature to save items for later.
Progress Indicators
Tooltips
Ratings
Toast Notification
Item Added
Organic Apples have been added to your cart
Feedback Guidelines
- • Use alerts for important messages that require user attention
- • Progress bars should show meaningful progress with percentage
- • Tooltips should be concise and appear on hover/focus
- • Rating displays should be consistent throughout the application
- • Toast notifications should auto-dismiss after 5-8 seconds
- • Error messages should be specific and suggest solutions
- • Success messages should confirm the completed action
Modals & Overlays
Modal Example
Modal Guidelines
- • Use modals sparingly for critical actions or important information
- • Always provide a clear way to dismiss the modal (ESC key or close button)
- • Modal titles should be concise and action-oriented
- • Primary actions should be on the right, secondary on the left
- • Modals should be vertically and horizontally centered
- • Ensure modal content is accessible via keyboard navigation
- • Use overlay to focus attention on the modal content
Loading States
Empty States
Your cart is empty
Start shopping to add items to your cart
State Guidelines
- • Loading states should indicate progress and reassure users
- • Skeletons should approximate the final content layout
- • Empty states should provide clear next steps
- • Use illustrations or icons to enhance empty states
- • Loading indicators should be consistent across the application
- • Consider progressive loading for complex interfaces
Sidebar Example (Cart Summary)
Responsive Grid System
Breakpoints
- • Mobile (default): <640px - Single column layout, stacked elements
- • Tablet (md): 640px-1024px - 2-4 column layouts, more horizontal space
- • Desktop (lg): 1024px+ - Multi-column layouts, sidebars, more complex UI
- • Always design mobile-first, then enhance for larger screens
- • Test on actual devices when possible
- • Use relative units (rem, %) for responsive sizing