OpenParable
Skip to content
← Back to skills

Website Design System

Design
website-design-system

Website Design System is an Agent Skill for design published in the macalbert/envilder repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns. Use when creating or editing Astro components, adding CSS, or styling website pages. Ensures visual consistency across retro and light themes.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/macalbert/envilder/blob/HEAD/.github/skills/website-design-system/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/website-design-system, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Website Design System

Rules and patterns for the Envilder website's pure CSS design system.

When to Use

  • Creating new Astro components or page sections
  • Adding or modifying CSS (global or scoped)
  • Choosing between existing utility classes
  • Defining new CSS variables
  • Reviewing PRs that touch website styling

Themes

The site uses data-theme attribute on <html>. Two themes are supported:

ThemeSelectorPalette
Retro (default):rootGame Boy green
Light[data-theme="light"]Warm neutrals

Rules

  • All colors MUST use CSS variables: never hardcode hex values
  • New variables MUST be defined in both :root (retro) and [data-theme="light"] blocks in global.css
  • Never modify the theme switcher mechanism or its localStorage key
/* ✓ Correct */
color: var(--color-text);
background: var(--color-bg);

/* ✗ NEVER */
color: #8bac0f;
background: #1a1a2e;

Responsive Breakpoints

Mobile-first approach. Default styles target mobile; expand with min-width.

BreakpointTargetPattern
DefaultMobileSingle column, compact spacing
min-width: 640pxTablet2-column grids, expanded spacing
min-width: 1024pxDesktop3-4 column grids, full layout

Grid Utilities

Use existing grid classes: .grid-2, .grid-3, .grid-4.

Spacing & Layout

Use the spacing scale defined in global.css:

  • Variables: --space-xs through --space-4xl
  • Container max-width: --max-width (1200px)

Typography

UseFontAccess
Section titles / pixel stylePress Start 2PVia .pixel-card h3 or custom class
Body textInterDefault (inherited)
Code / terminalJetBrains Mono<code>, <pre>, or mono class
  • Use clamp() for fluid typography
  • Never use fixed px font sizes

Component Patterns

Reuse existing CSS classes for visual consistency:

ClassPurpose
.pixel-cardBordered cards with pixel corner notches
.pixel-iconEmoji with pixelated filter
.pixel-shadow4px offset retro shadow
.badgeSmall label badges
.pixel-dividerSection separator
.scanlinesCRT overlay effect (use sparingly)
.sectionStandard section wrapper with vertical padding

File Locations

WhatWhere
Global CSSsrc/website/src/styles/global.css
Componentssrc/website/src/components/*.astro
Layoutsrc/website/src/layouts/BaseLayout.astro

Constraints

  • DO NOT install CSS frameworks or UI libraries: use existing pure CSS
  • DO NOT hardcode colors: always CSS variables from global.css
  • DO NOT use fixed pixel font sizes: use clamp() or relative units
  • DO NOT break existing responsive layouts when adding new sections
  • DO NOT add JavaScript frameworks (React, Vue): Astro components + <script> tags only
  • ONLY add new CSS variables if defined in both theme blocks