OpenParable
Skip to content
← Back to skills

Retro CSS Architecture

Design
retro-css-architecture

Retro CSS Architecture is an Agent Skill for design published in the TheOrcDev/8bitcn-ui repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Organize 8-bit CSS with custom properties, pixel fonts, and responsive pixel art. Apply when creating or modifying retro-styled components and their CSS.

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/TheOrcDev/8bitcn-ui/blob/HEAD/.claude/skills/retro-css-architecture/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/retro-css-architecture, 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.

Retro CSS Architecture

Organize CSS for 8-bit components using custom properties, pixel fonts, and responsive patterns.

Required Import

All 8-bit components must import the retro stylesheet:

import "@/components/ui/8bit/styles/retro.css";

Pixel Font

Use "Press Start 2P" for authentic 8-bit typography:

.retro {
  font-family: "Press Start 2P", system-ui, -apple-system, sans-serif;
  line-height: 1.5;
  letter-spacing: 0.5px;
}

Apply via class or font variant:

<Button className="retro">START GAME</Button>

// or via font prop
<Button font="retro">START GAME</Button>

Pixelated Images

For sharp pixel art images:

.pixelated {
  image-rendering: pixelated;
  image-rendering: crisp-edges;
}
<Image src="/pixel-art.png" className="pixelated" />

Dark Mode Colors

Use semantic color names with dark mode variants:

<div className="border-foreground dark:border-ring" />
<div className="bg-foreground dark:bg-ring" />

Responsive Pixel Sizes

Use consistent pixel values for retro feel:

{/* Standard pixel sizes */}
<div className="size-1.5" />      {/* Corner pixels */}
<div className="h-1.5 w-3" />     {/* Shadow segments */}
<div className="border-y-6" />     {/* Card borders */}

{/* Mobile considerations */}
<div className="h-[5px] md:h-1.5" />

CSS Organization

Keep retro-specific styles in components/ui/8bit/styles/retro.css:

/* Import pixel font */
@import url("https://fonts.googleapis.com/css2?family=Press+Start+2P&display=swap");

/* Font class */
.retro {
  font-family: "Press Start 2P", system-ui, -apple-system, sans-serif;
  line-height: 1.5;
  letter-spacing: 0.5px;
}

/* Image handling */
.pixelated {
  image-rendering: pixelated;
  image-rendering: crisp-edges;
}

Component-Level CSS

Use Tailwind utilities for component-specific styling:

<div
  className={cn(
    "relative border-y-6 border-foreground dark:border-ring",
    "rounded-none active:translate-y-1 transition-transform",
    className
  )}
/>

Key Principles

  1. Import retro.css - Required for all 8-bit components
  2. Pixel font - Use "Press Start 2P" for authentic look
  3. Pixelated images - Apply image-rendering: pixelated to sprites
  4. Consistent sizing - Use fixed pixel values (1.5, 3, 6px)
  5. Dark mode - Use semantic colors with dark: prefix
  6. rounded-none - Remove all border radius for retro feel
  7. Tailwind first - Use utilities before custom CSS

Reference Files

  • components/ui/8bit/styles/retro.css - Global retro styles
  • components/ui/8bit/button.tsx - CSS class usage example