Skip to content
Back to search

nerv-ui

Typed React command-center components, live examples, and a portable coding-agent skill.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mdrbx--nerv-ui/badge.svg)](/listings/mdrbx--nerv-ui)

HTML

<a href="/listings/mdrbx--nerv-ui"><img src="/api/listings/mdrbx--nerv-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 267 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div id="user-content-toc">
  2. <ul align="center" style="list-style: none;">
  3. <summary>
  4. <h1>NERV-UI</h1><br>
  5. <h2>Typed React command-center components, plus a portable agent skill.</h2>
  6. <p>Build original, sharp industrial dashboards, terminals, and flows in React without rebuilding the design system from scratch.</p>
  7. </summary>
  8. </ul>
  9. </div>
  10. <p align="center">
  11. <img src="banner.png" alt="NERV-UI — Neon Genesis Evangelion Design System" width="100%" />
  12. </p>
  13. <p align="center">
  14. <img src="docs/references/readme-surveillance-preview.gif" alt="NERV-UI live surveillance preview" width="100%" />
  15. </p>
  16. <p align="center">
  17. <a href="https://www.npmjs.com/package/@mdrbx/nerv-ui"><img src="https://img.shields.io/npm/v/@mdrbx/nerv-ui?style=flat-square&color=FF9900&labelColor=000000" alt="npm version" /></a>
  18. <img src="https://img.shields.io/badge/components-48-00FF00?style=flat-square&labelColor=000000" />
  19. <img src="https://img.shields.io/badge/examples-18_pages-00FFFF?style=flat-square&labelColor=000000" />
  20. <img src="https://img.shields.io/badge/border--radius-0px-FF0000?style=flat-square&labelColor=000000" />
  21. <img src="https://img.shields.io/badge/license-MIT-FF9900?style=flat-square&labelColor=000000" />
  22. </p>
  23. <p align="center">
  24. <a href="https://mdrbx.github.io/nerv-ui/"><img src="https://img.shields.io/badge/LIVE_DEMO-00FFFF?style=for-the-badge&labelColor=000000" alt="Live Demo" /></a>
  25. &nbsp;
  26. <a href="https://skills.sh/mdrbx/nerv-ui/nerv-ui"><img src="https://img.shields.io/badge/INSTALL_AGENT_SKILL-00FF00?style=for-the-badge&labelColor=000000" alt="Install Agent Skill" /></a>
  27. &nbsp;
  28. <a href="https://mdrbx.github.io/nerv-ui/docs"><img src="https://img.shields.io/badge/DOCUMENTATION-FF9900?style=for-the-badge&labelColor=000000" alt="Documentation" /></a>
  29. </p>
  30. ---
  31. ## `> START_IN_30_SECONDS`
  32. **NERV-UI is a production React/TypeScript component library, a published npm package, 48 documented components, 18 live application examples, and a portable coding-agent skill.**
  33. - **Want an agent to build with it?** Install the skill with one command below.
  34. - **Want the React components?** Jump to [the npm install](#-install_in_a_react_project).
  35. - **Want to see it first?** Open the [live demo](https://mdrbx.github.io/nerv-ui/) or browse all [18 examples](https://mdrbx.github.io/nerv-ui/examples/).
  36. ### `> USE_WITH_AN_AI_CODING_AGENT`
  37. Install the canonical NERV-UI skill for your coding agent:
  38. ```bash
  39. npx skills add https://github.com/mdrbx/nerv-ui --skill nerv-ui
  40. ```
  41. The installer discovers supported agents and lets you choose where to install the skill. You can also [inspect NERV-UI on skills.sh](https://skills.sh/mdrbx/nerv-ui/nerv-ui) before installing it.
  42. The skill tells an agent when NERV-UI fits, installs the real npm package, uses only exported components, and includes dashboard, terminal, and authentication recipes.
  43. > **Try this prompt:** “Install `@mdrbx/nerv-ui` and build an accessible operations dashboard with `DataGrid`, `Gauge`, and `BarChart`; use original labels and respect reduced motion.”
  44. <details>
  45. <summary>Manual agent installation</summary>
  46. Clone the repository and copy the canonical skill directory to your agent's user-level skill path:
  47. ```bash
  48. git clone --depth 1 https://github.com/mdrbx/nerv-ui.git /tmp/nerv-ui-skill
  49. # Codex
  50. mkdir -p ~/.codex/skills
  51. cp -R /tmp/nerv-ui-skill/skills/nerv-ui ~/.codex/skills/nerv-ui
  52. # Hermes Agent
  53. mkdir -p ~/.hermes/skills
  54. cp -R /tmp/nerv-ui-skill/skills/nerv-ui ~/.hermes/skills/nerv-ui
  55. ```
  56. Inside this repository, compatible agents can discover the same canonical source through [`.agents/skills/nerv-ui`](.agents/skills/nerv-ui) and [`.claude/skills/nerv-ui`](.claude/skills/nerv-ui).
  57. </details>
  58. ### `> INSTALL_IN_A_REACT_PROJECT`
  59. ```bash
  60. npm install @mdrbx/nerv-ui framer-motion
  61. ```
  62. ```tsx
  63. import { Button, TerminalDisplay, Gauge } from "@mdrbx/nerv-ui";
  64. import "@mdrbx/nerv-ui/styles.css";
  65. export default function App() {
  66. return (
  67. <div className="bg-black min-h-screen p-8">
  68. <TerminalDisplay
  69. lines={[
  70. "MAGI SYSTEM v2.11",
  71. "> Initializing...",
  72. "> All systems online",
  73. ]}
  74. typewriter
  75. color="green"
  76. />
  77. <Gauge value={73} label="SYNC RATE" color="cyan" />
  78. <Button variant="danger" size="lg">
  79. INITIATE OVERRIDE
  80. </Button>
  81. </div>
  82. );
  83. }
  84. ```
  85. **Peer dependencies:** `react`, `react-dom`, `framer-motion`. Tailwind CSS is optional. NERV-UI is the useful middle ground between a style-only prompt and a bespoke CSS rebuild: you get typed, importable, tested component primitives plus working compositions.
  86. <details>
  87. <summary>Tailwind CSS preset (optional)</summary>
  88. ```js
  89. // tailwind.config.js
  90. import nervPreset from "@mdrbx/nerv-ui/tailwind.preset";
  91. export default {
  92. presets: [nervPreset],
  93. };
  94. ```
  95. </details>
  96. ---
  97. ## `> WHY_NERV_UI`
  98. - **Real React package:** `@mdrbx/nerv-ui` ships TypeScript declarations and package CSS—not a pasted stylesheet or a visual prompt.
  99. - **Build from complete flows:** the [live examples](https://mdrbx.github.io/nerv-ui/examples/) cover dashboards, monitoring, forms, auth, content, and error states.
  100. - **Agent-ready without lock-in:** one canonical `SKILL.md` steers compatible agents toward the published exports and documented recipes.
  101. - **Accessible motion baseline:** interactive components and examples are built in React, and the project’s styling accounts for `prefers-reduced-motion`.
  102. ---
  103. ## `> WHAT_IS_NERV_UI`
  104. NERV-UI is a **48-component React design system** published on npm for original CRT-era, command-center-inspired interfaces. Every pixel follows strict brutalist design rules:
  105. - **`border-radius: 0`** nearly everywhere — sharp industrial angles only
  106. - **NERV color palette** — black void, alert red, text orange, grid green, data cyan, magenta wave
  107. - **Condensed uppercase typography** — Oswald, Barlow Condensed, Noto Serif JP
  108. - **Monospace terminal text** — Fira Code for all data readouts
  109. - **EVA title-card compositions** — staged 4:3 layouts for ceremonial episode/finale screens
  110. - **CRT scanline overlay** — persistent retro phosphor effect
  111. - **Monitor overlays and targeting rails** — MAGI/NERV-inspired screen framing for dashboards, dialogs, and launch decks
  112. - **Animated hazard chevrons** — V-shaped stripe patterns for danger states
  113. - **Interactive chart surfaces** — hover-reactive bars, slices, gauges, and status bands with tactical tooltip overlays
  114. - **`prefers-reduced-motion`** — all animations respect accessibility settings
  115. ---
  116. ## `> COMPONENTS`
  117. **48 components** across 7 categories. Full API reference in the [documentation](https://mdrbx.github.io/nerv-ui/docs).
  118. | Category | Components |
  119. | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
  120. | **Layout** | `TargetingContainer`, `HexGridBackground`, `MonitorOverlay`, `Card`, `Accordion`, `Divider`, `Drawer`, `Breadcrumb` |
  121. | **Forms** | `Button`, `InputField`, `SelectMenu`, `Checkbox`, `Toggle`, `Textarea`, `RadioGroup`, `FileUpload` |
  122. | **Data Display** | `TerminalDisplay`, `DataGrid`, `SyncProgressBar`, `SegmentDisplay`, `Badge`, `Skeleton`, `PilotCard`, `Pagination` |
  123. | **Charts** | `BarChart`, `Gauge`, `PieChart`, `SyncRatioChart`, `PhaseStatusStack`, `GradientStatusBar` |
  124. | **Overlays** | `SystemDialog`, `ClassifiedOverlay`, `TitleScreen`, `NervToastProvider`, `StatusStamp`, `Tooltip`, `DropdownMenu` |
  125. | **Navigation** | `NavigationTabs`, `EmergencyBanner`, `Stepper` |
  126. | **HUD / Military** | `TargetingReticle`, `SurveillanceGrid`, `PatternAlert`, `MagiSystemPanel`, `SeeleMonolith`, `CountdownTimer`, `WireframeLoader`, `ThemeProvider` |
  127. > **[Browse all components →](https://mdrbx.github.io/nerv-ui/docs)**
  128. ---
  129. ## `> EXAMPLE_PAGES`
  130. **18 production-ready example pages** showcasing real-world usage patterns. All responsive.
  131. | Page | Description |
  132. | ------------------------------------------------------------------------------ | ----------------------------------------- |
  133. | [**Command Center**](https://mdrbx.github.io/nerv-ui/) | NERV HQ main dashboard with live data |
  134. | [**Operations Dashboard**](https://mdrbx.github.io/nerv-ui/examples/dashboard) | KPI cards, charts, gauges, operations log |
  135. | [**Comms Terminal**](https://mdrbx.github.io/nerv-ui/examples/comms) | Military chat interface with channels |
  136. | [**Dispatch Form**](https://mdrbx.github.io/nerv-ui/examples/form) | Multi-field form with validation |
  137. | [**Intelligence Bulletin**](https://mdrbx.github.io/nerv-ui/examples/blog) | Classified content feed with filtering |
  138. | [**Monitoring Station**](https://mdrbx.github.io/nerv-ui/examples/realtime) | Real-time sensor data & charts |
  139. | [**Video Intercept Deck**](https://mdrbx.github.io/nerv-ui/examples/surveillance) | Aggressive surveillance wall with pilot channels, MAGI, and phase rails |
  140. | [**Equipment Requisition**](https://mdrbx.github.io/nerv-ui/examples/inventory) | CRUD inventory management |
  141. | [**Pilot Dossier**](https://mdrbx.github.io/nerv-ui/examples/pilots) | Personnel profiles with sync history |
  142. | [**Mission Report**](https://mdrbx.github.io/nerv-ui/examples/report) | After-action document template |
  143. | [**MAGI File System**](https://mdrbx.github.io/nerv-ui/examples/files) | File browser with tree navigation |
  144. | [**SaaS Landing**](https://mdrbx.github.io/nerv-ui/examples/saas) | Marketing page with pricing |
  145. | [**Library Landing**](https://mdrbx.github.io/nerv-ui/examples/landing) | NERV-UI showcase page |
  146. | [**Ceremonial Splash**](https://mdrbx.github.io/nerv-ui/examples/splash) | Full-page EVA title-card splash screen |
  147. | [**Login**](https://mdrbx.github.io/nerv-ui/examples/auth/login) | Authentication terminal |
  148. | [**Register**](https://mdrbx.github.io/nerv-ui/examples/auth/register) | Personnel registration |
  149. | [**Help Center**](https://mdrbx.github.io/nerv-ui/examples/help) | FAQ with knowledge base |
  150. | [**Error 404**](https://mdrbx.github.io/nerv-ui/examples/error) | Signal lost page |
  151. > **[Explore all examples →](https://mdrbx.github.io/nerv-ui/examples)**
  152. ---
  153. ## `> DESIGN_TOKENS`
  154. ```
  155. COLOR HEX USAGE
  156. ─────────────────────────────────────────────
  157. nerv-black #000000 Background void
  158. nerv-red #FF0000 Emergency / alerts
  159. nerv-orange #FF9900 Primary text & UI
  160. nerv-green #00FF00 Terminal / grid lines
  161. nerv-cyan #00FFFF Data readouts
  162. nerv-magenta #FF00FF Waveform accents
  163. nerv-lcd-green #39FF14 LCD displays
  164. nerv-amber #FFAA00 Warning states
  165. nerv-purple #9933FF Special indicators
  166. TYPOGRAPHY FAMILY USAGE
  167. ─────────────────────────────────────────────────────────
  168. nerv-display Oswald, Impact Headers & labels
  169. nerv-mono Fira Code, JetBrains Mono Terminal & data
  170. nerv-body Barlow Condensed Body text
  171. nerv-title Noto Serif JP, Playfair Cinematic titles
  172. ```
  173. ---
  174. ## `> TECH_STACK`
  175. | Technology | Version | Role |
  176. | ------------- | ------- | --------------------------------- |
  177. | React | 19 | Functional components with Hooks |
  178. | TypeScript | 5.8 | Strict typing, all props exported |
  179. | Tailwind CSS | 4 | `@theme` design tokens |
  180. | Framer Motion | 12 | Animations & transitions |
  181. ---
  182. ## `> CONTRIBUTING`
  183. ```bash
  184. git clone https://github.com/mdrbx/nerv-ui.git
  185. cd nerv-ui
  186. npm install
  187. npm run dev # Dev server at localhost:3000
  188. npm run build:lib # Build the npm package
  189. npm run test # Run tests
  190. npm run type-check # TypeScript check
  191. ```
  192. See [CONTRIBUTING.md](CONTRIBUTING.md) for component patterns and design rules.
  193. ---
  194. ## `> CREDITS AND INSPIRATION`
  195. <p>NERV-UI is an independent fan-inspired open-source project. It is not affiliated with, endorsed by, or sponsored by the owners of Neon Genesis Evangelion or its related marks.</p>
  196. <p>MADE WITH [REDACTED] BY <a href="https://github.com/mdrbx">mdrbx</a></p>
  197. ---
  198. ## `> LICENSE`
  199. MIT License. See [LICENSE](./LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.