奥坎玻璃

设计与多媒体 社区

技能解读

当前原文的自动摘译,尚未人工审校。

快速入门

将assets/globals.css复制到您的Next.js项目中,作为app/globals.css导入到您的布局中:import "./globals.css"使用玻璃类:<div class="glass-card">,<button class="glass-button glass-button-primary">就是这样。所有 shadcn/ui 组件将自动选择 Arcan Glass 主题。

7 设计原则

首先是深色模式,其次是日光玻璃 — 默认为深色模式。灯光模式保持相同的 275° 色调 DNA,具有更高的亮度、低色度和接地阴影。玻璃是赢得的——只有关键表面(导航、侧边栏、模态、特色卡片)才会获得背景过滤器。每个视口限制为 3-5 个。通过表面打造品牌 — 表面色调 275°(蓝紫色)将所有表面连接到 AI Blue,无需竞争。 OKLCh 主要 — 感知均匀的亮度可实现清晰的深度尺度和自然的色彩混合。

玻璃效果系统

每个玻璃组件均由 4 个可组合层组成: 层 · 技术 · 目的 背景模糊 · backdrop-filter: blur() saturate() · 磨砂玻璃基础 高光 · ::before 具有顶部边缘渐变 · 光反射/深度提示 阴影 · 多级 box-shadow · 仰角/接地

色彩系统

OKLCh 中的品牌颜色,带十六进制后备: 标记 · 颜色 · 用法 --ag-ai-blue · oklch(0.55 0.25 260) / #0066FF · 主要、交互、链接 --ag-web3-green · oklch(0.72 0.19 155) / #00CC66 · 重音、成功、web3 色调 275° 的 5 级表面刻度、4 级文本层次结构、语义颜色,3 级边框比例。

顺风整合

所有通过 @theme inline 连接的代币:shadcn/ui 组件均保持不变 — bg-primary、bg-card、text-muted-foreground 等全部解析为 Arcan Glass 代币。完整映射:references/tailwind-integration.md

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
设计与多媒体
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Arcan Glass

**Arcan Glass** is BroomVA's trademark web design language — ArcanBG's brand DNA (AI Blue `#0066FF` + Web3 Green `#00CC66` + dark surfaces) fused with liquid glass web effects (backdrop-filter blur, layered highlights, adaptive tinting, morphing transitions). Dark-first, glass-elevated.

Light mode is **Day Glass**: a luminous 275° violet surface system, not a white inversion. It keeps hue continuity, uses low chroma to avoid glare, and preserves clear OKLCh lightness distance between surfaces, text, borders, and shadows.

## Quick Start

1. **Copy** `assets/globals.css` into your Next.js project as `app/globals.css`
2. **Import** in your layout: `import "./globals.css"`
3. **Use** glass classes: `<div class="glass-card">`, `<button class="glass-button glass-button-primary">`

That's it. All shadcn/ui components will automatically pick up the Arcan Glass theme.

## 7 Design Principles

1. **Dark-first, Day Glass second** — The default is dark mode. Light mode keeps the same 275° hue DNA with higher lightness, low chroma, and grounded shadows.
2. **Glass is earned** — Only key surfaces (nav, sidebar, modal, featured cards) get backdrop-filter. Limit to 3-5 per viewport.
3. **Brand through surface** — Surface hue 275° (blue-purple) connects all surfaces to AI Blue without competing.
4. **OKLCh primary** — Perceptually uniform lightness enables clean depth scales and natural color mixing.
5. **Additive on shadcn** — Glass effects layer on top of shadcn/ui, never replacing base accessibility.
6. **Motion with purpose** — Every animation communicates state (glow = active, lift = interactive, reveal = entering). Reduced motion is always respected.
7. **Token-prefixed** — All custom properties use `--ag-` prefix to avoid collisions with shadcn (`--`) and Tailwind (`--tw-`).

## Glass Effect System

Every glass component is built from 4 composable layers:

| Layer | Technique | Purpose |
|-------|-----------|---------|
| 1. Backdrop blur | `backdrop-filter: blur() saturate()` | Frosted glass foundation |
| 2. Highlight | `::before` with top-edge gradient | Light reflection / depth cue |
| 3. Shadow | Multi-level `box-shadow` | Elevation / grounding |
| 4. Adaptive tint | `color-mix(in oklab)` | Contextual color pickup |

Three intensity presets: `glass-subtle` (40% / 8px), `glass` (60% / 16px), `glass-heavy` (80% / 24px).

See `references/glass-components.md` for full component patterns.

## Color System

