Skip to content

po4yka/RIPDPI / docs/design/rds

ripdpi-design

Verified

Use this skill to generate well-branded interfaces and assets for RIPDPI (an Android-native, Compose-first VPN and DPI-bypass app), either for production or throwaway prototypes/mocks/etc. Contains essential design guidelines, colors, type, fonts, brand-ship icons, and an interactive UI kit of every public composable from the live ui/components tree.

FileKindSize
COVERAGE.mdmarkdown23.0 KB
README.mdmarkdown19.6 KB
SKILL.mdskill md4.0 KB
assets/ic_launcher.pngbinary9.7 KB
assets/ic_launcher.svgother3.0 KB
assets/icons/ic_article_outline.svgother315 B
assets/icons/ic_launcher_foreground_ripdpi_clean.svgother3.0 KB
assets/icons/ic_launcher_foreground_ripdpi_cracked.svgother6.6 KB
assets/icons/ic_launcher_foreground_ripdpi_disintegrate.svgother9.5 KB
assets/icons/ic_launcher_foreground_ripdpi_glitch.svgother8.4 KB
assets/icons/ic_launcher_foreground_ripdpi_rubble.svgother7.8 KB
assets/icons/ic_launcher_foreground_ripdpi_stitch.svgother13.3 KB
assets/icons/ic_launcher_monochrome_ripdpi.svgother3.0 KB
assets/icons/ic_notification.svgother270 B
assets/icons/ic_settings_outline.svgother1.0 KB
assets/icons/ic_stop_outline.svgother153 B
assets/icons/ic_tune_outline.svgother244 B
assets/icons/ic_vpn_key_outline.svgother296 B
assets/icons/ripdpi_wordmark.svgother34.6 KB
assets/raw/ic_article_outline.xmlconfig552 B
assets/raw/ic_launcher_foreground_ripdpi_clean.xmlconfig3.4 KB
assets/raw/ic_launcher_foreground_ripdpi_cracked.xmlconfig7.0 KB
assets/raw/ic_launcher_foreground_ripdpi_disintegrate.xmlconfig10.1 KB
assets/raw/ic_launcher_foreground_ripdpi_glitch.xmlconfig8.7 KB
assets/raw/ic_launcher_foreground_ripdpi_rubble.xmlconfig8.4 KB
assets/raw/ic_launcher_foreground_ripdpi_stitch.xmlconfig13.5 KB
assets/raw/ic_launcher_monochrome_ripdpi.xmlconfig3.4 KB
assets/raw/ic_notification.xmlconfig3.4 KB
assets/raw/ic_settings_outline.xmlconfig1.2 KB
assets/raw/ic_stop_outline.xmlconfig338 B
assets/raw/ic_tune_outline.xmlconfig429 B
assets/raw/ic_vpn_key_outline.xmlconfig481 B
colors_and_type.cssother12.2 KB
diagnostic-reports-index.htmlother4.8 KB
fonts/geist_mono_bold.ttfbinary146.8 KB
fonts/geist_mono_medium.ttfbinary145.7 KB
fonts/geist_mono_regular.ttfbinary144.9 KB
fonts/geist_sans_bold.ttfbinary125.7 KB
fonts/geist_sans_medium.ttfbinary124.6 KB
fonts/geist_sans_regular.ttfbinary123.0 KB
mobile-diagnostic-report.htmlother12.0 KB
mobile-elements-showcase.htmlother19.3 KB
mobile-vpn-connection.htmlother12.2 KB
preview/a11y-color-contrast.htmlother8.3 KB
preview/a11y-focus-rings.htmlother6.5 KB
preview/android-crash-screen.htmlother2.3 KB
preview/android-customization.htmlother3.0 KB
preview/android-glance-widget.htmlother4.0 KB
preview/android-history.htmlother2.3 KB
preview/android-nav-bar.htmlother1.6 KB
preview/android-nav-rail.htmlother3.2 KB
preview/android-notif-foreground.htmlother3.4 KB
preview/android-notif-heads-up.htmlother2.5 KB
preview/android-notif-lock-screen.htmlother2.3 KB
preview/android-permission-rationale.htmlother3.0 KB
preview/android-qs-tile.htmlother2.3 KB
preview/android-scanner.htmlother1.9 KB
preview/android-splash.htmlother1.4 KB
preview/android-split-columns.htmlother2.1 KB
preview/android-status-bar.htmlother2.9 KB
preview/android-vpn-permission.htmlother2.0 KB
preview/brand-launcher-variants.htmlother4.7 KB
preview/brand-mark.htmlother3.4 KB
preview/color-anchors.htmlother2.0 KB
preview/color-destructive.htmlother1.9 KB
preview/color-edges.htmlother3.4 KB
preview/color-info.htmlother1.8 KB
preview/color-neutrals.htmlother3.3 KB
preview/color-restricted.htmlother1.9 KB
preview/color-success.htmlother1.8 KB
preview/color-warning.htmlother1.8 KB
preview/components-accordion.htmlother6.2 KB
preview/components-actuator-states.htmlother8.8 KB
preview/components-actuator.htmlother6.6 KB
preview/components-analysis-progress.htmlother2.1 KB
preview/components-bottom-nav.htmlother2.1 KB
preview/components-bottom-sheet.htmlother2.0 KB
preview/components-brand-badge.htmlother2.6 KB
preview/components-buttons.htmlother2.5 KB
preview/components-card.htmlother2.1 KB
preview/components-chips.htmlother1.6 KB
preview/components-cidr-input.htmlother5.0 KB
preview/components-combobox.htmlother6.8 KB
preview/components-command-palette.htmlother7.3 KB
preview/components-dialog.htmlother2.1 KB
preview/components-diff-viewer.htmlother6.6 KB
preview/components-dropdown.htmlother2.6 KB
preview/components-empty-state.htmlother1.5 KB
preview/components-filter-bar.htmlother5.9 KB
preview/components-heartbeat-indicator.htmlother6.4 KB
preview/components-icon-buttons.htmlother3.9 KB
preview/components-json-tree.htmlother7.7 KB
preview/components-kbd-shortcut.htmlother4.2 KB
preview/components-live-counter.htmlother7.3 KB
preview/components-log-row.htmlother2.5 KB
preview/components-log-stream.htmlother7.5 KB
preview/components-metric-pill.htmlother1.7 KB
preview/components-page-indicators.htmlother1.4 KB
preview/components-preset-card.htmlother2.0 KB
preview/components-progress-bar.htmlother4.8 KB
preview/components-section-header.htmlother1.7 KB
preview/components-segmented.htmlother4.3 KB
preview/components-settings-row.htmlother2.0 KB
preview/components-shimmer.htmlother3.9 KB
preview/components-slider.htmlother6.6 KB
preview/components-snackbar.htmlother3.0 KB
preview/components-spinner.htmlother1.8 KB
preview/components-stage-progress.htmlother1.9 KB
preview/components-stale-data-badge.htmlother5.8 KB
preview/components-status-indicator.htmlother1.9 KB
preview/components-stepper.htmlother7.0 KB
preview/components-switch.htmlother1.8 KB
preview/components-tabs.htmlother4.6 KB
preview/components-text-action.htmlother2.2 KB
preview/components-text-field.htmlother1.8 KB
preview/components-toggle-alternatives.htmlother2.4 KB
preview/components-tooltip.htmlother2.0 KB
preview/components-top-app-bar.htmlother2.3 KB
preview/components-warning-banner.htmlother3.1 KB
preview/diagnostic-censorship-signature.htmlother8.1 KB
preview/diagnostic-dns-resolvers.htmlother10.1 KB
preview/diagnostic-hop-trace.htmlother7.1 KB
preview/diagnostic-mtu-scan.htmlother7.4 KB
preview/diagnostic-port-matrix.htmlother7.5 KB
preview/diagnostic-report-summary.htmlother5.2 KB
preview/gesture-long-press-menu.htmlother6.9 KB
preview/gesture-pull-to-refresh.htmlother8.5 KB
preview/gesture-swipe-actions.htmlother7.4 KB
preview/icon-set.htmlother2.9 KB
preview/motion-connection-states.htmlother7.5 KB
preview/motion-data-ticker.htmlother5.5 KB
preview/motion-easing-curves.htmlother4.6 KB
preview/motion-page-transitions.htmlother6.0 KB
preview/motion-probe-pulse.htmlother5.4 KB
preview/motion-reduced-motion.htmlother6.7 KB
preview/motion-skeleton-shimmer.htmlother5.8 KB
preview/motion-toast-choreography.htmlother8.4 KB
preview/motion-tokens.htmlother2.8 KB
preview/onboarding-coach-mark.htmlother7.6 KB
preview/onboarding-tour-cards.htmlother5.6 KB
preview/preview.cssother1.9 KB
preview/radii.htmlother3.8 KB
preview/share-bottom-sheet.htmlother5.6 KB
preview/share-link-preview.htmlother5.1 KB
preview/share-qr-code.htmlother5.2 KB
preview/share-result-viewer.htmlother3.5 KB
preview/share-stats-card.htmlother3.5 KB
preview/spacing-scale.htmlother3.6 KB
preview/strokes.htmlother1.3 KB
preview/touch-targets.htmlother1.9 KB
preview/type-body.htmlother1.4 KB
preview/type-brand.htmlother1.1 KB
preview/type-display.htmlother1.4 KB
preview/type-mono.htmlother1.4 KB
preview/type-section-title.htmlother1.3 KB
preview/vpn-awg-editor.htmlother12.6 KB
preview/vpn-block-check.htmlother3.5 KB
preview/vpn-confirm-disconnect.htmlother2.4 KB
preview/vpn-data-transparency.htmlother3.9 KB
preview/vpn-degradation-strip.htmlother5.5 KB
preview/vpn-detection-check.htmlother3.7 KB
preview/vpn-dns-picker.htmlother3.4 KB
preview/vpn-export-consent.htmlother3.6 KB
preview/vpn-first-run-test.htmlother5.1 KB
preview/vpn-handshake-timeline.htmlother9.7 KB
preview/vpn-identity-card.htmlother2.8 KB
preview/vpn-in-app-browser.htmlother3.9 KB
preview/vpn-kill-switch.htmlother3.7 KB
preview/vpn-latency-graph.htmlother2.9 KB
preview/vpn-network-change.htmlother2.9 KB
preview/vpn-oom-recovery.htmlother2.4 KB
preview/vpn-pcap-viewer.htmlother3.1 KB
preview/vpn-per-app-routing.htmlother3.9 KB
preview/vpn-permission-summary.htmlother3.4 KB
preview/vpn-presets-gallery.htmlother3.3 KB
preview/vpn-probe-live.htmlother3.0 KB
preview/vpn-profile-switcher.htmlother2.9 KB
preview/vpn-quick-vs-advanced.htmlother3.0 KB
preview/vpn-reconnect-toast.htmlother5.9 KB
preview/vpn-relay-picker.htmlother4.0 KB
preview/vpn-replay-failure.htmlother3.6 KB
preview/vpn-session-card.htmlother7.2 KB
preview/vpn-snooze.htmlother2.9 KB
preview/vpn-state-history.htmlother9.2 KB
preview/vpn-state-machine.htmlother11.4 KB
preview/vpn-strategy-ab.htmlother5.0 KB
preview/vpn-strategy-editor.htmlother4.2 KB
preview/vpn-strategy-import.htmlother3.6 KB
preview/vpn-strategy-probe-wizard.htmlother3.8 KB
preview/vpn-throughput-graph.htmlother3.5 KB
preview/whats-new-card.htmlother6.1 KB
ui_kits/android/MobileDiagnosticReport.jsxother33.4 KB
ui_kits/android/MobileElements.jsxother34.1 KB
ui_kits/android/MobileVpnConnection.jsxother36.6 KB
ui_kits/android/README.mdmarkdown3.5 KB
ui_kits/android/RipDpiComponents.jsxother27.1 KB
ui_kits/android/RipDpiScreens.jsxother17.7 KB
ui_kits/android/android-frame.jsxother9.2 KB
ui_kits/android/index.htmlother14.2 KB
# RIPDPI Design System (RDS)

