| name | Onyx Gold | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| colors |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| typography |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| rounded |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| spacing |
|
This design system is a high-fidelity implementation of Material Design 3 (M3) tailored for an immersive, premium dark-mode media experience. It balances the structured utility of a content-heavy reader with the "luxurious" tactile feel of high-end consumer hardware.
The aesthetic is defined by Warm Minimalism. We avoid sterile pure blacks in favor of deep, velvet-toned obsidian neutrals that provide a sophisticated backdrop for vibrant manga artwork and long-form light novel prose. The emotional response should be one of "focused luxury"—where the interface recedes to highlight content but feels substantial and responsive when engaged.
Key characteristics include:
- Depth through Tone: Utilizing the M3 tonal surface system to create hierarchy without heavy drop shadows.
- High-Contrast Accents: Using a singular, vibrant gold brand color for all primary interactions and progress indicators.
- Fluid Responsiveness: Smooth transitions between library views, manga reading, and novel reading modes.
The color system is built on a foundation of Velvet Black to minimize eye strain and maximize the pop of color manga covers.
- Primary (Manga Gold): Used for CTA buttons, active navigation states, and critical progress indicators.
- Secondary (Espresso): Provides a muted, warm container for secondary actions and toggles, preventing the UI from feeling too "loud."
- Typography: We use Warm Ivory for primary text instead of pure white to reduce glare, and Warm Clay for secondary metadata to create a natural hierarchy.
- Surfaces: Containers use the
warm-obsidianhex to distinguish elevated panels from the base background. For devices with OLED displays, the system allows for a "True Black" override using#000000.
For long-form reading comfort, the novel reader provides dedicated color palettes:
- Dark (Default): Deep charcoal (
#141414) background with soft silver text (#E0E0E0) for reduced eye strain in dark environments. - Sepia: Warm parchment (
#FBF0D9) background with deep walnut text (#5F4B32) to filter blue light during extended day reading. - Light: Crisp white (
#FFFFFF) background with charcoal text (#212121) for high-glare environments. - OLED: Pitch black (
#000000) with pure white (#FFFFFF) text for maximum power savings on OLED displays.
This design system uses Inter for its neutral, highly legible characteristics. The type scale is intentionally bold to counteract the "thinning" effect of light text on dark backgrounds.
- Display & Headlines: Use tight letter spacing and heavy weights to create a strong editorial feel for manga titles.
- Body & Labels: Prioritize legibility. Labels utilize increased letter spacing (
0.05em) to remain clear at very small sizes, such as on manga tags or chapter numbers. - Reading Comfort: Body text is set with a generous
1.5xline height to ensure descriptions and logs are easy to scan.
Prose reading uses a customizable typographic engine configured via CSS root variables:
- Font Scale & Family: Configurable serif / system font scaling from
12spto32sp(default:18sp). - Vertical Rhythm: Generous
1.6xline spacing multiplier (adjustable1.2x–2.2x) and1.0emparagraph spacing to facilitate effortless scanning. - Alignment: Left-aligned by default with optional full justification or centered layout.
The home screen features a centered, high-altitude vertical Japanese Kanji watermark that intuitively signals the active app mode: 漫\n画 for Manga Mode and 小\n説 for Light Novel Mode.
- Scale & Presence: Rendered at
130spwith tight0.9line spacing at a subtle10%alpha (android:alpha="0.10"), floating unobtrusively beneath library grids. - Kanji Font Selection: Users can customize typography via
HomeBackgroundFont:- Light Thin: MojiwTegami Standard (
fonts/MojiwTegami-Standard.ttf) for an understated, brush-calligraphy aesthetic. - Bold (Default): Shimbashi Gothic Regular (
fonts/ShimbashiGothic-Regular.otf) for a modern, balanced architectural presence. - Extra Bold: GenEi Kiwami Gothic (
fonts/GenEiKiwamiGo.ttf) for high-impact manga-magazine editorial styling. - None: Disables background watermark.
- Light Thin: MojiwTegami Standard (
The layout is built on a fluid grid system that adapts to the high-density requirements of a media library.
- Grid Model: Manga covers use a responsive grid with a preferred card width of
120dp. Columns scale dynamically based on screen width. - Rhythm: An
8pxbase unit governs all spacing. Vertical spacing between sections uses24pxto provide clear separation. - Manga Reader Layout: In the reader view, the layout transitions to a "No Grid" model, allowing content to be truly edge-to-edge. Vertical margins between pages in Webtoon mode are set to
24pxto create a physical "breathing room" between story beats. - Novel Reader Layout: Continuous scroll or paginated text engine with customizable side margins (default:
18dp). - PDF Document Reader Layout: Continuous vertical layout (
PdfReaderActivity) with memory-aware LRU bitmap rendering to prevent stuttering across dense multi-page documents. - Safe Areas: Mobile layouts respect a
16pxouter margin, while tablet and desktop layouts expand to24pxto maintain visual balance on larger displays.
We utilize Tonal Layers as the primary method of communicating depth, adhering to Material Design 3 principles.
- Surface Tiers:
- Level 0 (Background): Velvet Black (
#0D0D0D). - Level 1 (Cards/Panels): Warm Obsidian (
#121110). - Level 2 (Dialogs/Menus): A lighter tint of obsidian or a very low-opacity white overlay (5-8%).
- Level 0 (Background): Velvet Black (
- Interactive Depth: We avoid heavy drop shadows. Instead, elevated states are signaled by subtle
1pxinner outlines in Warm Clay at 15% opacity. - AMOLED Mode: When active, tonal layers are flattened. Hierarchy is conveyed solely through high-contrast strokes and typography weights to preserve battery life and prevent "ghosting."
The shape language is Soft-Rounded, providing a modern and friendly feel that contrasts with the "serious" dark color palette.
- Standard Containers: Use a
0.5rem(8px) radius. - Large Components (Manga Covers): Use a
1rem(16px) radius to emphasize the "object-like" quality of book covers. - Tactile Inputs: Large sliders and buttons use the
rounded-xlor pill-shaped (full) setting to maximize touch-target friendliness. - Indicators: Circular progress bubbles are perfectly rounded to
9999pxto stand out as distinct UI overlays.
Manga covers must maintain a strict 18:13 aspect ratio. Use centerCrop for images. Titles below the card should be limited to 2 lines with an ellipsis.
- Primary Buttons: Solid Manga Gold fill with Pure Black text. Minimum height
56dpfor flagship actions. - Chips: Outlined with a
1pxWarm Clay border. Active states switch to a gold tinted background at 20% opacity.
- Chapter Items: Horizontal layout with a large touch target (
48dpmin height). Use Warm Ivory for chapter names and Warm Clay for timestamps. - Progress Bubbles: Floating
32dpbubbles. Use a4dpgold stroke for the progress arc. When 100% complete, replace the percentage text with a gold check icon.
- Tactile Sliders: Thick
40dptracks in Espresso with a48dpthumb. This "fat" slider style makes it easier to adjust brightness or font size during one-handed reading.
Clean, borderless icons. The active state is indicated by a Manga Gold icon and a small pill-shaped indicator behind it.
A bottom sheet modal (NovelReaderConfigSheet) surfaced directly from the reader interface:
- Typographic Sliders: Tactile sliders for granular adjustments of font size, line spacing, and margin padding.
- Theme Palette Selectors: Circular color chips showcasing real-time background and text preview colors.
An onboarding walkthrough component (ModeSwitcherSpotlightOverlay) spotlighting the app mode toggle:
- Pulsing Halo: Radial gold glow (
#FEA628) centered precisely on the mode switch icon with an ease-in-out breathing animation. - Elevated Callout Card: A Warm Obsidian container with a gold action button ("Got it") guiding first-time or returning users through dual-mode navigation.