# Kriko — Design System
> A free, open-source product research tool that highlights known product issues and defects directly alongside listings.
- **Canonical:** https://uiuxskills.com/library/kriko
- **Source:** https://kriko.cc/
- **Category:** Media & Consumer Tech
- **Compatible tools:** claude, cursor, lovable, figma-make
- **Coverage:** 81%
- **License:** MIT
- **Last updated:** 2026-11-08T03:40:56.802Z

---

---
version: alpha
name: Kriko
tagline: Know what can go wrong before you buy.
description: >-
  A free, open-source product research tool that highlights known product issues and defects
  directly alongside listings.
tone: trustworthy, modern, utility-focused, and transparent
color-scheme: light
colors:
  primary: "#2447E6"
  secondary: "#0B1020"
  accent: "#1D3FD0"
  background: "#FCFBF8"
  surface: "#FCFBF8"
  surface-container: "#F3F1EB"
  on-primary: "#FFFFFF"
  on-surface: "#0B1020"
  on-surface-variant: "#4A5167"
  outline: "#0B1020"
  error: "#D9381E"
  warning: "#F59E0B"
  success: "#10B981"
typography:
  display-lg:
    fontFamily: Geist
    fontSize: 72px
    fontWeight: 700
    lineHeight: "1.1"
    letterSpacing: "-0.02em"
  display-md:
    fontFamily: Geist
    fontSize: 52.8px
    fontWeight: 700
    lineHeight: "1.2"
    letterSpacing: "-0.01em"
  headline-lg:
    fontFamily: Geist
    fontSize: 36px
    fontWeight: 600
    lineHeight: "1.3"
    letterSpacing: "-0.01em"
  headline-md:
    fontFamily: Geist
    fontSize: 24px
    fontWeight: 600
    lineHeight: "1.4"
    letterSpacing: 0em
  headline-sm:
    fontFamily: Geist
    fontSize: 20px
    fontWeight: 600
    lineHeight: "1.4"
    letterSpacing: 0em
  body-lg:
    fontFamily: Atkinson Hyperlegible Next
    fontSize: 18px
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: 0em
  body-md:
    fontFamily: Atkinson Hyperlegible Next
    fontSize: 16px
    fontWeight: 400
    lineHeight: "1.6"
    letterSpacing: 0em
  body-sm:
    fontFamily: Atkinson Hyperlegible Next
    fontSize: 14px
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: 0em
  label-md:
    fontFamily: Atkinson Hyperlegible Next
    fontSize: 14px
    fontWeight: 500
    lineHeight: "1"
    letterSpacing: 0.02em
  label-sm:
    fontFamily: Atkinson Hyperlegible Next
    fontSize: 12px
    fontWeight: 600
    lineHeight: "1"
    letterSpacing: 0.05em
rounded:
  sm: 4px
  md: 8px
  lg: 14px
  xl: 24px
  full: 9999px
spacing:
  xs: 4px
  sm: 8px
  md: 12px
  lg: 24px
  xl: 48px
  2xl: 72px
components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    height: 48px
    borderColor: "{colors.primary}"
  button-primary-hover:
    backgroundColor: "{colors.accent}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    height: 48px
    borderColor: "{colors.accent}"
  button-secondary:
    backgroundColor: "{colors.background}"
    textColor: "{colors.secondary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    height: 48px
    borderColor: "{colors.outline}"
  button-secondary-hover:
    backgroundColor: "{colors.surface-container}"
    textColor: "{colors.secondary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    height: 48px
    borderColor: "{colors.outline}"
  card:
    backgroundColor: "{colors.surface}"
    rounded: "{rounded.lg}"
    padding: 24px
    borderColor: "{colors.outline}"
  card-elevated:
    backgroundColor: "{colors.surface}"
    rounded: "{rounded.lg}"
    padding: 24px
  input-field:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.md}"
    padding: 8px 16px
    height: 40px
    borderColor: "{colors.outline}"
  input-field-focus:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.md}"
    padding: 8px 16px
    height: 40px
    borderColor: "{colors.primary}"
  link:
    textColor: "{colors.primary}"
    typography: "{typography.body-md}"
  link-hover:
    textColor: "{colors.accent}"
    typography: "{typography.body-md}"
  badge:
    backgroundColor: "{colors.surface-container}"
    textColor: "{colors.on-surface-variant}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.full}"
    padding: 4px 12px
  badge-error:
    backgroundColor: "{colors.error}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.full}"
    padding: 4px 12px
  badge-success:
    backgroundColor: "{colors.success}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.full}"
    padding: 4px 12px
  divider:
    backgroundColor: "{colors.outline}"
    height: 1px
  badge-warning:
    backgroundColor: "{colors.warning}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.sm}"
    padding: 4px 8px