> **Engineering-tool register, not consumer-brand register.** RDS is the
> token-and-component system behind RIPDPI, an Android-native, Compose-first
> app for privacy-focused VPN and DPI-bypass with packet-level configuration
> and network telemetry. The visual language reads closer to a network
> analyzer or developer console than a streaming app — calm, precise,
> near-monochrome, slightly utilitarian.

## What this is

RDS is built on Material 3 Expressive and extended with engineering-grade
**token layers** (color, type, spacing, shape, motion, layout, component,
state, surface) tuned for dense diagnostics, network telemetry, packet-level
configuration, and high-stakes connection controls.

| Surface today | Shape | Notes |
| --- | --- | --- |
| Android phone (8.0+) | ~7,000 LOC of composables, 60+ public components | Primary surface |
| Glance home-screen widget | Parallel theme tree `RipDpiGlanceTheme` / `RipDpiGlanceColors` | Token names kept in sync with Compose theme |
| _Future_ — Wear OS, KMP docs, Figma library, marketing site | Same semantic tokens, thin platform bridge | Token shape is deliberately platform-agnostic |

Localized into the locales listed in `app/src/main/res/xml/locales_config.xml` (currently 10: `en`, `ru`, `es`, `de`, `fr`, `fa`, `ar`, `zh-CN`, `hi`, `pt-BR`).
`lint.xml` sets `MissingTranslation severity="error"` — every new string
ships into all locales in the same commit.

