# Codex — Page Template for React

> A developer-tool docs landing template: slim nav, Cipher-scrambled headline, copy-to-clipboard install pill, a fake terminal that types a query session line-by-line, Kindle quickstart cards, a numbers-forward feature strip, CTA band, and footer — every string a prop, one emerald accent knob.

- Page: https://crucibleui.com/components/templates/codex
- Category: [templates](https://crucibleui.com/components/templates)
- Tier: pro (one-time purchase, see https://crucibleui.com/pricing)
- Engine: motion
- npm dependencies: motion

## Install

```bash
npx shadcn@latest add @crucible/codex
```

Pro install requires adding the token-bearing `@crucible` registry to components.json (issued at https://crucibleui.com/account after purchase).

Import from `@/components/crucible/codex`.

## Props (`CodexTemplateProps`)

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `brand?` | `string` | `"quill"` | Brand name in nav + footer. |
| `logo?` | `React.ReactNode` | `the Quill feather` | Inline logo mark (24×24, currentColor). |
| `nav?` | `CodexNavItem[]` | — | Top navigation links. |
| `headline?` | `string` | — | Hero headline. Plain string — it resolves via a Cipher scramble. |
| `subhead?` | `React.ReactNode` | — | Hero supporting line. |
| `installCommand?` | `string` | — | The copy-to-clipboard install one-liner. |
| `terminalTitle?` | `string` | — | Terminal window title. |
| `terminalLines?` | `CodexTerminalLine[]` | — | The fake query session typed out in the terminal panel. |
| `quickstart?` | `CodexQuickstartCard[]` | — | Quickstart cards (rendered as Kindle spotlight cards). |
| `features?` | `CodexFeature[]` | — | Feature bullets with precise numbers. |
| `ctaHeadline?` | `React.ReactNode` | — | Closing CTA band copy. |
| `ctaSubhead?` | `React.ReactNode` | — | — |
| `primaryCta?` | `CodexAction` | `"Install Quill"` | Primary action (hero + CTA band). |
| `secondaryCta?` | `CodexAction` | `"Read the docs"` | Secondary action (hero + CTA band). |
| `footerLinks?` | `CodexNavItem[]` | — | Footer links. |
| `footerNote?` | `React.ReactNode` | — | Footer legal line. |
| `accent?` | `string` | `"#34d399" (cool emerald)` | Signature hue, any CSS color. |

Also accepts: `Omit<React.ComponentPropsWithoutRef<"main">, "children">`.

## Usage example

```tsx
import { CodexTemplate } from "@/components/crucible/codex";

export default function CodexTemplateDemo() {
  return (
    <div className="relative isolate h-[560px] w-full overflow-hidden rounded-xl bg-neutral-950">
      <CodexTemplate className="h-full overflow-y-auto overflow-x-hidden overscroll-contain" />
    </div>
  );
}
```

## Accessibility & performance

Honors `prefers-reduced-motion` with a designed static frame or fade (never a blank box) and passes `className` through.