motion:
  duration-short: 150ms
  duration-medium: 300ms
  easing-standard: cubic-bezier(0.4, 0, 0.2, 1)
elevation:
  sm: 0 1px 3px rgba(0,0,0,0.12), 0 1px 2px rgba(0,0,0,0.08)
  md: 0 4px 6px rgba(0,0,0,0.10)
  lg: 0 10px 15px rgba(0,0,0,0.12)
---

## Overview

Kriko's visual identity is clean, highly legible, and utility-focused, designed to build trust and clarity for consumers researching products. It pairs a warm, off-white background with a vibrant, high-contrast primary blue and structured dark navy typography, creating an interface that feels both reliable and highly functional.

## Colors

The color strategy relies on high-contrast, functional pairings that emphasize readability and structure. A warm, paper-like canvas is paired with a striking primary blue for interactive focus, while deep navy anchors the typography and borders.

*   **Primary** (`{colors.primary}`): #2447E6 - The brand's signature vibrant blue, used for primary actions, key links, and focal highlights.
*   **Secondary** (`{colors.secondary}`): #0B1020 - A deep navy black used for primary typography, borders, and high-contrast secondary elements.
*   **Accent** (`{colors.accent}`): #1D3FD0 - A slightly deeper blue used for hover states and active interactive elements.
*   **Background** (`{colors.background}`): #FCFBF8 - A warm, paper-like off-white that serves as the primary canvas, reducing eye strain.
*   **Surface** (`{colors.surface}`): #FCFBF8 - Matches the background to maintain a flat, clean, and unified layout structure.
*   **Surface Container (inferred)** (`{colors.surface-container}`): #F3F1EB - A slightly darker warm gray used for subtle card backgrounds, badges, and structural containers.
*   **On-Primary** (`{colors.on-primary}`): #FFFFFF - Pure white text for maximum contrast against primary blue backgrounds.
*   **On-Surface** (`{colors.on-surface}`): #0B1020 - Deep navy text for primary headings and body copy on warm light surfaces.
*   **On-Surface Variant** (`{colors.on-surface-variant}`): #4A5167 - A muted slate gray for secondary text, metadata, and helper labels.
*   **Outline** (`{colors.outline}`): #0B1020 - High-contrast dark navy border color used for secondary buttons and structural dividers.
*   **Error (inferred)** (`{colors.error}`): #D9381E - A bold red used to highlight serious product defects and critical warnings.
*   **Warning (inferred)** (`{colors.warning}`): #F59E0B - An amber orange used to denote moderate risks or items that need checking.
*   **Success (inferred)** (`{colors.success}`): #10B981 - A clean green used to represent minor issues or positive product attributes.

## Typography

Typography is split between a highly structured sans-serif for headlines and an ultra-readable, accessible sans-serif for body copy and interface labels.

*   **Display Large** (`{typography.display-lg}`): Geist font family, used for massive hero headlines to instantly capture attention.
*   **Display Medium** (`{typography.display-md}`): Geist font family, used for secondary display titles and major section headers.
*   **Headline Large (inferred)** (`{typography.headline-lg}`): Geist font family, used for prominent section titles and feature headers.
*   **Headline Medium (inferred)** (`{typography.headline-md}`): Geist font family, used for standard card titles and sub-section headings.
*   **Headline Small (inferred)** (`{typography.headline-sm}`): Geist font family, used for small card titles and list item headers.
*   **Body Large (inferred)** (`{typography.body-lg}`): Atkinson Hyperlegible Next font family, used for introductory paragraphs and prominent body copy.
*   **Body Medium** (`{typography.body-md}`): Atkinson Hyperlegible Next font family, the standard body copy size, optimized for high readability.
*   **Body Small (inferred)** (`{typography.body-sm}`): Atkinson Hyperlegible Next font family, used for secondary body copy, captions, and detailed descriptions.
*   **Label Medium (inferred)** (`{typography.label-md}`): Atkinson Hyperlegible Next font family, used for button labels, badge text, and interactive controls.
*   **Label Small (inferred)** (`{typography.label-sm}`): Atkinson Hyperlegible Next font family, used for small metadata tags, micro-labels, and status indicators.

## Layout

The layout is built on a structured grid system with a generous max-width container. Spacing is governed by a 12px base unit (represented by `{spacing.md}`), creating clean, predictable vertical rhythm and generous breathing room between sections. Content is primarily left-aligned to mimic editorial layouts, with asymmetric placement of product screenshots and interactive panels to the right.

*   **Observed Section Order**: `nav` → `hero` → `features` → `how-it-works` → `examples` → `catalogs` → `install` → `faq`.
*   **Hero Pattern**: Left-aligned headline and body copy with primary, secondary, and tertiary buttons, paired with a floating app screenshot on a colorful dithered gradient background to the right.
*   **Responsive Behaviour**: Mobile-first layout where the hero section stacks vertically, and the navigation collapses into a clean, simplified layout.

## Elevation & Depth

Subtle single-layer shadows across three levels are used sparingly to establish hierarchy. The elevation values are inferred, prioritizing flat surfaces and high-contrast borders (`{colors.outline}`) over heavy drop shadows.

*   `elevation.sm` (inferred) — subtle card lift and minor interactive elements.
*   `elevation.md` (inferred) — floating panels, dropdowns, and interactive app previews to lift them off the warm background canvas.
*   `elevation.lg` (inferred) — modal overlays and prominent desktop app frames.

## Shapes

The shape language is defined by a mix of highly rounded elements and structured containers. Interactive elements like buttons and badges use fully rounded pill shapes (`{rounded.full}`), while cards and application panels use a friendly but structured corner radius (`{rounded.lg}`) to frame content cleanly. Smaller inputs use `{rounded.md}` for a slightly tighter, more precise form aesthetic, while small warning badges utilize `{rounded.sm}` to maintain a distinct, compact alert style.

## Components

> **Note:** This spec was generated from a website scrape and contains visual approximations.
> For production use, add a deep reference to each component pointing to its authoritative
> source (Storybook story, metadata file, or component spec):
> `→ Deep reference: src/components/Button/metadata.ts`

### button-primary

A pill-shaped CTA using `{colors.primary}` background and `{colors.on-primary}` text. Used for primary actions like downloads or primary navigation links.

### button-primary-hover

Transition state for primary buttons, shifting the background to `{colors.accent}` with standard motion curves.

### button-secondary

A transparent or background-colored button with a solid `{colors.outline}` border and `{colors.secondary}` text. Used for secondary actions.

### button-secondary-hover

Hover state for secondary buttons, shifting the background to `{colors.surface-container}` while maintaining the outline.

### card

A structured container with `{colors.surface}` background, `{rounded.lg}` corners, and a solid `{colors.outline}` border. Used to group content blocks.

### card-elevated

An elevated variant of the card container, utilizing `{colors.surface}` and `{rounded.lg}` without borders, relying instead on elevation tokens for separation.

### input-field

A text input container with `{colors.surface}` background, `{colors.outline}` border, and `{rounded.md}` corners. Uses `{typography.body-md}` for input text.

### input-field-focus

Active state for text inputs, shifting the border color to `{colors.primary}` to indicate focus.

### link

Inline text links styled with `{colors.primary}` and `{typography.body-md}`.

### link-hover

Hover state for inline links, shifting the text color to `{colors.accent}`.

### badge

A pill-shaped metadata tag using `{colors.surface-container}` background and `{colors.on-surface-variant}` text.

### badge-error

A pill-shaped status indicator using `{colors.error}` background and `{colors.on-primary}` text to highlight critical defects.

### badge-success

A pill-shaped status indicator using `{colors.success}` background and `{colors.on-primary}` text for positive attributes.

### badge-warning

A compact status indicator using `{colors.warning}` background and `{rounded.sm}` corners to denote moderate risks.

### divider

A 1px horizontal rule using `{colors.outline}` to separate distinct content blocks.

## Do's and Don'ts

