ever-co/ever-works / .claude/skills/ever-works
ever-works
VerifiedRepo-specific guide to the Ever Works monorepo (ever-co/ever-works) — its pnpm + Turborepo layout, the per-workspace test runners (Jest vs Vitest vs Playwright), file-naming and import-alias conventions, the commit/branch model, and the real build/lint/type-check commands. Use this whenever working anywhere in this repository so changes match the codebase's actual conventions and pass CI.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.5 KB |
| references/ui-patterns.md | markdown | 2.1 KB |
references/ui-patterns.md
View on GitHub# Ever Works — UI & design patterns
Canonical design guidance across the Ever Works web surfaces — the platform (`ever-co/ever-works` → `apps/web`) and the open-source `directory-web-template` (and every customer site forked from it). These are the rules; per-repo CSS is just the local expression.
## Primary CTA — light vs dark mode
- **Light mode:** solid theme-primary fill (brand colour), white text.
- **Dark mode:** white background, near-black text (`dark:bg-white dark:text-gray-900`) — NOT the brand colour inverted.
```tsx
<button className="bg-primary text-white dark:bg-white dark:text-gray-900">
Get started
</button>
```
Why: the brand colour at full saturation on a near-black canvas reads as a coloured rectangle rather than a clear action target. White-on-dark gives the CTA the same visual weight as the light-mode pattern without competing with content. Applies to primary CTAs (template hero "Get started", category "Browse all", item "Visit"; the platform's onboarding CTAs). Secondary/icon/link buttons follow normal theme rules.
## Stats / KPI cards — monochrome
KPI tiles use ONE neutral icon-and-value colour (default text on card background). Do NOT colour the value/icon by "good vs bad" status (red/amber/green).
```tsx
// ✅ monochrome KPI
<KPICard label="Active users" value={1284} />
// ❌ don't colour the value by health
<KPICard label="Failed runs" value={42} className="text-red-600" />
// ✅ status colour belongs on the row badge of the underlying table
<StatusBadge state="failing" />
```
Why: a KPI grid with mixed red/amber/green reads as an alert dashboard, not a summary — each tile competes for attention. Reserve colour for row-level status in the table the KPI summarises; keep the KPI grid calm.
## Applying patterns in code
Prefer composing tokens (e.g. a `primaryCta` variant on a shared `Button`) over per-page inline classes — keeps each pattern auditable in one place per repo. Components live in `apps/web/src/components/` (platform) and `src/components/` (template). Design changes are additive by default — a new pattern must not silently drop existing surfaces.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |