diff --git a/docs/accessibility-guidelines.md b/docs/accessibility-guidelines.md
new file mode 100644
index 0000000..8619c25
--- /dev/null
+++ b/docs/accessibility-guidelines.md
@@ -0,0 +1,164 @@
+# AccessGuide.io - Accessibility Guidelines Reference
+
+*Compiled from [Access Guide](https://www.accessguide.io/) - a friendly introduction to digital accessibility based on WCAG 2.1*
+
+---
+
+## 1. Hover and Focus Best Practices
+
+> WCAG criterion [1.4.13 Content on Hover or Focus](https://www.w3.org/WAI/WCAG21/Understanding/content-on-hover-or-focus.html) (Level AA)
+
+### Why This is Important
+
+If content appears and disappears on hover or focus, this can feel frustrating, unpredictable, and disruptive. Use best practices to make hover and focus more predictable and less likely to cause errors.
+
+This is especially accessible for:
+- People with **physical disabilities** (unpredictable or specific movement)
+- People with **visual disabilities** (screen reader users)
+- People with **cognitive disabilities**
+
+### Implementation Guidelines
+
+#### Dismissible
+There should be a way to dismiss new content **without moving hover or changing focus**. This prevents disrupting users in the middle of tasks.
+
+**Best practice:** Use the "Escape" key to dismiss content.
+
+#### Hoverable
+New content should **remain visible if the user hovers over it**.
+
+Sometimes content appears when hovering the trigger element but disappears when hovering over the new content. This is frustrating. The content must remain visible whether hover is on the trigger OR the content itself.
+
+#### Persistent
+Content must remain visible until:
+- The user dismisses it
+- The user moves the mouse off of it or the trigger
+- The content no longer contains important information
+
+---
+
+## 2. Keyboard Accessibility
+
+> WCAG criterion [2.1.1 Keyboard](https://www.w3.org/WAI/WCAG21/Understanding/keyboard.html) (Level A)
+
+### Why This is Important
+
+Full keyboard functionality is essential for:
+- People who rely on keyboards
+- Blind/visually impaired people using screen readers
+- People with motor disabilities who can't use a mouse
+
+**All functionality available to mouse users should be available to keyboard users.**
+
+### Basic Keyboard Access
+
+Keyboard accessibility is enabled by default in browsers. **Don't remove or deactivate these defaults** - enhance them instead.
+
+Keyboard accessibility includes:
+- ✅ Visible focus indicator
+- ✅ Intuitive focus order
+- ✅ Skip links to bypass repeating content
+- ✅ Way to turn off character key shortcuts
+- ✅ No keyboard traps
+
+**Common keyboard-accessible interactions:**
+- Browsing navigation
+- Filling out forms
+- Accessing buttons and links
+
+### Advanced Keyboard Access
+
+For complex interactions (drawing programs, drag-and-drop):
+- Translate gestures into keyboard commands
+- Use **Tab, Enter, Space, and Arrow keys** (most common)
+
+**Examples from Salesforce:**
+- Interact with a canvas (move/resize objects)
+- Move between lists
+- Sort lists
+
+---
+
+## 3. Focus Indicator Visibility
+
+> WCAG criterion [2.4.7 Focus Visible](https://www.w3.org/WAI/WCAG21/Understanding/focus-visible.html) (Level AA)
+
+### Why This is Important
+
+A visible focus indicator shows keyboard users what element they're currently interacting with.
+
+Benefits:
+- Shows what element is ready for user input
+- Helps people with executive dysfunction
+- Reduces cognitive load by focusing attention
+
+### Implementation Guidelines
+
+#### Never Remove Default Focus Indicator
+```css
+/* ❌ NEVER DO THIS unless replacing with custom styling */
+outline: none;
+```
+
+#### Design Accessible Hover and Focus States
+
+**All interactive elements need hover AND focus states:**
+- Buttons, links
+- Text fields
+- Navigation elements
+- Radio buttons, checkboxes
+
+**Difference between hover and focus:**
+| State | Purpose |
+|-------|---------|
+| Hover | "You could interact with this" |
+| Focus | "You ARE interacting with this right now" |
+
+**Other important states:**
+- Error state
+- Loading state
+- Inactive/disabled state
+
+#### Focus Indicator Contrast
+
+The focus indicator must be visible against **both**:
+- The element itself
+- The background behind it
+
+**WCAG requirement:** 3:1 contrast ratio for UI components
+
+---
+
+## 4. Key Principles Summary
+
+### For TuxMate Application
+
+| Principle | Application |
+|-----------|-------------|
+| **Dismissible** | Tooltips close with Escape key |
+| **Hoverable** | Tooltips stay visible when hovering content |
+| **Persistent** | Content stays until user dismisses |
+| **Keyboard** | All features work with Tab/Arrow/Enter/Space |
+| **Focus Visible** | Clear visual indicator on focused elements |
+| **Contrast** | 3:1 minimum for UI components |
+
+### Recommended Key Bindings
+
+| Key | Common Action |
+|-----|---------------|
+| `Tab` | Move to next focusable element |
+| `Shift+Tab` | Move to previous element |
+| `Enter/Space` | Activate/select |
+| `Arrow keys` | Navigate within components |
+| `Escape` | Dismiss/close |
+| `?` | Show help |
+
+---
+
+## Further Reading
+
+- [WCAG 2.1 Guidelines](https://www.w3.org/WAI/WCAG21/quickref/)
+- [MDN Web Docs - Keyboard](https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG/Keyboard)
+- [18F - Keyboard Access](https://accessibility.18f.gov/keyboard/)
+- [Style hover, focus, and active states differently](https://zellwk.com/blog/style-hover-focus-active-states/)
+- [Accessible Custom Focus Indicators](https://uxdesign.cc/accessible-custom-focus-indicators-da4768d1fb7b)
diff --git a/src/app/globals.css b/src/app/globals.css
index c105294..8dc10d4 100644
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -3,17 +3,17 @@
/* ===== WARM PAPER AESTHETIC THEMES ===== */
:root {
- /* Dark theme - warm charcoal with paper undertones */
- --bg-primary: #1e1d1a;
- --bg-secondary: #262520;
- --bg-tertiary: #302f29;
- --bg-hover: #3a3832;
- --bg-focus: #454339;
+ /* Dark theme - lighter warm charcoal per user request */
+ --bg-primary: #262522;
+ --bg-secondary: #2f2e2a;
+ --bg-tertiary: #3a3934;
+ --bg-hover: #45433d;
+ --bg-focus: #504e46;
--text-primary: #f5f3ef;
--text-secondary: #d8d4cc;
--text-muted: #a09a8e;
- --border-primary: #3a3832;
- --border-secondary: #454339;
+ --border-primary: #45433d;
+ --border-secondary: #504e46;
--accent: #9a958a;
}
@@ -35,20 +35,31 @@
@theme inline {
--color-background: var(--bg-primary);
--color-foreground: var(--text-primary);
- --font-sans: var(--font-geist-sans);
- --font-mono: var(--font-geist-mono);
+ --font-sans: var(--font-sans);
+ --font-heading: var(--font-heading);
+ --font-mono: var(--font-mono);
}
body {
background: var(--bg-primary);
color: var(--text-primary);
- font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+ font-family: var(--font-sans), system-ui, -apple-system, sans-serif;
font-weight: 450;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
transition: background 0.3s ease, color 0.3s ease;
}
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+.category-header {
+ font-family: var(--font-heading), system-ui, -apple-system, sans-serif;
+}
+
body::before {
content: "";
position: fixed;
@@ -83,6 +94,7 @@ body::before {
html {
scroll-behavior: smooth;
+ font-family: var(--font-sans);
}
::selection {
diff --git a/src/app/layout.tsx b/src/app/layout.tsx
index 85cc9de..4ff1803 100644
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -1,27 +1,24 @@
import type { Metadata } from "next";
-import { Geist, Geist_Mono, JetBrains_Mono, Open_Sans } from "next/font/google";
+import { Outfit, Inter, JetBrains_Mono } from "next/font/google";
import "./globals.css";
import { ThemeProvider } from "@/hooks/useTheme";
-const geistSans = Geist({
- variable: "--font-geist-sans",
+const outfit = Outfit({
+ variable: "--font-heading",
subsets: ["latin"],
+ display: "swap",
});
-const geistMono = Geist_Mono({
- variable: "--font-geist-mono",
+const inter = Inter({
+ variable: "--font-sans",
subsets: ["latin"],
+ display: "swap",
});
const jetbrainsMono = JetBrains_Mono({
- variable: "--font-jetbrains-mono",
+ variable: "--font-mono",
subsets: ["latin"],
-});
-
-const openSans = Open_Sans({
- variable: "--font-open-sans",
- subsets: ["latin"],
- weight: ["400", "500", "600", "700"],
+ display: "swap",
});
export const metadata: Metadata = {
@@ -100,7 +97,7 @@ export default function RootLayout({
)}
{children}
diff --git a/src/app/page.tsx b/src/app/page.tsx
index cf630d8..d36a26a 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -19,10 +19,7 @@ import { CategorySection } from '@/components/app';
import { CommandFooter } from '@/components/command';
import { Tooltip, GlobalStyles, LoadingSkeleton } from '@/components/common';
-// The main event
-
export default function Home() {
- // All the state we need to make this thing work
const { tooltip, show: showTooltip, hide: hideTooltip, tooltipMouseEnter, tooltipMouseLeave, setTooltipRef } = useTooltip();
@@ -122,7 +119,7 @@ export default function Home() {
}, []);
- // Build nav items for keyboard navigation (vim keys ftw)
+ // Build nav items for keyboard navigation
const navItems = useMemo(() => {
const items: NavItem[][] = [];
columns.forEach((colCategories) => {
diff --git a/src/components/app/AppItem.tsx b/src/components/app/AppItem.tsx
index 5a78784..4be8e00 100644
--- a/src/components/app/AppItem.tsx
+++ b/src/components/app/AppItem.tsx
@@ -9,6 +9,25 @@ import { AppIcon } from './AppIcon';
// Each app row in the list. Memoized because there are a LOT of these.
+// Basic Tailwind-ish color palette for mapping
+const COLOR_MAP: Record = {
+ 'orange': '#f97316',
+ 'blue': '#3b82f6',
+ 'emerald': '#10b981',
+ 'sky': '#0ea5e9',
+ 'yellow': '#eab308',
+ 'slate': '#64748b',
+ 'zinc': '#71717a',
+ 'rose': '#f43f5e',
+ 'purple': '#a855f7',
+ 'red': '#ef4444',
+ 'indigo': '#6366f1',
+ 'cyan': '#06b6d4',
+ 'green': '#22c55e',
+ 'teal': '#14b8a6',
+ 'gray': '#6b7280',
+};
+
interface AppItemProps {
app: AppData;
isSelected: boolean;
@@ -19,6 +38,7 @@ interface AppItemProps {
onTooltipEnter: (t: string, e: React.MouseEvent) => void;
onTooltipLeave: () => void;
onFocus?: () => void;
+ color?: string;
}
export const AppItem = memo(function AppItem({
@@ -31,6 +51,7 @@ export const AppItem = memo(function AppItem({
onTooltipEnter,
onTooltipLeave,
onFocus,
+ color = 'gray',
}: AppItemProps) {
// Why isn't this app available? Tell the user.
const getUnavailableText = () => {
@@ -41,6 +62,11 @@ export const AppItem = memo(function AppItem({
// Special styling for AUR packages (Arch users love their badges)
const isAur = selectedDistro === 'arch' && app.targets?.arch && isAurPackage(app.targets.arch);
+ // Determine effective color (AUR overrides category color for the checkbox/badge, but maybe not the row border)
+ // Actually, let's keep the row border as the category color for consistency
+ const hexColor = COLOR_MAP[color] || COLOR_MAP['gray'];
+ const checkboxColor = isAur ? '#1793d1' : hexColor;
+
return (