| Do | Don't |
| --- | --- |
| Use `{colors.primary}` for all primary call-to-action buttons like `{button-primary}`. | Never use `{colors.primary}` for body text; reserve it strictly for interactive links and primary CTAs. |
| Apply `{colors.background}` as the main canvas color to maintain the warm, paper-like aesthetic. | Never use pure black (#000000) for body text; always use `{colors.secondary}` or `{colors.on-surface-variant}`. |
| Set headings in the `{typography.display-lg}` or `{typography.display-md}` scales using the Geist font family. | Do not mix font families within body copy; stick entirely to Atkinson Hyperlegible Next (e.g., `{typography.body-md}`). |
| Ensure secondary buttons like `{button-secondary}` use a solid `{colors.outline}` border. | Never omit the `{colors.outline}` border on secondary buttons, as they will lose definition against the warm background. |
| Use `{rounded.full}` exclusively for buttons and pill badges like `{badge}`. | Do not apply sharp 0px corners to cards; always use `{rounded.lg}` to maintain the friendly visual tone. |
| Apply `{colors.error}` and `{colors.warning}` to highlight product defects and risks clearly. | Avoid heavy drop shadows; keep elevation subtle and soft using the defined `{elevation.sm}` or `{elevation.md}` scales. |
| Separate distinct content blocks using a 1px `{divider}` styled with `{colors.outline}`. | Do not use `{colors.accent}` for static text or borders; reserve it strictly for hover states like `{button-primary-hover}` and `{link-hover}`. |
| Use `{rounded.sm}` for alert badges like `{badge-warning}` to keep them compact. | Do not apply `{rounded.full}` to input fields; keep them structured with `{rounded.md}` to fit the input-field token spec. |

## Content Style

Kriko's content style is highly action-oriented, clear, and descriptive. Button labels use direct imperatives such as "Download Kriko for Windows" or "Get the browser extension" to guide the user immediately.

Headlines are direct, benefit-focused, and highly practical. Phrasing is bold and declarative, using statements like "Know what can go wrong before you buy" and "Twenty-eight seconds, with sound" to set expectations clearly.

The copy density is optimized for high scannability. Information is presented in short paragraphs, bulleted lists of key features, and numbered step-by-step guides to minimize cognitive load and allow users to digest technical details quickly.

## Imagery & Icons

App screenshots are presented inside clean device frames or floating panels with rounded corners. Backgrounds feature vibrant, pixelated/dithered gradients in warm orange, pink, and blue tones to provide a soft contrast against the warm paper background canvas. Icons are minimal, stroke-based, and designed to match the clean, utility-focused aesthetic of the interface.

---

## Companion prompt

## Role
You are an AI assistant generating UI components and layouts for Kriko, a minimal, accessible, and bold product research tool with a trustworthy, utility-focused tone. Content, copy, and information architecture remain owned by the product team.

## How to use design.md
1. Reference every visual value by token name — `{colors.primary}`, `{typography.body-md}`, `{rounded.lg}` — never hardcode hex values, pixel sizes, or font names.
2. Build only the components listed under `components:` (`button-primary`, `card`, `badge-error`, etc.). Do not invent variants the spec does not define.
3. Follow `shapesNotes`: use `{rounded.full}` exclusively for buttons and pill badges; use `{rounded.lg}` for cards and panels. Never apply 0px corners to any card.
4. Follow `layoutNotes`: use the 12px base spacing unit (`{spacing.md}`), left-align content editorially, and place interactive panels asymmetrically to the right when laying out feature sections.
5. Treat the Do's and Don'ts as authoritative. If a user request conflicts — for example, requesting primary-colored body text or sharp-cornered cards — surface the conflict explicitly before proceeding.

## Output contract

**Must:**
- Use all tokens by name on every generated component.
- Render hover, focus, and disabled states for every interactive component the spec defines (`button-primary-hover`, `input-field-focus`, `link-hover`, etc.).
- Use `{spacing.xs}` through `{spacing.2xl}` for all padding, gap, and margin values.
- Apply `{colors.error}`, `{colors.warning}`, and `{colors.success}` to defect badges and risk indicators — never substitute alternatives.
- Write CTAs as direct imperatives matching the voice described in `voiceAndContent`; match the scannable, benefit-focused heading tone.

**Must NOT:**
- Invent colors, radii, or font scales absent from the spec.
- Use generic utility defaults when a brand token exists.
- Use `{colors.primary}` for body text — it is reserved for interactive links and primary CTAs only.
- Use pure black (`#000000`) anywhere; use `{colors.on-surface}` or `{colors.on-surface-variant}`.
- Add emoji, filler, or marketing copy.
- Rewrite page copy, button labels, headings, or alter navigation structure.

## When in doubt
- If the spec does not define a value, ask before inventing one.
- For ambiguous backgrounds, default to `{colors.surface-container}` for contained elements and `{colors.background}` for the page canvas.
- For unspecified breakpoints, use mobile-first with one breakpoint at 768px.
- Tokens marked "(inferred)" in any spec prose are approximations; defer to authoritative source tokens if available.
- When torn between two layout options, choose the one with more breathing room — Kriko's aesthetic favors generous spacing over density.
