rspress-custom-theme

Customize Rspress v2 themes with CSS variables, layout slots, and component replacement.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/ruxelion/rs-grid --skill rspress-custom-theme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rspress-custom-theme
Source: https://github.com/ruxelion/rs-grid/tree/main/.agents/skills/rspress-custom-theme
Command: npx skills add https://github.com/ruxelion/rs-grid --skill rspress-custom-theme

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @rspress/core, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables the customization of Rspress themes by adjusting styles, adding content, or replacing components. It addresses the need for users to tailor their site's appearance to their brand and content requirements.

Core Features & Use Cases

  • CSS Variables: Override theme styles with custom CSS variables for colors, fonts, and spacing.
  • Layout Slots: Inject content at specific positions without modifying the layout components.
  • Component Wrapping/Ejection: Replace existing theme components with custom versions.
  • Use Case: A user who needs to change the branding, layout, or navigation of their Rspress-powered website to better reflect their company identity or design standards.

Quick Start

Customize the Rspress theme for your site by adjusting the CSS variables or using layout slots. For example, set the brand colors using the theme/index.css file and add custom content around existing components using the layout slots.

Frequently Asked Questions about rspress-custom-theme

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the Rspress theme for my site?

Customize the Rspress theme by overriding CSS variables for colors and spacing, injecting content via layout slots, or replacing components entirely. This adapts the site design to specific branding requirements.

Can I replace built-in Rspress components with my own?

Yes, replace built-in Rspress components using component wrapping and ejection. This allows you to substitute existing theme components with custom versions to meet specific design standards.

How do you inject custom content into an Rspress layout without modifying components?

Inject custom content into an Rspress layout using layout slots. Layout slots allow you to insert content at specific positions around existing components without directly modifying the layout components.

Does Rspress theme customization require backend changes?

No, Rspress theme customization does not require backend changes. It handles frontend interface adjustments using CSS and component replacement, bypassing backend customization or theme configuration beyond the frontend.

What do I need to use CSS variables for Rspress theme customization?

Using CSS variables for Rspress theme customization requires Rspress v2 and a basic understanding of CSS. Override theme styles in the `theme/index.css` file to set brand colors, fonts, and spacing.

What are the limitations of customizing an Rspress site?

Limitations of customizing an Rspress site include the exclusion of backend customization and theme configuration beyond the frontend interface. It strictly focuses on adjusting styles, adding content, and replacing frontend components.