Skip to content

Repository files navigation

LongCipher Design System

A restrained, technical design system for the LongCipher account portal and brand surface. Near-white canvas, near-black ink, one blue accent, shadow-as-border depth, precise typographic hierarchy. No AI-default flourishes — no rainbow gradients, no pillowy corners, no saturated default fonts.

Design Philosophy

Design serves the task. Every element earns its pixel.

Earn your pixel. Every element must justify its existence. The page is overwhelmingly off-white (#fafbfc) with near-black (#171718) text, creating a quiet surface where content stands. This isn't minimalism as decoration — it's minimalism as engineering principle.

Core tenets:

  • Content over chrome. The surface disappears; the information stands.
  • Consistency over novelty. Reuse tokens, patterns, and rhythms.
  • Accessibility is a requirement. WCAG AA contrast, keyboard-operable flows, visible focus rings.
  • Shadow-as-border. Semi-transparent shadows replace traditional borders for subtler depth.
  • Sharp edges. Avoid rounded corners — 2px is the ceiling. Precise, technical, deliberate.
  • One accent. A single blue (#0a72ef). No second hue, no rainbow.

Files

File Description
DESIGN.md Complete design system — colors, typography, spacing, radius, components, a11y, brand assets
lc.svg Pure mark (no text) — primary asset
lc11.svg 1:1 mark + DM Sans wordmark (path outlines)
lc31.svg 3:1 lockup + slogan
lc43.svg 4:3 lockup + slogan
lc169.svg 16:9 lockup + slogan
scripts/rebuild_logos.py Rebuilds all logo variants from mark geometry + DM Sans (keeps skill copy in sync)
favicons/ Favicon / app icon set (SVG + 16/32 + Apple touch 180 + PWA 192/512 + maskable)
skills/lc-tech-publisher Agent Skill — turn an article into a LongCipher cover + podcast + explainer video

Agent Skill: LongCipher Tech Publisher

After pushing this repo to GitHub, install the skill with:

npx skills add longcipher/brand-kit --skill lc-tech-publisher --full-depth

Then ask your agent (Claude Code / Cursor / Codex):

用 lc-tech-publisher 把这篇文章转成我们的品牌媒体包(封面 + 播客 + 视频)

It runs a 7-step local pipeline — article parsing, narration via Microsoft Edge Neural TTS by default (zh-CN-yunxi, free, no API key, no reference voice; edge-tts installed via uv sync + internet) with an optional local Fun-CosyVoice3-0.5B brand-voice clone, branded cover, HyperFrames composition with audio-synced GSAP timelines — and delivers output/cover.png, output/podcast_full.mp3, and output/explainer_video.mp4. The orchestration scripts are Python, managed with uv; only the HyperFrames render step wraps a Node runtime via npx.

See skills/lc-tech-publisher/README.md for the full workflow.

Quick Reference

Colors

Primary:    #171718  (near-black ink, blue-tinted)
Background: #fafbfc  (off-white canvas)
Surface:    #ffffff  (pure white cards)
Hairline:   #e0e2e8  (neutral-300, borders/dividers)
Blue:       #0a72ef  (the single accent — fills, buttons, focus, large text)
Blue text:  #0a63d0  (links and blue body text — AA on light, 5.47:1)
Error:      #ff5b4f  (red, icons/borders/large only)
Error text: #c62d2d  (error message copy — AA on light)
Focus:      hsla(212,100%,48%,1)

Contrast is a hard rule: body text ≥ 4.5:1, large/UI ≥ 3:1 on its background. #0a72ef fails AA for normal-size text on #fafbfc — use #0a63d0.

Typography

Display:   DM Sans, 700 weight, -0.02em tracking
Body:      DM Sans, 400 weight, 0 tracking
Code:      JetBrains Mono, 400 weight, tabular-nums
CJK:       PingFang SC / Microsoft YaHei / Noto Sans SC fallback
Wordmark:  DM Sans 700 path outlines in logo files (no font dependency)

Spacing

Base:  4px
Group: 8px → 16px → 32px (three-step rhythm)

Radius — keep it sharp

UI surfaces: 2px (cards, inputs, buttons, chips, tooltips)
Exceptions:  illustration chips ≤16px; diagram primitives (nodes/dots) may be round
No pills, no circular avatars, no 6/12/16px rounding on chrome.

Dark Theme

Surfaces:  #0a0a0c → #2a2d33
Text:      #ededed (primary), #b4b8c2 (secondary)
Shadows:   White/alpha instead of black/alpha
Focus:     0 0 0 1px hsla(212,100%,48%,1), 0 0 0 4px hsla(212,100%,48%,0.18)

Tailwind Mapping (v4)

Colors:    bg-canvas, bg-surface, text-ink, bg-blue, bg-error
Type:      font-sans (DM Sans), font-mono (JetBrains Mono)
Shadow:    shadow-border (ring), shadow-card, shadow-elevated
Radius:    rounded-sm (2px) — the only radius
Motion:    transition-[transform,opacity] duration-150
Dark:      dark:shadow-elevated, dark:shadow-focus-ring

Semantic Tokens

Surfaces:  bg-canvas, bg-surface, bg-subtle
Text:      text-ink, text-body, text-muted, text-placeholder
Borders:   shadow-border (hairline via shadow)
States:    bg-error, text-link, ring-blue
Brand:     bg-blue, ring-blue

Semantic tokens decouple intent from raw values — prefer them over primitives for component styling. They auto-resolve in dark mode.

See DESIGN.md for the complete spec (color, typography, shadow-as-border, components, voice, a11y).

References

About

LongCipher DESIGN.md and Brand Kit

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages