TheRoyalOrphan

A theme for the refined developer. TheRoyalOrphan is a multi-platform theme inspired by the intersection of mortality and majesty. With tones of bronze and gold from regal chambers and an emphasis on elegance and contrast, it caters to those who appreciate sophisticated aesthetics in their development environment.

Palette · Ports · Contributing

---

Palette

TheRoyalOrphan is built on three foundational pillars: BONES (structural neutrals), ROYAL (premium metallics), and DIVINE (vital hues).

BONES — Structural Neutrals

Color	Hex	RGB	HSL	Description
🖤 Charcoal	#2B2B2B	43, 43, 43	0°, 0%, 17%	Primary dark background
🖤 Charcoal Bright	#3A3A3A	58, 58, 58	0°, 0%, 23%	Elevated surfaces
🖤 Charcoal Dim	#1C1C1C	28, 28, 28	0°, 0%, 11%	Deepest backgrounds
⚫ Slate	#708090	112, 128, 144	210°, 13%, 50%	Muted text, comments
⚫ Slate Bright	#8FA0B0	143, 160, 176	210°, 18%, 63%	Brighter comments
⚫ Slate Dim	#516070	81, 96, 112	211°, 16%, 38%	Dimmer borders
⚪ Ash	#C0C0C0	192, 192, 192	0°, 0%, 75%	Secondary text
⚪ Ash Bright	#D3D3D3	211, 211, 211	0°, 0%, 83%	Light borders
⚪ Ash Dim	#A9A9A9	169, 169, 169	0°, 0%, 66%	Disabled states
⚪ Ivory	#FFFFF0	255, 255, 240	60°, 100%, 97%	Primary light text
⚪ Ivory Bright	#FFFFFF	255, 255, 255	0°, 0%, 100%	Pure white
⚪ Ivory Dim	#F5F5DC	245, 245, 220	60°, 56%, 91%	Light backgrounds

ROYAL — Premium Metallics

Color	Hex	RGB	HSL	Description
🟤 Bronze	#B8956A	184, 149, 106	33°, 35%, 57%	Primary brand, keywords
🟤 Bronze Bright	#CCA77A	204, 167, 122	33°, 45%, 64%	Hover states, emphasis
🟤 Bronze Dim	#9A7D55	154, 125, 85	35°, 29%, 47%	Muted accents
🟡 Gold	#D4AF37	212, 175, 55	46°, 65%, 52%	Functions, highlights
🟡 Gold Bright	#E4BF47	228, 191, 71	46°, 75%, 59%	Active states, warnings
🟡 Gold Dim	#B89527	184, 149, 39	45°, 65%, 44%	Subtle highlights
⚪ Silver	#C0C0C0	192, 192, 192	0°, 0%, 75%	UI elements
⚪ Silver Bright	#D8D8D8	216, 216, 216	0°, 0%, 85%	Light UI elements
⚪ Silver Dim	#A8A8A8	168, 168, 168	0°, 0%, 66%	Muted UI

DIVINE — Vital Hues

Color	Hex	RGB	HSL	Description
🔴 Cardinal	#C41E3A	196, 30, 58	350°, 73%, 44%	Errors, critical alerts
🔴 Cardinal Bright	#D4384A	212, 56, 74	350°, 64%, 53%	Error emphasis
🔴 Cardinal Dim	#A41830	164, 24, 48	350°, 74%, 37%	Deep errors
❤️ Crimson Red	#DC143C	220, 20, 60	348°, 83%, 47%	Urgent, bold accents (New in v2.0)
❤️ Crimson Bright	#EC244C	236, 36, 76	348°, 85%, 53%	Urgent emphasis
❤️ Crimson Dim	#C4042C	196, 4, 44	348°, 96%, 39%	Deep urgent
🟢 Emerald	#50C878	80, 200, 120	140°, 52%, 55%	Success, strings
🟢 Emerald Bright	#60D888	96, 216, 136	140°, 60%, 61%	Success emphasis
🟢 Emerald Dim	#40B868	64, 184, 104	140°, 48%, 49%	Muted success
🔵 Sapphire	#0F52BA	15, 82, 186	217°, 85%, 39%	Info, links
🔵 Sapphire Bright	#1F62CA	31, 98, 202	217°, 73%, 46%	Info emphasis
🔵 Sapphire Dim	#0042AA	0, 66, 170	217°, 100%, 33%	Deep info

---

Ports

TheRoyalOrphan is available for a growing ecosystem of development tools, terminals, and applications.

Editors & IDEs

Neovim — Modern modal editor with Lua configuration

• Full TreeSitter syntax highlighting
• LSP semantic token support
• Three-tier architecture (palette → spec → groups)
• 📁 Port | 📖 Documentation

