Duotone Design
Design-style skill for Duotone Design: two-color-only UI and image treatment via CSS blend modes, no Photoshop required.
Maintainer of this project? Claim this page to edit the listing.
13.5.0Add to Favorites
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-duotone-design | bash Overview
Duotone Design
A design-style skill for Duotone Design - two-color-only UI and a genuine CSS-blend-mode-driven image duotone treatment - with matching Web CSS and SwiftUI implementations. Use it for bold editorial layouts, music/event branding, or striking hero sections that want a graphic, poster-like two-color aesthetic.
What it does
Duotone Design is a design-style child skill ('striking contrast - photography and UI stripped down to exactly two clashing or complementary colors'), part of the design-it family and not meant to be triggered directly. Three core principles: Two Colors Only (the entire design maps to a single dark color replacing blacks/shadows and a single light color replacing whites/highlights), Treated Imagery (all photos must be processed into the duotone palette, not left in their original colors), and Bold, Flat Typography (text is usually massive, solid, and rendered in one of the two colors).
When to use - and when NOT to
Use it when the user's request matches this stripped-down, high-contrast two-color aesthetic - bold editorial layouts, music/event branding, or striking hero sections that want a graphic, poster-like punch. As a design sub-style, it's selected by the parent design-it skill's routing rather than invoked on its own.
Inputs and outputs
Visual DNA calls for very high-contrast color pairs - Navy and Peach, Deep Purple and Neon Green, Crimson and Cream, drawing from Industrial Chic for inspiration - paired with heavy, condensed sans-serifs (League Gothic, Oswald) and gritty, high-contrast photography that maps cleanly to two tones. The signature technique is achieving a genuine image duotone effect in modern CSS without Photoshop, using mix-blend-mode and filters: the image is converted to grayscale and contrast-boosted (filter: grayscale(100%) contrast(1.5)), then multiplied against a light-colored background (mix-blend-mode: multiply), and a dark-color overlay is screened on top (mix-blend-mode: screen) to complete the two-tone mapping - CSS variables (--duo-dark, --duo-light) drive the whole palette from one source of truth, and even interactive elements like buttons stay strictly within the two-color system - a duotone button simply swaps which of the two colors is the fill versus the text, with heavy font-weight: 900 uppercase labels reinforcing the bold, flat, poster-like feel.
.duotone-container img {
filter: grayscale(100%) contrast(1.5);
mix-blend-mode: multiply;
}
.duotone-container::after {
background-color: var(--duo-dark);
mix-blend-mode: screen;
}
Integrations
SwiftUI reproduces the identical two-pass blend technique natively: .grayscale(1.0) plus .contrast(1.5) on the image, .colorMultiply(duoLight) to multiply in the light tone, and a duoDark color layered on top with .blendMode(.screen) - directly equivalent to CSS's screen blend mode, achieving the same duotone conversion without any external image processing step.
Who it's for
Designers and developers building bold, poster-like visuals - editorial layouts, event or music branding, striking hero sections - who want a genuine, code-driven two-color image treatment instead of manually pre-processing every photo in an external tool.
Source README
Duotone Design
"Striking contrast. Photography and UI stripped down to exactly two clashing or complementary colors."
When to Use
Use this sub-style when the user's request matches the aesthetic described above. This is a child reference of the design-it skill and is not meant to be triggered directly.
Core Principles
- Two Colors Only: The entire design is mapped to a dark color (replacing blacks/shadows) and a light color (replacing whites/highlights).
- Treated Imagery: All photos MUST be processed into the duotone palette.
- Bold, Flat Typography: Text is usually massive, solid, and uses one of the two colors.
Visual DNA
- Colors: Very high contrast pairs. Navy and Peach, Deep Purple and Neon Green, Crimson and Cream. Look at Industrial Chic for inspiration.
- Typography: Heavy, condensed sans-serifs (e.g.,
League Gothic,Oswald). - Imagery: High-contrast, gritty photography works best when mapped to duotone.
Web Implementation
- Modern CSS can achieve image duotone effects without Photoshop, using
mix-blend-modeand filters. - CSS Example:
:root {
--duo-dark: #1E0045; /* Deep Purple */
--duo-light: #CCFF00; /* Neon Lime */
}
body {
background-color: var(--duo-dark);
color: var(--duo-light);
}
/* CSS Duotone Image Effect */
.duotone-container {
position: relative;
width: 100%;
height: 400px;
background-color: var(--duo-light); /* Base color */
}
.duotone-container img {
width: 100%;
height: 100%;
object-fit: cover;
/* Convert image to grayscale, increase contrast */
filter: grayscale(100%) contrast(1.5);
/* Multiply the grayscale image against the light background */
mix-blend-mode: multiply;
}
.duotone-container::after {
/* Overlay the dark color using screen/lighten */
content: '';
position: absolute;
top: 0; left: 0; right: 0; bottom: 0;
background-color: var(--duo-dark);
mix-blend-mode: screen;
}
.duotone-btn {
background: var(--duo-light);
color: var(--duo-dark);
border: none;
font-weight: 900;
text-transform: uppercase;
padding: 16px 32px;
}
App Implementation
SwiftUI
struct DuotoneImage: View {
let duoDark = Color(red: 0.12, green: 0.0, blue: 0.27) // #1E0045
let duoLight = Color(red: 0.8, green: 1.0, blue: 0.0) // #CCFF00
var body: some View {
ZStack {
// Background base color
duoLight.ignoresSafeArea()
// Image processing
Image("sample_photo")
.resizable()
.scaledToFill()
.grayscale(1.0)
.contrast(1.5)
.colorMultiply(duoLight) // Multiplies the light color into the grays
// Dark color overlay
duoDark
.blendMode(.screen) // Equivalent to CSS screen blend mode
.allowsHitTesting(false)
}
.frame(height: 400)
.clipped()
}
}
- Real-time image processing is easy in SwiftUI.
- Convert to
.grayscale(), boost.contrast(), then use.colorMultiply()and.blendMode(.screen)layers to map the two colors exactly like CSSmix-blend-mode.
Flutter
class DuotoneImage extends StatelessWidget {
final Color duoDark = const Color(0xFF1E0045);
final Color duoLight = const Color(0xFFCCFF00);
@override
Widget build(BuildContext context) {
return Container(
height: 400,
width: double.infinity,
color: duoLight,
child: Stack(
fit: StackFit.expand,
children: [
// 1. Grayscale & Contrast (using ColorFilter matrix)
// 2. Light Color Multiply
ColorFiltered(
colorFilter: ColorFilter.mode(duoLight, BlendMode.multiply),
child: ColorFiltered(
// Simple grayscale matrix
colorFilter: const ColorFilter.matrix([
0.2126, 0.7152, 0.0722, 0, 0,
0.2126, 0.7152, 0.0722, 0, 0,
0.2126, 0.7152, 0.0722, 0, 0,
0, 0, 0, 1, 0,
]),
child: Image.asset('assets/sample_photo.jpg', fit: BoxFit.cover),
),
),
// 3. Dark Color Screen Overlay
ColorFiltered(
colorFilter: ColorFilter.mode(duoDark, BlendMode.screen),
child: Container(color: Colors.transparent), // Applies filter to stack below
),
],
),
);
}
}
- Flutter requires stacking
ColorFilteredwidgets. - Use a
ColorFilter.matrixto convert the image to grayscale first. - Apply
BlendMode.multiplywith the light color, then overlay the dark color usingBlendMode.screen.
React Native
// Real-time CSS-like blend modes do NOT exist natively in React Native.
// You must use react-native-skia or pre-process images.
import { Canvas, Image, useImage, ColorMatrix } from "@shopify/react-native-skia";
const DuotoneImage = () => {
const image = useImage(require('./sample_photo.jpg'));
if (!image) return null;
// Skia allows custom SVG/CSS style color matrices.
// Building a true duotone matrix requires math mapping black to duoDark
// and white to duoLight.
return (
<View style={{ height: 400, backgroundColor: '#CCFF00' }}>
<Canvas style={{ flex: 1 }}>
<Image image={image} x={0} y={0} width={400} height={400} fit="cover">
{/* Note: In production, you would construct a specific
ColorMatrix to map the luminance to the two hex colors. */}
<ColorMatrix
matrix={[
-1, 0, 0, 0, 255,
0, -1, 0, 0, 255,
0, 0, -1, 0, 255,
0, 0, 0, 1, 0,
]}
/>
</Image>
</Canvas>
</View>
);
};
- Critical Limitation: Standard React Native
<Image>cannot do duotone blending. - Solution 1: Use
@shopify/react-native-skiato apply low-level color matrices and blend modes. - Solution 2: Pre-process all imagery in Photoshop/Figma before importing into the app. This is the safest and most performant route.
Jetpack Compose
@Composable
fun DuotoneImage() {
val duoDark = Color(0xFF1E0045)
val duoLight = Color(0xFFCCFF00)
// A ColorMatrix to map luminance to the two colors is required for true duotone.
// For simplicity, we use BlendModes here to approximate the CSS multiply/screen effect.
Box(modifier = Modifier
.fillMaxWidth()
.height(400.dp)
.background(duoLight)
) {
Image(
painter = painterResource(id = R.drawable.sample_photo),
contentDescription = null,
contentScale = ContentScale.Crop,
modifier = Modifier.matchParentSize(),
colorFilter = ColorFilter.colorMatrix(ColorMatrix().apply {
setToSaturation(0f) // Grayscale
})
)
// Multiply light color
Spacer(modifier = Modifier
.matchParentSize()
.background(duoLight)
.graphicsLayer { blendMode = BlendMode.Multiply }
)
// Screen dark color
Spacer(modifier = Modifier
.matchParentSize()
.background(duoDark)
.graphicsLayer { blendMode = BlendMode.Screen }
)
}
}
- Use
ColorFilter.colorMatrixwithsetToSaturation(0f)to make the image grayscale. - Use
Spaceroverlays withModifier.graphicsLayer { blendMode = BlendMode... }to apply the dual color mapping. - Similar to Flutter, layer
Multiply(light) andScreen(dark) to achieve the effect.
Do's and Don'ts
- DO: Ensure the dark color is dark enough to be legible when used as text against the light color.
- DON'T: Add a third color. It instantly ruins the aesthetic.
Limitations
- This is a styling reference and does not replace environment-specific validation, accessibility testing, or expert review.
- Ensure appropriate contrast ratios and responsive behaviors are verified separately.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.