## Sources used to build this design system

| Source | Where | Notes |
| --- | --- | --- |
| **Codebase (Compose UI tree)** | `ui/` mount via the project file system, paths `ui/components/…`, `ui/screens/…`, `ui/theme/…` | Primary source of truth — read these directly |
| **GitHub repo** | <https://github.com/po4yka/RIPDPI> | Browse `app/`, `core/`, `docs/`, `DESIGN.md`, `README.md`, the locale READMEs |
| **Brand & icon assets** | Uploaded TTF + Android vector drawables, copied into `fonts/` and `assets/` of this project | Includes 6 launcher-foreground variants of the brand mark |

To extend the system or rebuild fidelity, explore the GitHub repo above
directly — `DESIGN.md` and the `ui/theme/` Kotlin files are the formal
contract. `app/src/test/kotlin/com/poyka/ripdpi/ui/theme/` (the
`RipDpiColorContrastTest`, `RipDpiStateTokensTest`, `RipDpiSurfaceTokensTest`)
encode the rules in code.

---

## Index — what's in this folder

```
README.md                        ← you are here
SKILL.md                         ← agent skill manifest (Claude Code compatible)
colors_and_type.css              ← all tokens as CSS custom properties + @font-face

fonts/                           ← Geist Sans, Geist Mono
assets/
  ic_launcher.png                ← brand mark (raster, = app/src/main/ic_launcher-playstore.png)
  ic_launcher.svg                ← vector master of ic_launcher.png (512 px, full bleed)
  icons/                         ← Android vector drawables converted to SVG
    ic_launcher_foreground_ripdpi_clean.svg        ← canonical brand mark
    ic_launcher_foreground_ripdpi_cracked.svg      ← variant: "cracked"
    ic_launcher_foreground_ripdpi_disintegrate.svg ← variant: "disintegrate"
    ic_launcher_foreground_ripdpi_glitch.svg       ← variant: "glitch"
    ic_launcher_foreground_ripdpi_rubble.svg       ← variant: "rubble"
    ic_launcher_foreground_ripdpi_stitch.svg       ← variant: "stitch"
    ic_launcher_monochrome_ripdpi.svg              ← themed icon (Android 13+)
    ic_settings_outline.svg
    ic_tune_outline.svg
    ic_stop_outline.svg
    ic_vpn_key_outline.svg
    ic_article_outline.svg
    ic_notification.svg
    ripdpi_wordmark.svg                            ← About card wordmark
  raw/                           ← Android vector drawable XML sources (kept for parity)

preview/                         ← Design System cards — one foundational concept each
ui_kits/
  android/                       ← Android phone UI kit (Compose components recreated in JSX)
    README.md
    index.html                   ← interactive click-through prototype
    *.jsx                        ← composable analogs: button, card, switch, chip, etc.
```

