@rdna/radiants
v0.1.2
Published
Radiants theme package for DNA - retro pixel aesthetic
Maintainers
Readme
@rdna/radiants
Radiants theme package for DNA (Design Nexus Architecture) — a retro pixel aesthetic design system.
Installation
npm install @rdna/radiantsUsage
CSS Tokens
Import the theme tokens in your CSS:
/* Import all tokens + base styles */
@import '@rdna/radiants';
/* Import dark mode support */
@import '@rdna/radiants/dark';Or import individual parts:
@import '@rdna/radiants/tokens'; /* Tokens only */
@import '@rdna/radiants/typography'; /* Typography styles */
@import '@rdna/radiants/fonts'; /* Font declarations */
@import '@rdna/radiants/animations'; /* Animation utilities */
@import '@rdna/radiants/base'; /* Base element styles */React Components
import { Button, Card, Badge } from '@rdna/radiants/components/core';
import { useToast } from '@rdna/radiants/components/core';
function App() {
return (
<Card>
<Badge variant="success">New</Badge>
<Button variant="primary">Click me</Button>
</Card>
);
}Available Components
- Layout: Card, Divider
- Actions: Button, ContextMenu, DropdownMenu
- Forms: Input, TextArea, Select, Checkbox, Radio, Switch, Slider
- Feedback: Alert, Badge, Progress, Spinner, Toast, Tooltip
- Overlays: Dialog, Popover, Sheet, HelpPanel
- Navigation: Tabs, Breadcrumbs, Accordion
- Specialty: CountdownTimer, Web3ActionBar
Hooks
import { useMotion } from '@rdna/radiants/hooks';
const { duration, easing } = useMotion();Semantic Tokens
Use semantic token classes instead of hardcoded colors:
// ✅ Do this
<div className="bg-surface-primary text-content-primary border-edge-primary">
// ❌ Not this
<div className="bg-[#FEF8E2] text-[#0F0E0C]">Token Categories
| Category | Examples | Purpose |
|----------|----------|---------|
| surface-* | bg-surface-primary | Backgrounds |
| content-* | text-content-primary | Text/foreground |
| edge-* | border-edge-primary | Borders/outlines |
| action-* | bg-action-primary | Interactive elements |
| status-* | bg-status-success | Feedback states |
Dark Mode
Dark mode is automatic with prefers-color-scheme, or manually toggle with classes:
<!-- Force dark -->
<html class="dark">
<!-- Force light -->
<html class="light">Fonts
This package includes:
- Joystix Monospace — Heading font
- PixelCode — Monospace/code font
Mondwest (body font) must be downloaded separately due to licensing:
- Purchase/download from Pangram Pangram
- Place
Mondwest.woff2andMondwest-Bold.woff2in your project's fonts directory - The theme will fall back to system fonts if Mondwest is not available
Requirements
- React 18+ or 19
- Tailwind CSS 4
- Next.js 14+ (optional)
License
GPL-3.0 — See LICENSE for details.
Note: The DNA specification itself is MIT licensed. This theme implementation is GPL-3.0.