Brand colors in OKLCh with hex fallbacks:

| Token | Color | Usage |
|-------|-------|-------|
| `--ag-ai-blue` | `oklch(0.55 0.25 260)` / `#0066FF` | Primary, interactive, links |
| `--ag-web3-green` | `oklch(0.72 0.19 155)` / `#00CC66` | Accent, success, web3 |

5-step surface scale at hue 275°, 4-level text hierarchy, semantic colors, 3-level border scale.

Full palette: `references/color-system.md`

## Tailwind Integration

All tokens wired via `@theme inline`:

```html
<!-- Brand colors as utilities -->
<div class="bg-ai-blue text-white">Primary</div>
<span class="text-web3-green">Accent</span>

<!-- Glass utilities -->
<div class="glass p-6">Standard glass</div>
<nav class="glass-heavy sticky top-0">Heavy glass nav</nav>

<!-- Glow effects -->
<div class="glass-card glow-blue">Glowing card</div>
```

shadcn/ui components work unchanged — `bg-primary`, `bg-card`, `text-muted-foreground`, etc. all resolve to Arcan Glass tokens.

Full mapping: `references/tailwind-integration.md`

## Component Index

| Component | Class | Glass Level | Notes |
|-----------|-------|-------------|-------|
| Card | `.glass-card` | Medium | Highlight + hover lift |
| Nav | `.glass-nav` | Heavy | Sticky, bottom border |
| Button | `.glass-button` | Medium | + `.glass-button-primary`, `.glass-button-accent` |
| Input | `.glass-input` | Subtle | Focus ring with blue glow |
| Modal | `.glass-modal` | Heavy | + `.glass-modal-overlay`, reveal animation |
| Sidebar | `.glass-sidebar` | Heavy | Full height, right border |
| Badge | `.glass-badge` | Subtle | + `.glass-badge-blue`, `.glass-badge-green` |

Full patterns with raw CSS + Tailwind composition: `references/glass-components.md`

## Animation Index

| Animation | Tailwind | Duration | Usage |
|-----------|----------|----------|-------|
| Glow pulse | `animate-glow-pulse` | 2s loop | Active/loading states |
| Glass reveal | `animate-glass-reveal` | 0.5s once | Entry animations |
| Gradient flow | `animate-gradient-flow` | 8s loop | Hero backgrounds |

Plus hover lift, morph, focus ring, scroll reveal patterns.

Full patterns: `references/animation-patterns.md`

## shadcn/ui Compatibility

Arcan Glass defines all required shadcn/ui CSS variables. To add glass variants to shadcn components, extend with cva:

```tsx
// In your button.tsx variants
glass: "glass glass-highlight hover:-translate-y-px hover:shadow-lg",
"glass-primary": "glass-button glass-button-primary",
```

See `references/tailwind-integration.md` for full cva examples.

## Dark/Light Mode

Uses `next-themes` with class strategy (`.dark` / `.light`). All tokens auto-adapt via CSS custom properties — explicit `dark:` prefixes are rarely needed. Light mode should be authored as Day Glass: tinted surfaces around OKLCh `L=0.91-0.985`, primary text near `L=0.19`, and darker low-chroma borders with alpha instead of pale gray outlines.

```tsx
<ThemeProvider attribute="class" defaultTheme="dark">
  {children}
</ThemeProvider>
```

## Performance Notes

- **Limit `backdrop-filter`** to 3-5 elements per viewport — each creates a compositing layer
- **Use `glass-subtle`** for repeated items (list items, table rows)
- **Reserve `glass-heavy`** for landmark surfaces (nav, sidebar, modal)
- **Test on lower-end devices** — `backdrop-filter` perf varies by GPU
- **P3 gamut enhancement** is automatic via `@media (color-gamut: p3)` — wider chroma on capable displays
- **Reduced motion** is handled globally — all transforms and animations respect `prefers-reduced-motion`

## Resources

### references/
- `color-system.md` — Full OKLCh palette, hex fallbacks, surface scale, text hierarchy
- `design-tokens.md` — Shadows, blur, radius, spacing, typography, transitions
- `glass-components.md` — 4-layer glass system, component CSS patterns + Tailwind composition
- `animation-patterns.md` — Glow pulse, hover lift, morph, scroll reveal, gradient flow
- `tailwind-integration.md` — @theme inline wiring, @utility blocks, shadcn mapping, cva extensions

### assets/
- `globals.css` — Drop-in CSS file with all tokens, glass utilities, components, and animations

---
> Source: [broomva/arcan-glass](https://github.com/broomva/arcan-glass) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。