## Index — reading order for an agent or designer new to the system

1. This file (`README.md`) — for the register, the don'ts, the voice.
2. `colors_and_type.css` — for every token you'll consume.
3. `ui_kits/android/index.html` — to see the tokens composed into screens.
4. The `preview/*.html` cards — atomic spec sheets for each token cluster.
5. The Kotlin source under `ui/theme/` (in the mounted codebase) — the formal
   contract; tokens are immutable data classes, never raw constants.

---

## Content fundamentals

The voice is **precise, technical, and calm**. Strings are imperative and use
product-domain vocabulary without softening or analogizing. Decorative copy
is forbidden by design — there is no "marketing pass" later; the placeholder
copy that ships in screenshots **is** the production copy.

### Casing & person
- **Sentence case everywhere.** `Connect`, `Reset cache`, `Open diagnostics`.
  Not Title Case, not ALL CAPS. The one exception: section headers use the
  `sectionTitle` style which is rendered uppercase-feeling via tracked
  letter-spacing (0.72px) but the source string is still sentence case.
- **No second person.** Strings address the system, not the user. `Apply
  strategy`, not `Apply your strategy`. Empty states explain what the screen
  _does_, not what the user _wants_.
- **No first person.** No "we", no "let's", no "you'll need to".

### Vocabulary (use these, don't dilute them)
`probe`, `strategy`, `relay`, `transport`, `DPI`, `fingerprint`, `fragment`,
`route`, `tunnel`, `MTU`, `desync`, `host fake`, `seq overlap`, `TLS prelude`,
`pluggable transport`, `whitelist`, `bypass`, `actuator`, `pcap`.

### Numbers carry units; units never translate
`128 KiB`, `12 ms`, `1500 MTU`, `00:18:42`, `127.0.0.1:1080`. In `monoValue`
style — never sans, never localized.

### Empty states
One sentence describing what the screen is for, then the single most likely
next action.
> _Examples (from the codebase):_
> - **No analysis yet** → primary action: `Run scan`.
> - **No saved presets** → primary action: `Save current strategy`.

### Error states
Name what failed in technical terms, offer remediation, never apologize.
> _Examples:_
> - **`Failed to start VPN`** + secondary line with cause + action `Retry` /
>   `Open VPN permission`.
> - **`Validation warning — Double-check the current values before saving the
>   preset.`** — warning banner tone.
> - **`Manual step required — VPN permission must be granted before the
>   service can start.`** — info banner tone.
> - **`Feature unavailable — This control only applies when command-line
>   mode is enabled.`** — restricted banner tone.

### Buttons are imperative verbs
`Connect`, `Disconnect`, `Disable`, `Enable`, `Run scan`, `Configure`,
`Reset cache`, `Reload strategy`, `Apply`, `Retry`, `Cancel`, `Save`, `Open
diagnostics`, `Reset to defaults`. One- or two-word labels. Never a
sentence, never marketing voice.

### Status labels are short and technical
`Connected 00:18:42`, `Connecting`, `Disconnected`, `Inactive`,
`Stage 2 of 4 — Testing TCP`, `Running`, `Idle`, `Warning`, `Error`.

### Emoji
**Not used.** Anywhere. The brand-mark variants and monoglyph status
indicators are the only "icon-like" decorations on a surface. Unicode glyphs
are not used as icons either. Sentinel state uses small shape primitives
(circle, triangle, square, diamond) drawn on a `Canvas`, not characters.

### Vibe in one line
A senior network engineer at 11 pm reading a packet capture. Calm. Precise.
No marketing flourish. No apology. The next correct action is one
imperative button away.

---

## Visual foundations

### Color
The palette is intentionally narrow and almost entirely **neutral**. Color
is reserved for semantic state and is **never used decoratively**.

- **Light mode anchor** — `#FAFAFA` background, `#1A1A1A` foreground.
- **Dark mode anchor** — `#121212` background (never pure black — avoids
  OLED smearing), `#E8E8E8` foreground.
