Design System Inspired by Mangapill 1. Visual Theme & Atmosphere Mangapill's design…
- User
Design System Inspired by Mangapill
1. Visual Theme & Atmosphere
Mangapill's design system embodies a clean, accessible digital reading experience tailored for manga enthusiasts. The aesthetic is minimalist and functional, prioritizing content discovery and readability over visual ornamentation. A light, neutral foundation with subtle dark accents creates a calm backdrop that lets vibrant manga cover artwork take center stage. The system embraces a contemporary web sensibility with generous whitespace, clear hierarchies, and responsive typography that adapts gracefully across devices. The overall mood is approachable yet professional—a library-like environment optimized for deep content consumption.
Key Characteristics
- Clean, minimal interface focused on content discoverability
- Neutral color palette emphasizing readability
- Typography-driven hierarchy with consistent spacing
- Subtle micro-interactions via simple shadows and state changes
- Light gray backgrounds reducing eye strain during extended reading sessions
- Icon-driven navigation supporting rapid menu scanning
2. Color Palette & Roles
Primary
- Brand Blue (
#0070F3): Primary call-to-action elements and accent links; reserved for featured interactive states - Dark Navy (
#014594): Secondary brand emphasis; used sparingly for deeper interactive elements
Accent Colors
- Stone Gray (
#57606A): Most frequently used neutral accent; applied to secondary UI elements, borders, and subtle dividers
Interactive
- Charcoal (
#242424): Primary interactive states, button backgrounds, and text emphasis; creates strong visual contrast
Neutral Scale
- Light Gray (
#E5E7EB): Default input borders, subtle dividers, and light surface fills - Off-White (
#F0F1F2): Soft background surfaces; input field backgrounds providing gentle contrast to white - Pure White (
#FFFFFF): Primary content surfaces and card backgrounds - Medium Gray (
#8B949E): Tertiary text and disabled states
Surface & Borders
- Border Gray (
#E5E7EB): Default border color for all input fields and card edges - Surface Dark (
#212328): Dark mode surface alternative - Deep Black (
#000000): Rarely used; reserved for maximum contrast in critical text - Subtle Charcoal (
#404044): Minimal UI separators and thin dividers
3. Typography Rules
Font Family
Primary Font:
ui-sans-serif, with fallback stack:system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serifSecondary Font: Same as primary; no distinct secondary family employed in current system
Hierarchy
Role Font Size Weight Line Height Letter Spacing Notes Display/H1 ui-sans-serif 28px 700 36px 0px Large section headings; "Featured Chapters" Heading/H2 ui-sans-serif 24px 700 32px 0px Subsection titles like "New Chapters" Subheading/H3 ui-sans-serif 20px 900 28px 0px Manga chapter numbers and featured titles Body/P ui-sans-serif 16px 400 24px 0px Primary content text, descriptions Button/Label ui-sans-serif 14px 500 20px 0px Interactive button text and form labels Caption/Small ui-sans-serif 14px 400 20px 0px Timestamps, secondary text ("13 hours ago") Input/Form ui-sans-serif 14px 400 20px 0px Search and text input placeholder/value text Principles
- Contrast over decoration: Bold weights (700, 900) reserved for scannable headings; light weights (400) for body text maximize readability
- Consistent line spacing: 1.5× to 1.75× multiplier maintains vertical rhythm across all sizes
- Scale progression: Hierarchy steps follow a consistent 4px–8px size increment between levels
- Accessibility: Minimum 14px body text on all surfaces; labels and interactive text never below 14px
- No font styling variations: Italics and underlines avoided except for explicit interactive states (hover links)
4. Component Stylings
Buttons
Primary Button
- Background Color:
#242424 - Text Color:
#FFFFFF(oroklch(0.985 0 0)) - Font:
ui-sans-serif, 14px, weight 500 - Padding:
0px 12px - Height:
32px - Border Radius:
8px - Border:
0px solid transparent - Box Shadow:
rgba(0, 0, 0, 0.05) 0px 1px 2px 0px - Line Height:
20px - Hover State: Background darkens to
#1A1A1A; shadow increases torgba(0, 0, 0, 0.1) 0px 2px 4px 0px - Active State: Background
#0F0F0F; no shadow change - Disabled State: Background
#D1D5DB; text color#9CA3AF; cursor not-allowed
Secondary Button
- Background Color:
rgba(0, 0, 0, 0)(transparent) - Text Color:
#242424 - Font:
ui-sans-serif, 16px, weight 400 - Padding:
8px 8px - Height: auto
- Border Radius:
4px - Border:
0px solid transparent - Box Shadow: none
- Line Height:
24px - Hover State: Background
#F0F1F2; text color#000000 - Active State: Background
#E5E7EB
Ghost Button (Icon Button)
- Background Color:
rgba(0, 0, 0, 0)(transparent) - Text Color:
#242424 - Font:
ui-sans-serif, 16px, weight 400 - Padding:
8px 8px - Height:
40px - Width:
40px - Border Radius:
4px - Border:
0px solid transparent - Box Shadow: none
- Line Height:
24px - Hover State: Background
#F0F1F2; slight scale transform1.05 - Active State: Background
#E5E7EB
Cards & Containers
Content Card
- Background Color:
#FFFFFF - Text Color:
#242424 - Font:
ui-sans-serif, 16px, weight 400 - Padding:
8px 8px(inner content) or12px 12px(larger cards) - Border Radius:
4px - Border:
1px solid #E5E7EB - Box Shadow:
rgba(0, 0, 0, 0.05) 0px 1px 2px 0px - Line Height:
24px - Hover State: Box shadow increases to
rgba(0, 0, 0, 0.08) 0px 2px 4px 0px; subtle scale1.02
Featured Card (Manga Cover)
- Background Color:
#FFFFFF - Padding:
4px 4px(tight around image) - Border Radius:
4px - Border:
1px solid #E5E7EB - Box Shadow:
rgba(0, 0, 0, 0.05) 0px 1px 2px 0px - Hover State: Box shadow
rgba(0, 0, 0, 0.12) 0px 4px 8px 0px; scale1.03
Surface Container
- Background Color:
#F0F1F2 - Padding:
16px 16pxor20px 20px - Border Radius:
8px - Border: none
- Box Shadow: none
Inputs & Forms
Text Input / Search
- Background Color:
#F0F1F2 - Text Color:
#242424 - Font:
ui-sans-serif, 14px, weight 400 - Padding:
4px 12px - Height:
36px - Border Radius:
4px - Border:
1px solid #E5E7EB - Box Shadow:
rgba(0, 0, 0, 0.05) 0px 1px 2px 0px - Line Height:
20px - Placeholder Text Color:
#8B949E - Focus State: Border color
#0070F3; outline none; box shadow0 0 0 3px rgba(0, 112, 243, 0.1) - Error State: Border color
#DC2626; background unchanged
Input Label
- Font:
ui-sans-serif, 14px, weight 500 - Text Color:
#242424 - Margin Bottom:
4px - Line Height:
14px
Navigation
Primary Navigation (Header)
- Background Color:
#FFFFFF - Text Color:
#242424 - Font:
ui-sans-serif, 16px, weight 700 - Padding:
12px 16px(per nav item) - Border Radius:
0px - Border:
1px solid #E5E7EB(bottom only) - Box Shadow: none
- Line Height:
24px - Active Link: Text color
#0070F3; border-bottom2px solid #0070F3 - Hover State: Text color
#0070F3; background#F0F1F2
Navigation Link
- Background Color: transparent
- Text Color:
#242424 - Font:
ui-sans-serif, 16px, weight 400 - Padding:
0px 8px - Border Radius:
0px - Border: none
- Box Shadow: none
- Line Height:
24px - Hover State: Text color
#0070F3; text-decoration underline - Active State: Text color
#0070F3; font-weight 700
Badges & Status
Status Badge (Chapter Update)
- Background Color:
#E5E7EB - Text Color:
#404044 - Font:
ui-sans-serif, 12px, weight 500 - Padding:
2px 8px - Border Radius:
4px - Border: none
- Line Height:
16px
Timestamp Label
- Font:
ui-sans-serif, 14px, weight 400 - Text Color:
#8B949E - Line Height:
20px
5. Layout Principles
Spacing System
Base Unit:
4pxScale:
4px: Minimal padding (button text-to-edge)8px: Inner component padding (cards, small buttons)12px: Medium spacing (between elements, form gap)16px: Primary padding (content containers, grid gutters)20px: Component gaps (flex gap between cards)80px: Large section margin (between major content blocks)124px: Extra-large margin (transitional sections)152px: Maximum section margin (page breaks)
Usage Context:
- Cards and containers:
8pxto16pxinternal padding - Form elements:
4pxvertical,12pxhorizontal - Section gaps:
20pxto80pxdepending on visual weight - Grid layouts:
16pxto20pxgap between items
Grid & Container
Max Width:
1440px(desktop) or100%minus margin on smaller viewportsColumn Strategy:
- Desktop (1440px): 12-column grid with
16pxgutters - Tablet (768px): 8-column grid with
12pxgutters - Mobile (360px–480px): 4-column grid with
8pxgutters
Section Patterns:
- Full-width hero: padding
16px 16px(mobile) to40px 40px(desktop) - Content grids: 4 columns on desktop (manga cards), 2 columns tablet, 1 column mobile
- Sidebar layouts: main
70%, sidebar30%with16pxgap on desktop; stack vertically on mobile
Whitespace Philosophy
Generous whitespace is central to Mangapill's identity, creating visual breathing room and reducing cognitive load. All interactive elements maintain at least
8pxpadding internally and12pxexternal margin from neighboring elements. Section breaks use20pxminimum vertical space; major transitions employ80px. The layout never feels cramped; empty space is as important as content. This approach enhances readability during long reading sessions and improves touch target spacing on mobile.Border Radius Scale
0px: Navigation bars, full-width sections, list containers4px: Input fields, secondary buttons, badges, small cards8px: Primary buttons, larger cards, surface containers30px: Special radius (reserved for pill-shaped elements if needed)
6. Depth & Elevation
Level Treatment Use Flat (None) No shadow Navigation, text links, typography-only sections Subtle (sm) rgba(0, 0, 0, 0.05) 0px 1px 2px 0pxDefault cards, inputs, standard buttons Raised (md) rgba(0, 0, 0, 0.08) 0px 2px 4px 0pxHovered cards, active buttons, lifted containers Elevated (lg) rgba(0, 0, 0, 0.12) 0px 4px 8px 0pxModals, dropdowns, floating elements High (xl) rgba(0, 0, 0, 0.15) 0px 8px 16px 0pxTooltips, overlay surfaces, maximum emphasis Shadow Philosophy:
Shadows in Mangapill serve functional purposes rather than decorative ones. They establish depth hierarchy, distinguish interactive surfaces from static backgrounds, and provide visual feedback during state changes. Shadows are consistently dark (
rgba(0, 0, 0, ...)) with low opacity (0.05–0.15) to maintain the system's clean aesthetic. Elevation increases subtly; no shadow ever exceeds0px 8px 16px 0px. This restraint preserves the minimal visual language while ensuring clickable elements remain discernible from flat surfaces.7. Do's and Don'ts
Do
- Maintain consistent
8pxpadding inside all interactive components; this ensures comfortable tap targets and visual balance - Use the neutral gray scale (
#E5E7EB,#F0F1F2,#242424) for 90% of UI chrome; reserve brand blue (#0070F3) only for primary CTAs and active states - Stack interactive elements vertically on mobile; horizontal layouts risk touch target cramping below
44pxminimum height - Apply the subtle shadow (
0px 1px 2px 0pxwithrgba(0, 0, 0, 0.05)) to all cards and buttons by default; increases to medium shadow on hover - Use
16pxline-height minimum for body text; this improves readability during extended reading sessions - Employ weight hierarchy for scanning: bold (700–900) for headings, regular (400) for body, medium (500) for labels
- Provide visual feedback on interactive elements: color change + shadow increase + subtle scale on hover/active states
- Center margin content containers within viewport; avoid full-width layouts on desktop screens
Don't
- Never combine color and shadow as the sole interactive feedback; always include one additional state (scale, weight, or color shift)
- Avoid padding below
4pxor borders thinner than1px; these become invisible on small screens - Do not use pure black (
#000000) for body text; use#242424(dark charcoal) instead for slightly softer contrast that reduces eye strain - Never apply more than two font weights in a single heading; this causes visual noise and hierarchy confusion
- Avoid mixing radius values on the same component; use either
4pxor8px, not both - Do not disable text selection or copy functionality; manga readers often reference chapter discussion
- Never resize interactive elements below
32pxheight / width without clear accessibility purpose; maintain minimum tap targets - Avoid transparent overlays above manga cover artwork; let images dominate visually
8. Responsive Behavior
Breakpoints
Breakpoint Width Primary Changes Mobile 360px–480px 4-column grid, 8pxgaps, full-width inputs, stacked navigationMobile Large 481px–768px 2-column grid, 12pxgaps, increased padding to12pxTablet 769px–1024px 3-column grid, 16pxgaps, side-by-side layouts beginDesktop 1025px–1440px 4-column grid, 20pxgaps, full navigation, sidebars visibleDesktop Large 1441px+ Same as desktop; max-width container 1440pxcenters with marginTouch Targets
- Minimum height:
44pxfor all clickable elements (buttons, links, form inputs) - Minimum width:
44pxfor icon buttons and small interactive regions - Minimum spacing:
8pxbetween adjacent interactive elements to prevent accidental mis-taps - Form fields: Minimum
36pxheight;12pxhorizontal padding ensures comfortable text entry on mobile - Navigation links: Minimum
16pxfont size;12pxvertical padding
Collapsing Strategy
Desktop (1025px+):
- Header navigation displayed horizontally in full
- Manga grid: 4 columns with
20pxgap - Sidebar (news section) visible to the right of main content
- Input fields: full-width within container
- Button groups: inline horizontal layout
Tablet (769px–1024px):
- Header navigation collapses to hamburger menu at
768pxbreakpoint - Manga grid: 3 columns with
16pxgap - Sidebar pushed below main content (100% width)
- Input fields: full-width
- Button groups: wrap to two per row
Mobile (481px–768px):
- All navigation in collapsed hamburger menu
- Manga grid: 2 columns with
12pxgap - Single-column layout (no sidebars)
- Input fields: full-width with
12pxpadding - Button groups: stack vertically
Small Mobile (360px–480px):
- Manga grid: single column with
8pxpadding - Font sizes reduced: headings
18px, body14px - All padding reduced to
8pxhorizontally - Buttons: full-width or minimum
40pxheight - Navigation: hamburger menu mandatory
9. Agent Prompt Guide
Quick Color Reference
- Primary CTA: Charcoal (
#242424) background with white text - Secondary CTA: Transparent background with charcoal text; light gray hover
- Accent / Active State: Brand Blue (
#0070F3) - Background / Surface: Off-White (
#F0F1F2) or Pure White (#FFFFFF) - Border / Divider: Light Gray (
#E5E7EB) - Text / Body: Dark Charcoal (
#242424) - Secondary Text / Caption: Medium Gray (
#8B949E) - Disabled State: Light Gray (
#D1D5DB) background, Medium Gray text
Iteration Guide
-
Base your component backgrounds on surface role: Use
#FFFFFFfor primary content cards,#F0F1F2for subtle containers,#242424only for interactive elements (buttons). -
Apply consistent shadow only to cards and elevated surfaces: Default
rgba(0, 0, 0, 0.05) 0px 1px 2px 0px; increase to0px 2px 4px 0pxon hover. Never apply shadow to flat text or navigation. -
Enforce typography hierarchy strictly: H1/H2 at 700–900 weight, body at 400, labels at 500. Maintain
14pxminimum for all interactive text; never decrease below this threshold for accessibility. -
Maintain
8pxpadding standard: All buttons, cards, inputs use8pxas baseline padding. Increase to12pxor16pxfor visual emphasis or larger containers; never decrease below4px. -
Use border-radius
4pxfor inputs and small elements,8pxfor buttons and featured cards. Do not mix radii on the same component family. -
Implement state changes via three dimensions: (1) background/text color shift, (2) shadow increase, (3) subtle scale transform (
1.02–1.03). All three on buttons; color + shadow on cards; color only on text links. -
Responsive behavior starts at grid: Desktop 4 columns, tablet 3 columns, mobile 2 columns, small mobile 1 column. All powered by CSS Grid or Flexbox with
gapproperty aligned to spacing scale. -
Text contrast must meet WCAG AA minimum (
#242424on#FFFFFF= 12.6:1 ratio). Use#8B949Eonly for tertiary text where contrast still exceeds 4.5:1. -
Reserve brand blue (
#0070F3) exclusively for primary CTAs, active navigation states, and focus rings. Never use for body text or secondary elements; overuse dilutes visual impact. -
Mobile-first input sizing: All form fields minimum
36pxheight with12pxhorizontal padding. Search bars and inputs must accommodate comfortable thumb interaction on 360px viewport width.
- Assistant
Implemented a complete Mangapill-inspired manga discovery application.
- Built responsive MORI branding, navigation, search, and genre filtering.
- Added eight original manga cover illustrations in
public/covers/. - Added featured manga, chapter updates, trending rankings, and library views.
- Implemented saving, loading more chapters, mobile navigation, and manga detail dialogs.
- Added accessible focus states, reduced-motion support, and Framer Motion transitions.
- Updated
src/App.tsxandsrc/index.css. - Installed
lucide-reactandframer-motion. - Verified successfully with
npm run build.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.