diff --git a/about/divider-showcase.page.tsx b/about/divider-showcase.page.tsx
new file mode 100644
index 0000000000..ef3620db31
--- /dev/null
+++ b/about/divider-showcase.page.tsx
@@ -0,0 +1,465 @@
+import * as React from "react";
+import { PageGrid, PageGridRow, PageGridCol } from "shared/components/PageGrid/page-grid";
+import { Divider } from "shared/components/Divider";
+
+export const frontmatter = {
+ seo: {
+ title: 'Divider Component Showcase',
+ description: "A comprehensive showcase of all Divider component variants, weights, colors, and orientations in the XRPL.org Design System.",
+ }
+};
+
+export default function DividerShowcase() {
+ return (
+
+
+
+
+
Component Showcase
+
Divider Component
+
+ A comprehensive showcase of all Divider component variants, weights, colors, and orientations.
+
+
+
+
+ {/* Weight by Color Matrix - Horizontal */}
+
+
+
+
Horizontal Dividers: Weight by Color Matrix
+
+ {/* Header Row */}
+
+
+
Weight
+
+
+
Gray
+
+
+
Base
+
+
+
Green
+
+
+
+ {/* Thin Row */}
+
+
+ Thin
+
+ 0.5px
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* Regular Row */}
+
+
+ Regular
+
+ 1px
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* Strong Row */}
+
+
+ Strong
+
+ 2px
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* Vertical Dividers */}
+
+
+
+
Vertical Dividers: Weight by Color Matrix
+
+ {/* Header Row */}
+
+
+
Weight
+
+
+
Gray
+
+
+
Base
+
+
+
Green
+
+
+
+ {/* Thin Row */}
+
+
+
+ Thin
+
+ 0.5px
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* Regular Row */}
+
+
+
+ Regular
+
+ 1px
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* Strong Row */}
+
+
+
+ Strong
+
+ 2px
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {/* Weights Comparison */}
+
+
+
+
Stroke Weights
+
Dividers are available in three stroke weights to represent different levels of visual hierarchy.
+
+
+
Thin (0.5px) - Subtle separation
+
+
+
+
Regular (1px) - Default weight
+
+
+
+
Strong (2px) - Emphasized boundaries
+
+
+
+
+
+
+
+ {/* Color Variants */}
+
+
+
+
Color Variants
+
Colors are mapped from the XRPL Design System color palette:
+
+
+ {/* Dark Mode Colors (Default) */}
+
+
Dark Mode (Default)
+
+
+
+
+ Gray:$gray-600
+
+ #454549
+
+
+
+
+
+ Base:$white
+
+ #FFFFFF
+
+
+
+
+
+ Green:$green-300
+
+ #21E46B
+
+
+
+
+
+ {/* Light Mode Colors */}
+
+
Light Mode
+
+
+
+
+ Gray:$gray-300
+
+ #C1C1C2
+
+
+
+
+
+ Base:$gray-900
+
+ #111112
+
+
+
+
+
+ Green:$green-300
+
+ #21E46B
+
+
+
+
+
+
+
+
+
Gray - Neutral separation (default)
+
+
+
+
Base - High contrast separation (adapts to theme)
+
+
+
+
Green - Brand accent separation
+
+
+
+
+
+
+
+ {/* Real-World Examples */}
+
+
+
+
Real-World Examples
+
+
+ {/* Content Section Separation */}
+
+
Content Section Separation
+
+
Section Title
+
This is some content in the first section that explains something important.
+
+
This is content in the second section that follows naturally from the first.
+
+
+
+ {/* List Item Separation */}
+
+
List Item Separation
+
+
+
+ Feature One
+
Description of the first feature
+
+
+
+ Feature Two
+
Description of the second feature
+
+
+
+ Feature Three
+
Description of the third feature
+
+
+
+
+
+ {/* Vertical Divider Between Columns */}
+
+
Vertical Divider Between Columns
+
+
+
+ Column One
+
Content for the first column
+
+
+
+ Column Two
+
Content for the second column
+
+
+
+ Column Three
+
Content for the third column
+
+
+
+
+
+ {/* Major Section Break */}
+
+
Major Section Break (Strong + Green)
+
+
Primary Section
+
This section contains the main content of the page.
+
+
Secondary Section
+
This section is clearly separated with a strong branded divider.
+
+
+
+ {/* Navigation Separator */}
+
+
Navigation Item Separator
+
+
+ Home
+
+ Documentation
+
+ API Reference
+
+ Community
+
+
+
+
+
+
+
+
+ {/* API Reference */}
+
+
+
+
Component API
+
+ {/* Header Row */}
+
+
Prop
+
Type
+
Default
+
Description
+
+
+ {/* orientation */}
+
+
orientation
+
'horizontal' | 'vertical'
+
'horizontal'
+
Sets the divider orientation
+
+
+
+ {/* weight */}
+
+
weight
+
'thin' | 'regular' | 'strong'
+
'regular'
+
Controls the stroke thickness
+
+
+
+ {/* color */}
+
+
color
+
'gray' | 'base' | 'green'
+
'gray'
+
Sets the divider color
+
+
+
+ {/* className */}
+
+
className
+
string
+
''
+
Additional CSS classes
+
+
+
+ {/* decorative */}
+
+
decorative
+
boolean
+
true
+
Whether the divider is purely decorative (hides from screen readers)
+
+
+
+
+
+
+
+ );
+}
diff --git a/shared/components/Divider/Divider.md b/shared/components/Divider/Divider.md
new file mode 100644
index 0000000000..af0fb7a430
--- /dev/null
+++ b/shared/components/Divider/Divider.md
@@ -0,0 +1,350 @@
+# Divider Component Documentation
+
+## Overview
+
+The Divider component is a visual separator that creates clear boundaries between content sections, elements, or groups. Following the XRPL Brand Design System (BDS), it supports two orientations, three stroke weights, and three color variants to adapt to different visual contexts and hierarchy needs.
+
+## Features
+
+- **Two Orientations**: Horizontal (default) and Vertical
+- **Three Stroke Weights**: Thin (0.5px), Regular (1px), Strong (2px)
+- **Three Color Variants**: Gray (default), Base (adapts to theme), Green
+- **Theme Support**: Automatic light/dark mode adaptation
+- **Accessibility**: Configurable for decorative or semantic use
+- **Flexible Sizing**: Inherits width/height from parent container
+
+## Props API
+
+```typescript
+interface DividerProps {
+ /** Divider orientation - horizontal separates vertical content, vertical separates horizontal content */
+ orientation?: 'horizontal' | 'vertical';
+ /** Stroke weight - controls visual thickness */
+ weight?: 'thin' | 'regular' | 'strong';
+ /** Color variant - gray (default), base for high contrast (adapts to theme), green for brand emphasis */
+ color?: 'gray' | 'base' | 'green';
+ /** Additional CSS classes */
+ className?: string;
+ /** Whether the divider is purely decorative (hides from screen readers) */
+ decorative?: boolean;
+}
+```
+
+### Default Values
+
+- `orientation`: `'horizontal'`
+- `weight`: `'regular'`
+- `color`: `'gray'`
+- `className`: `''`
+- `decorative`: `true`
+
+## Orientations
+
+### Horizontal Divider
+
+Horizontal dividers extend left to right to separate vertically stacked content. They span the full width of their container by default.
+
+**Common Uses:**
+- Between content blocks or sections
+- Separating list items
+- Within cards to divide content areas
+
+**Usage:**
+```tsx
+
+// or simply (horizontal is default)
+
+```
+
+### Vertical Divider
+
+Vertical dividers extend top to bottom to separate horizontally aligned content. They inherit height from their parent container.
+
+**Common Uses:**
+- Between columns in a layout
+- Separating navigation items
+- Within toolbars or action bars
+
+**Usage:**
+```tsx
+
+```
+
+**Note:** Vertical dividers require a parent container with a defined height.
+
+## Stroke Weights
+
+### Thin (0.5px)
+
+The lightest weight for subtle, unobtrusive separation. Use when content is closely related but needs minimal visual distinction.
+
+**Best For:**
+- Within cards or small content areas
+- Between tightly grouped elements
+- Dense layouts where heavier dividers would feel cluttered
+
+**Usage:**
+```tsx
+
+```
+
+### Regular (1px) - Default
+
+The standard weight for most use cases. Provides clear separation without dominating the visual hierarchy.
+
+**Best For:**
+- Most layout and section separations
+- Between content blocks
+- General-purpose dividers
+
+**Usage:**
+```tsx
+
+// or simply (regular is default)
+
+```
+
+### Strong (2px)
+
+The heaviest weight for maximum emphasis. Use sparingly to highlight major transitions or boundaries.
+
+**Best For:**
+- Major section breaks
+- Key boundaries between distinct content areas
+- Emphasizing important transitions
+
+**Usage:**
+```tsx
+
+```
+
+## Color Variants
+
+### Gray (Default)
+
+Neutral, subtle separation that works in most contexts without drawing attention.
+
+**Best For:**
+- Most separations
+- Subtle visual breaks
+- Backgrounds where you don't want the divider to stand out
+
+**Usage:**
+```tsx
+
+// or simply (gray is default)
+
+```
+
+### Base
+
+High-contrast separation that adapts to the theme - renders as white in dark mode and black in light mode.
+
+**Best For:**
+- When maximum contrast is needed
+- Important structural boundaries
+- Universal high-visibility dividers
+
+**Usage:**
+```tsx
+
+```
+
+### Green
+
+Brand-colored separation that reinforces XRPL identity or indicates active/important areas.
+
+**Best For:**
+- Highlighting branded sections
+- Active or selected states
+- Drawing attention to specific content areas
+
+**Usage:**
+```tsx
+
+```
+
+## When to Use
+
+Use a Divider to:
+
+- **Separate content sections** - Create clear boundaries between distinct content groups
+- **Organize lists** - Divide list items for better scanability
+- **Structure cards** - Separate header, body, and footer areas within cards
+- **Define columns** - Visually separate side-by-side content
+- **Indicate transitions** - Mark boundaries between zones of information
+
+## When NOT to Use
+
+Avoid using a Divider when:
+
+- **Spacing alone is sufficient** - If whitespace provides enough separation, skip the divider
+- **Backgrounds provide contrast** - Different background colors may eliminate the need for dividers
+- **It adds clutter** - In minimal designs, too many dividers can distract from content
+- **To compensate for poor spacing** - Dividers should enhance, not replace, proper layout structure
+
+## Usage Examples
+
+### Basic Usage
+
+```tsx
+import { Divider } from 'shared/components/Divider';
+
+// Default horizontal divider
+
+
+// Vertical divider
+
+
+// Strong green divider for emphasis
+
+```
+
+### List Separation
+
+```tsx
+