- **Semantic states** ship in 4 variants each (base, foreground, container,
  container-foreground) across both modes:
  - `success` emerald — `#047857` / `#34D399`
  - `warning` amber — `#B45309` / `#FBBF24`
  - `destructive` red — `#B91C1C` / `#F87171`
  - `info` blue — `#1D4ED8` / `#60A5FA`
  - `restricted` slate — `#6B7280` / `#9CA3AF` (root-only / capability-gated)
- **Three contrast levels** — Standard / Medium / High blend
  `mutedForeground`, `border`, `cardBorder`, `outlineVariant` toward
  `foreground` at fixed ratios. WCAG AA across all three is enforced by
  `RipDpiColorContrastTest`.
- **Not Material You.** Brand identity overrides the system accent, and
  dynamic color is **disabled**.
- **No tertiary accent colors.** No decorative purple, no on-trend gradient,
  no third "brand" hue.

### Typography
Three families, no exceptions:
- **Geist Sans** — every UI string.
- **Geist Mono** — every value that represents engineering data (IPs, hex,
  byte counts, packet traces, configuration keys, log lines, latency,
  durations). Mono **signals to the user that a value is machine-readable
  and copy-pasteable**.

`PlatformTextStyle(includeFontPadding = false)` is set globally so vertical
rhythm is honored. The type scale is small and shallow — extend
`RipDpiTextStyles` rather than introducing new sizes.

### Spacing
Closed 9-step scale (dp) exposed via `RipDpiSpacing.xs … screen`:
**4 / 8 / 12 / 16 / 20 / 24 / 32 / 40 / 48**.

Three width classes at breakpoints `600dp` and `840dp` (Compact / Medium /
Expanded). Each supplies a complete `RipDpiLayout` block — horizontal
padding (20/28/32), content max-width (560/720/960), form max-width
(520/600/680), card padding (16/18/20), section/group gap, app-bar
heights. Forms are **width-capped** on wide screens — content centers, it
never stretches edge-to-edge.

### Touch targets
**48dp floor everywhere.** Button minHeight, iconButton size, control
height, switch height, settings-row min-height — non-negotiable across all
widths.

### Backgrounds
- No images.
- No gradients.
- No illustration.
- No repeating patterns or textures.
- No skeuomorphism.
- Just `--rdp-background` and `--rdp-card`. Variety comes from semantic
  containers (`*-container` colors) used by banners and chips at their
  correct contrast level.

### Depth, elevation, and shadows
The system **avoids shadows almost entirely**. Depth is communicated with:
- **1dp border** (`RipDpiStroke.Thin`) — outlined cards, primary edges
- **0.5dp hairline** (`RipDpiStroke.Hairline` on `#666666`) — fine
  separators, dense list rows
- **`cardBorder` / `divider` / `outlineVariant`** tokens — every other edge
- A **subtle surface tint** via `RipDpiSurfaceTokens` — never a drop shadow

Material 3 elevation surfaces are mapped through explicit surface roles
(`card`, `cardElevated`, `bannerInfo`, etc.) so a future redesign that
introduces shadow or blur can be done at the **token** level without
touching components.

### Corner radii (closed scale, dp)
| Token | dp | Used for |
| --- | --- | --- |
| `xs` | 4 | Tiny inline tags |
| `sm` | 8 | Sub-card surfaces |
| `md` | 10 | Inline tonal blocks |
| `lg` (chip) | 12 | Chips |
| `xl` (control / card) | 16 | Buttons, text fields, cards |
| `xl-increased` | 20 | Pressed-state grown chip |
| `xxl` (pill) | 28 | Pill / actuator carriage |
| `xxl-increased` | 32 | Hero pill |
| `xxxl` (hero) | 48 | Connection actuator surround |
| `full` | `CircleShape` | Brand badge, status pulse, dismiss icon |

### Animation
Motion is a first-class token layer (`RipDpiMotion`), **not a per-component
decision**. Vocabulary is small and named:

| Token | Duration | Use |
| --- | --- | --- |
| `quick` | 120ms | State changes, taps, scale on press |
| `state` | 220ms | Color / opacity transitions |
| `emphasized` | 320ms | Section expansion |
| `route` | 260ms | Navigation transitions |