Zed — High-performance, multiplayer code editor

• Dark and light variants
• Multi-player cursor colors
• Full syntax support
• 📁 Port | 📖 Documentation

Note-Taking & Knowledge Management

Obsidian — Powerful local-first knowledge base

• Custom callouts (royal, divine, bones)
• Gradient headers
• Enhanced graph view
• Premium typography
• 📁 Port | 📖 Documentation

Shell & Desktop Environments

Quickshell — QML-based Wayland compositor toolkit

• Complete QML theme object
• Semantic color system
• Responsive utilities
• 📁 Port | 📖 Documentation

Noctalia — Beautiful Wayland desktop shell

• Matugen integration
• Material Design 3 colors
• Panel and widget theming
• 📁 Port | 📖 Documentation

Matugen — Material You color generator

• Dynamic color generation from images
• Custom TheRoyalOrphan palette
• CSS, SCSS, terminal templates
• 📁 Port | 📖 Documentation

Web Development

CSS — Pure CSS custom properties

• Modern CSS variables
• Utility classes
• Dark/light mode support
• 📁 Port | 📖 Documentation

SCSS — Sass variables, mixins, and functions

• Powerful mixins for gradients, buttons, cards
• Color and spacing functions
• Responsive utilities
• 📁 Port | 📖 Documentation

Tailwind CSS v4 — With shadcn/ui compatibility

• OKLCH and HSL variants
• @theme inline directive
• Custom branded utilities
• 📁 Port | 📖 Documentation

---

Installation

Each port has its own installation instructions. Choose your platform and follow the README:

# Example: Neovim
cp -r nvim ~/.config/nvim/colors/theroyalorphan

# Example: Zed
cp zed/theroyalorphan.json ~/.config/zed/themes/

# Example: Obsidian
cp -r obsidian ~/.obsidian/themes/TheRoyalOrphan/

For detailed instructions, see the README in each port directory.

---

Quick Start

Colors as CSS Variables

:root {
  --bronze: #B8956A;
  --gold: #D4AF37;
  --crimson: #DC143C;
  --emerald: #50C878;
  --charcoal: #2B2B2B;
  --ivory: #FFFFF0;
}

Colors in Code

// JavaScript/TypeScript
const colors = {
  bronze: '#B8956A',
  gold: '#D4AF37',
  crimson: '#DC143C',
};

-- Lua (Neovim)
local colors = {
  bronze = "#B8956A",
  gold = "#D4AF37",
  crimson = "#DC143C",
}

// SCSS
$bronze: #B8956A;
$gold: #D4AF37;
$crimson: #DC143C;

---

AI Agent Integration

For AI agents and automated theme application, see llm.txt — a structured implementation guide with:

• Complete color palette in multiple formats (Hex, RGB, HSL, OKLCH)
• CSS custom properties setup
• Component styling patterns (buttons, alerts, cards)
• Usage rules and validation checklist
• Version history and changes

---

Contributing

Want to bring TheRoyalOrphan to a new platform?

1. Check existing ports — See if your platform is already supported
2. Follow the color guide — Use COLOR_GUIDE.md for accurate colors
3. Create the port — Implement the theme for your platform
4. Write documentation — Include a README with installation and usage
5. Submit — Open a pull request or issue

Port Template Structure

platform-name/
├── README.md          # Installation, usage, features
├── theme-file         # Main theme file (varies by platform)
└── examples/          # Optional: example configurations

Color Consistency

All ports should use the canonical color values from the Palette section above. Adjust only for platform-specific requirements (e.g., alpha channels, color space conversions).

---

Design Philosophy

TheRoyalOrphan embraces three core principles:

1. Elegance — Refined bronze and gold tones that evoke sophistication
2. Contrast — Carefully balanced light and dark values for readability
3. Consistency — Unified experience across all platforms and tools

The theme is designed for developers who appreciate aesthetics without sacrificing functionality.

---

Accessibility

All color combinations meet WCAG AA standards:

• Minimum 4.5:1 contrast ratio for normal text
• Minimum 3:1 contrast ratio for large text and UI components
• Color is never the sole means of conveying information

---

Version

v2.0 — Added Crimson Red (#DC143C) for urgent/high-energy UI elements

What's New in v2.0

• Crimson Red color for urgent CTAs and passionate moments
• Expanded platform support (Quickshell, Noctalia, Zed)
• Matugen integration for dynamic color generation
• Web theme variants (CSS, SCSS, Tailwind v4)

---

License

MIT License — Use freely in personal and commercial projects

---

Resources

• Color Guide — Complete color documentation
• llm.txt — AI agent implementation guide

---

TheRoyalOrphan — A theme for the refined developer.