DT Design System

Shared design tokens, web CSS, and React Native components for the Dangerous Things product family.

Packages

Package	Description
@dangerousthings/tokens	Canonical design tokens (colors, typography, shape) defined in TypeScript and exported as CSS custom properties
@dangerousthings/web	Web CSS themes — bevels, animations, forms, and component styles
@dangerousthings/react	React web components wrapping @dangerousthings/web CSS
@dangerousthings/react-native	React Native components built on React Native Paper
@dangerousthings/tailwind-preset	Tailwind CSS v3 preset mapping DT tokens to Tailwind theme
@dangerousthings/hex-background	3D hexagon grid background using Three.js + React Three Fiber (web and React Native)

Brand Themes

Two brand themes ship out of the box:

• DT — neon cyberpunk aesthetic with beveled corners and baked in animations (Tektur font)
• Classic — dark navy palette with magenta accents and standard border radius

Getting Started

Prerequisites

• Node.js >= 18
• npm >= 10

Install & Build

npm install
npm run build        # builds all packages via Turbo

Per-Package Builds

npm run build:tokens
npm run build:web
npm run build:react-native

Usage

Web (CSS)

@import "@dangerousthings/web";                     /* base index */
@import "@dangerousthings/web/tokens/dt.css";       /* DT brand tokens */
@import "@dangerousthings/web/components/bevels.css";

React (Web)

import "@dangerousthings/web";
import { DTWebThemeProvider, DTButton, DTCard } from "@dangerousthings/react";

export default function App() {
  return (
    <DTWebThemeProvider brand="dt" theme="dark">
      <DTCard title="PRODUCT" variant="emphasis" progress={60}>
        <DTButton variant="normal" onClick={handleClick}>
          Scan NFC
        </DTButton>
      </DTCard>
    </DTWebThemeProvider>
  );
}

React Native

import { DTThemeProvider } from "@dangerousthings/react-native";
import { DTButton, DTCard } from "@dangerousthings/react-native";

export default function App() {
  return (
    <DTThemeProvider brand="dt">
      <DTCard>
        <DTButton mode="contained" onPress={() => {}}>
          Press Me
        </DTButton>
      </DTCard>
    </DTThemeProvider>
  );
}

Tokens (JavaScript/TypeScript)

import { dt } from "@dangerousthings/tokens/brands/dt";
console.log(dt.color.brand.primary); // "#00ffff"

Tailwind

// tailwind.config.js
import dtPreset from "@dangerousthings/tailwind-preset";
export default {
  presets: [dtPreset],
  content: ["./src/**/*.{tsx,ts,html}"],
};

Development

Scripts

Command	Description
npm run build	Build all packages (Turbo)
npm run clean	Remove all dist/ directories
npm run typecheck	Run TypeScript type checking

Release

This project uses Changesets for versioning.

npx changeset              # create a new changeset
npm run version-packages   # bump versions from pending changesets
npm run release            # build + publish to npm

React Web Components

The @dangerousthings/react package provides React web components that wrap the CSS from @dangerousthings/web. The component API mirrors the React Native package for consistency:

DTAccordion, DTBadgeOverlay, DTButton, DTCard, DTCheckbox, DTChip, DTDrawer, DTFeatureLegend, DTGallery, DTHexagon, DTLabel, DTMediaFrame, DTMenu, DTMobileFilterOverlay, DTModal, DTProgressBar, DTQuantityStepper, DTRadioGroup, DTSearchInput, DTStaggerContainer, DTSwitch, DTTextInput

React Native Components

DTAccordion, DTBadgeOverlay, DTButton, DTCard, DTCheckbox, DTChip, DTDrawer, DTFeatureLegend, DTGallery, DTHexagon, DTLabel, DTMediaFrame, DTMenu, DTMobileFilterOverlay, DTModal, DTProgressBar, DTQuantityStepper, DTRadioGroup, DTSearchInput, DTStaggerContainer, DTSwitch, DTTextInput

Animation hooks: useScaleIn, usePulse

Web CSS Modules

• bevels.css — angular clip-path bevels, card modes, selected states, progress bars, badge overlays, interactive bevel buttons
• forms-dt.css — text inputs, checkboxes, radio buttons, switches, menu items, filter headers
• animations.css — entrance animations, stagger containers, transition utilities
• scrollbar.css — thin neon scrollbar styling
• feature-legend.css — product feature grid with rotated labels

Project Structure

dt-design-system/
├── packages/
│   ├── tokens/          # Design token definitions + CSS generation
│   ├── web/             # CSS themes and components
│   ├── react/           # React web components
│   ├── react-native/    # React Native Paper components
│   ├── tailwind-preset/ # Tailwind CSS v3 preset
│   ├── hex-background/  # 3D hexagon grid (Three.js)
│   └── showcase/        # Demo apps (desktop + mobile)
├── turbo.json           # Turbo pipeline config
└── package.json         # Workspace root

License

MIT