Easings (Material 3 Expressive):
- `EmphasizedDecelerate` — `cubic-bezier(0.05, 0.7, 0.1, 1.0)` — entering
- `EmphasizedAccelerate` — `cubic-bezier(0.3, 0.0, 0.8, 0.15)` — exiting
- `StandardEasing` — `cubic-bezier(0.2, 0.0, 0.0, 1.0)` — in-place

Springs come in two variants:
- **Standard** — damping 1.0, stiffness 500 — critically damped, no
  overshoot. Used for press/release.
- **Expressive** — damping 0.7, stiffness 400 — slight bounce for selection
  emphasis.

`reducedMotion` collapses durations to a minimum of 80ms and substitutes
critically-damped springs everywhere. `animationsEnabled = false` returns
`EnterTransition.None` / `ExitTransition.None` so previews and inspection
mode are deterministic.

### Hover, press, focus
- **Hover** — not applicable on touch surfaces. Pointer-input surfaces (Wear
  OS or web) use a subtle `--rdp-accent` background hint.
- **Press** — `pressScale = 0.98` (scale down), critically-damped spring.
  No color change beyond the resolved press state in the relevant
  `RipDpi*StateTokens` data object. **Never** an ad-hoc darkening or
  lightening.
- **Selection emphasis** — `selectionScale = 1.02`, expressive spring.
- **Focus** — visible focus border thickens or grows the corner radius
  rather than introducing a glow. Density compensates with
  `focusedHorizontalPaddingOffset = 4dp` so the layout doesn't shift.

### Transparency and blur
Used sparingly:
- **Scrim** behind modal sheets and dialogs (`#000000 60%` light /
  `#000000 80%` dark).
- **`contentAlpha`** on disabled buttons / cards (`0.38` global disabled
  alpha).
- **No background blur**, no glassmorphism, no frosted panels. They
  contradict the "engineering tool" register.

### Imagery
There is no product imagery. The only raster asset is the launcher icon
(`assets/ic_launcher.png`). All other visual signal comes from type,
mono-glyph status markers, and the 6 launcher-foreground brand-mark variants
(clean, cracked, disintegrate, glitch, rubble, stitch).

### Cards
| | |
| --- | --- |
| Background | `--rdp-card` (`#FFFFFF` / `#1A1A1A`) |
| Border | `--rdp-card-border` (`#E8E8E8` / `#2A2A2A`), 1dp |
| Border radius | `--rdp-radius-xl` (16dp) |
| Padding | `--rdp-card-padding` (16/18/20 by width class) |
| Shadow | **None** (this is the system rule) |
| Inner spacing | `--rdp-space-sm` (8dp) between rows |

There are 4 variants — `Outlined` (default), `Tonal` (active state, tinted
muted background), `Elevated` (slightly higher-priority surface, still no
shadow, just a brighter border), `Status` (semantic-container background).

---

## Iconography

### What ships with the brand
The product's own iconography is **outline Material-style** drawn on a
**24×24 viewport**, all stroke 2 (within the Material guidelines), tinted
to `--rdp-foreground` by default and to the resolved state color when used
inside a `WarningBanner` or `StatusIndicator`.

In this folder you have:
- **`assets/icons/ic_settings_outline.svg`** — settings gear (Material
  spec)
- **`assets/icons/ic_tune_outline.svg`** — advanced settings dial
- **`assets/icons/ic_stop_outline.svg`** — stop / pause connection
- **`assets/icons/ic_vpn_key_outline.svg`** — VPN config
- **`assets/icons/ic_article_outline.svg`** — logs / documentation
- **`assets/icons/ic_notification.svg`** — system notification icon

These were copied from `app/src/main/res/drawable/` and converted from
Android vector drawables to SVG (same path data — no re-drawing). They are
the **brand-ship icons** for the surfaces they appear on; everything else
in the live app draws from **`androidx.compose.material.icons`** (Material
Symbols) via the central `RipDpiIcons` accessor at `ui/theme/RipDpiIcons.kt`
in the codebase.

### Icon strategy for new HTML mocks
1. **Prefer the bundled SVGs** in `assets/icons/`. They are the brand-ship
   set.
