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

Fresh apples

Organic Apples

New
star star star star star
(24)

$4.99

Whole wheat bread

Whole Wheat Bread

Limited
star star star star_half star
(42)

$2.49

Almond milk carton

Almond Milk

Sale
star star star star star
(128)

$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

check_circle
Order Successful

Your order #12345 has been placed successfully.

error
Payment Failed

Your payment method was declined. Please try again.

warning
Low Stock

Only 3 items left in stock. Order soon!

info
New Feature

Try our new wishlist feature to save items for later.

Progress Indicators

Order Processing 50%
Shipping Progress 25%

Tooltips

Click for more information
This feature is new

Ratings

star star star star star (128 reviews)

Toast Notification

check_circle
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

shopping_bag

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