2. For Material Symbols (Settings, Lock, Warning, Info, Close, Check,
   ChevronRight, Refresh, etc.), use them at the **same 24×24 outline
   style, weight 400, stroke 2** — link Google's Material Symbols CSS
   stylesheet (`outlined`, weight 400) from a CDN, or copy the specific
   ones in.
3. **Substitution flag** — if you reach for any non-Material icon set
   (Lucide, Heroicons, Phosphor), call it out in your output. The brand
   contract is Material outline; deviations are a deliberate departure.

### Brand mark variants
Six glyph variants of the RIPDPI brand mark exist as launcher-foreground
vector drawables — `clean`, `cracked`, `disintegrate`, `glitch`, `rubble`,
`stitch`. They are used **only on the launcher icon, splash, and onboarding
surfaces**. Default to `clean` everywhere else. The other five exist to
imply the product's purpose (disrupting deep-packet inspection) without
animating or decorating other surfaces.

### Emoji
**Not used.** Anywhere.

### Unicode characters as icons
**Not used.** Sentinel shapes (idle = diamond, active = filled circle,
warning = triangle, error = square) are drawn on `Canvas` in the live app,
or as inline `<svg>` in HTML. See `StatusIndicator.kt`.

---

## Do's and don'ts

**Do**
- Extend the system by **adding fields to the matching token data class**
  (`RipDpiExtendedColors`, `RipDpiTextStyles`, `RipDpiShapeMetrics`,
  `RipDpi*Metrics`, `RipDpi*StateTokens`, `RipDpiSurfaceRoleMappings`) and
  reading them via `RipDpiThemeTokens`.
- Go through `RipDpiMotion.duration()` for **every** animation so that
  `reducedMotion` and `ValueAnimator.areAnimatorsEnabled()` are honored
  automatically.
- Localize every string into every locale registered in `app/src/main/res/xml/locales_config.xml` **in the same commit**.
- Expose proper semantics on bespoke controls (the connect actuator
  declares `role = Switch` with a `stateDescription`).

**Don't**
- Introduce Material You / dynamic color, decorative gradients, illustration,
  tertiary accent colors, scroll-jacked hero animations, serif display
  fonts, or marketing-site flourishes.
- Bypass token layers with one-off `Color(0xFF…)`, one-off
  `Modifier.background()`, one-off `tween(220)`, one-off `TextStyle(...)`.
- Write decorative copy. Strings are imperative and technical.

---

## What this system is **not** (guardrails)

- **Not** a Material You / dynamic-color system. Brand identity overrides
  system accents.
- **Not** a decorative system. Illustration, gradients, tertiary colors,
  and hero animation are intentionally absent.
- **Not** a marketing-site system. No parallax, no scroll-jacking, no serif
  display fonts.
- **Not** iOS. Touch targets, density, and motion are tuned for Android
  Material 3 Expressive, not for HIG.
- **Not** a multi-brand or white-label system. There is one brand.

New work that introduces any of the above should be flagged as a deliberate
departure with a written justification, not slipped in as a refinement.

---

## Substitutions & caveats

- **Fonts present** — Geist Sans (Regular/Medium/Bold), Geist Mono
  (Regular/Medium/Bold). **No substitutions in place.**
- **Icons** — only the 6 hand-drawn brand-ship icons listed above are
  bundled. Anything else used in a mock should be sourced from Material
  Symbols at outline / weight 400 / 24×24, and the choice flagged.
- **Brand-mark variants** — the 6 launcher-foreground variants are
  technically "for the launcher icon" but I've kept them in `assets/icons/`
  for any future onboarding/splash exploration.
- The Compose-side spring specs (`damping 1.0 stiffness 500`) cannot be
  perfectly replicated in CSS; the `--rdp-ease-standard-spring` and
  `--rdp-ease-expressive-spring` tokens are approximations for HTML
  mockups only. **Production code must use `RipDpiMotion.*Spring()`**.
- **UI kit `ui_kits/android/`** — the JSX recreations approximate state
  transitions; they don't go through `RipDpi*StateTokens`. Treat as visual
  fidelity, not behavioural fidelity.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall