Sigilix · damartinezjulio · Jul 12, 2026 · Jul 12, 2026 · Jul 12, 2026
diff --git a/components/Cards.tsx b/components/Cards.tsx
@@ -0,0 +1,36 @@
+import NextLink from "next/link";
+import type { ComponentPropsWithoutRef, ReactNode } from "react";
+
+/**
+ * Navigational card grid.
+ *
+ * Replaces Nextra's <Cards> because Nextra 3's Cards.Card renders `children`
+ * *before* the title span — its `children` slot is designed to hold a preview
+ * image, not a description. Our docs use `children` as descriptive text, so the
+ * upstream order puts the description above the title and leaves the
+ * description unpadded (only the title span carries Nextra's padding).
+ *
+ * This renders title first, then the description body, with a single padding
+ * box on the card itself. Visual style intentionally mirrors <FeatureCards>.
+ */
+export function Cards({ children }: { children: ReactNode }) {
+  return <div className="sig-cards _not-prose">{children}</div>;
+}
+
+type CardProps = {
+  title: string;
+  href: string;
+  children?: ReactNode;
+} & Omit<ComponentPropsWithoutRef<typeof NextLink>, "href" | "title">;
+
+function Card({ title, href, children, ...props }: CardProps) {
+  return (
+    <NextLink href={href} className="nextra-focus sig-card" {...props}>
+      <span className="sig-card-title">{title}</span>
+      {children ? <div className="sig-card-body">{children}</div> : null}
+    </NextLink>
+  );
+}
+
+Cards.displayName = "Cards";
+Cards.Card = Card;
diff --git a/pages/cli-and-chat/bring-your-own-models.mdx b/pages/cli-and-chat/bring-your-own-models.mdx
@@ -3,7 +3,8 @@ title: "Bring Your Own Key"
 description: "On paid tiers, run the Sigilix CLI on your own model-provider key — Anthropic Claude, OpenAI GPT, or another provider you already use. You pay the provider directly. Read the grounding trade-off first: BYOK swaps model choice for the strongest grounding guarantee."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Bring Your Own Key

diff --git a/pages/cli-and-chat/cli.mdx b/pages/cli-and-chat/cli.mdx
@@ -3,7 +3,8 @@ title: "Sigilix CLI"
 description: "Review parity in the terminal. The Sigilix CLI runs the same four-specialist ensemble and believability gates as the hosted GitHub App against your local changes — before you ever open a PR — reaching for the earned context every hosted review built."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Sigilix CLI

diff --git a/pages/cli-and-chat/commands.mdx b/pages/cli-and-chat/commands.mdx
@@ -3,7 +3,8 @@ title: "CLI Command Reference"
 description: "The Sigilix CLI commands — review, run, login/whoami/logout, providers, and models. Representative usage for reviewing changes and driving the grounded agent from the terminal."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # CLI Command Reference
 

diff --git a/pages/cli-and-chat/deep-research.mdx b/pages/cli-and-chat/deep-research.mdx
@@ -3,7 +3,8 @@ title: "Deep-Research Chat"
 description: "A chat grounded in your repo and its review history. Ask why a finding fired, what a change affects, or how a subsystem fits together — answers are anchored in the index, code graph, and past reviews and their proof-tier receipts, not guessed."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Deep-Research Chat

diff --git a/pages/cli-and-chat/models.mdx b/pages/cli-and-chat/models.mdx
@@ -3,7 +3,8 @@ title: "The Sigilix Models"
 description: "Boreas, Pyroeis, Astraeus — and Phanes, coming soon. Sigilix's model lineup for the CLI and agent surfaces: one agent contract, tiered capability, served through Sigilix's managed gateway."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # The Sigilix Models

diff --git a/pages/cli-and-chat/overview.mdx b/pages/cli-and-chat/overview.mdx
@@ -3,7 +3,8 @@ title: "CLI & Chat"
 description: "Sigilix in the terminal — review parity from the command line, plus a Deep-Research Chat grounded in your repo and its review history. Run it on Sigilix's own hosted models, or bring your own provider key (Anthropic, OpenAI) on paid tiers."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # CLI & Chat

diff --git a/pages/configuration/commands.mdx b/pages/configuration/commands.mdx
@@ -3,7 +3,8 @@ title: "Slash Commands"
 description: "/sigilix review, improve, describe, and help — what each command does, when to use it, and how to override prompts and models per-repo via sigilix.json."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Slash Commands
 

diff --git a/pages/configuration/configuration-reference.mdx b/pages/configuration/configuration-reference.mdx
@@ -3,7 +3,8 @@ title: "Configuration file"
 description: "Per-repo configuration reference. Drop a sigilix.json or sigilix.yaml at the repo root to inject guidance, scope reviews, encode deterministic rules, and toggle subsystems."
 ---
 
-import { Callout, Cards, Tabs } from 'nextra/components'
+import { Callout, Tabs } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Configuration file
 

diff --git a/pages/configuration/deterministic-checks-config.mdx b/pages/configuration/deterministic-checks-config.mdx
@@ -3,7 +3,7 @@ title: "Writing Deterministic Checks"
 description: "Practical guide to the `deterministicChecks` field in sigilix.json: regex syntax, severity mapping, examples, and the gotchas that bite people."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Writing Deterministic Checks
 

diff --git a/pages/configuration/models-and-usage.mdx b/pages/configuration/models-and-usage.mdx
@@ -3,7 +3,8 @@ title: "Models & Usage"
 description: "Why Sigilix usage windows are far larger than a comparable OpenAI or Claude plan — the models we run, how to pick one, and the 5-day reset cadence."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Models & Usage

diff --git a/pages/configuration/opt-outs.mdx b/pages/configuration/opt-outs.mdx
@@ -3,7 +3,7 @@ title: "Opt-outs"
 description: "Consolidated reference for disabling Sigilix subsystems per-repo. Every subsystem ships enabled by default; each has its own `{ enabled: false }` switch in sigilix.json."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Opt-outs
 

diff --git a/pages/configuration/path-filters-and-profile.mdx b/pages/configuration/path-filters-and-profile.mdx
@@ -3,7 +3,8 @@ title: "Path Filters & Profile"
 description: "Scope reviews to the files that matter with `pathFilters`, and tune flag-worthiness with `profile`. Both shipped in sigilix.json v2 (ARC-176)."
 ---
 
-import { Cards, Tabs } from 'nextra/components'
+import { Tabs } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Path Filters & Profile
 

diff --git a/pages/configuration/rate-limits.mdx b/pages/configuration/rate-limits.mdx
@@ -3,7 +3,8 @@ title: "Rate Limits"
 description: "How the rolling window works, burst behavior, monitoring usage, and what happens when you hit the cap."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Rate Limits
 

diff --git a/pages/configuration/rules-and-guidance.mdx b/pages/configuration/rules-and-guidance.mdx
@@ -3,7 +3,8 @@ title: "Rules & Guidance"
 description: "How to write the `guidance` and `rules.<role>` strings that shape every specialist's prompt for your repo."
 ---
 
-import { Cards, Tabs } from 'nextra/components'
+import { Tabs } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Rules & Guidance
 

diff --git a/pages/evidence-and-provenance/dependency-vulnerabilities.mdx b/pages/evidence-and-provenance/dependency-vulnerabilities.mdx
@@ -3,7 +3,7 @@ title: "Dependency Vulnerabilities"
 description: "Sigilix scans npm dependencies against a bundled vulnerability database on every review. Range-aware, transitive-aware, runs without external API calls (ARC-186)."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Dependency Vulnerabilities
 

diff --git a/pages/evidence-and-provenance/review-provenance.mdx b/pages/evidence-and-provenance/review-provenance.mdx
@@ -3,7 +3,8 @@ title: "Review Provenance & Stale Markers"
 description: "Every Sigilix review carries a manifest of which specialists, models, and evidence channels produced it. Reviews on stale SHAs are marked, never silently re-used (ARC-184)."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Review Provenance & Stale Markers
 

diff --git a/pages/evidence-and-provenance/sarif-evidence.mdx b/pages/evidence-and-provenance/sarif-evidence.mdx
@@ -3,7 +3,7 @@ title: "SARIF Evidence"
 description: "Upload SARIF reports as PR artifacts and Sigilix injects their high-severity findings into the synthesizer as authoritative evidence. Trivy + generic SARIF v2.1.0 (ARC-188)."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # SARIF Evidence
 

diff --git a/pages/evidence-and-provenance/secret-scanning.mdx b/pages/evidence-and-provenance/secret-scanning.mdx
@@ -3,7 +3,7 @@ title: "Secret Scanning"
 description: "Sigilix's built-in regex sweep for hardcoded provider credentials, run before the LLM specialists fire (ARC-187)."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Secret Scanning
 

diff --git a/pages/getting-started/first-review.mdx b/pages/getting-started/first-review.mdx
@@ -3,7 +3,8 @@ title: "Anatomy of a Review"
 description: "What every Sigilix review contains — synthesizer summary, inline findings, severity badges, proof-tier pills, suggested patches — and how to read it."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Anatomy of a Review
 

diff --git a/pages/getting-started/quickstart.mdx b/pages/getting-started/quickstart.mdx
@@ -3,7 +3,8 @@ title: "Quickstart"
 description: "Install the Sigilix GitHub App and get your first review in minutes."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Quickstart
 

diff --git a/pages/how-it-works/believability-pipeline.mdx b/pages/how-it-works/believability-pipeline.mdx
@@ -3,7 +3,8 @@ title: "The Believability Pipeline"
 description: "Five gates between a model's hunch and a comment on your PR: evidence, provenance contracts, refute/execute, proof-tier receipts, and memory. A finding cannot post unless it earns it."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # The Believability Pipeline

diff --git a/pages/how-it-works/code-graph.mdx b/pages/how-it-works/code-graph.mdx
@@ -3,7 +3,8 @@ title: "The Code Graph & Blast Radius"
 description: "How Sigilix knows what a change actually affects — a per-repo symbol graph with import and call edges, a semantic code index, and blast-radius analysis that expands every diff into its real consequences."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # The Code Graph & Blast Radius

diff --git a/pages/how-it-works/confidence-scoring.mdx b/pages/how-it-works/confidence-scoring.mdx
@@ -3,7 +3,8 @@ title: "Confidence & Proof Tiers"
 description: "How Sigilix decides whether a finding has earned the right to post — proof-tier receipts (VERIFIED / REPRODUCED / GROUNDED / MODEL) and the grounding gate, not a numeric score."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Confidence & Proof Tiers
 

diff --git a/pages/how-it-works/deterministic-checks.mdx b/pages/how-it-works/deterministic-checks.mdx
@@ -3,7 +3,7 @@ title: "Deterministic Checks"
 description: "The pre-LLM signal layer — regex rules, AST scanners, and secret detection run on the diff before any specialist fires. Why Sigilix grounds its specialists on deterministic signal first."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Deterministic Checks
 

diff --git a/pages/how-it-works/earned-context.mdx b/pages/how-it-works/earned-context.mdx
@@ -3,7 +3,8 @@ title: "Earned Context"
 description: "Every review deposits a reusable, verified understanding of your repo — index, code graph, trust ledger, review memory, evidence manifests. The CLI, Deep-Research Chat, and Triage all draw on it."
 ---
 
-import { Callout, Cards } from 'nextra/components'
+import { Callout } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Earned Context

diff --git a/pages/how-it-works/review-lifecycle.mdx b/pages/how-it-works/review-lifecycle.mdx
@@ -3,7 +3,7 @@ title: "Review Lifecycle"
 description: "From webhook delivery to posted review — the stages a Sigilix review goes through and the guarantees at each stage."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Review Lifecycle
 

diff --git a/pages/how-it-works/sdk-guidance.mdx b/pages/how-it-works/sdk-guidance.mdx
@@ -3,7 +3,8 @@ title: "SDK Guidance"
 description: "When a PR touches a supported vendor SDK, Sigilix layers in that SDK's correct-usage rules — self-authored from the vendor's public docs — so the review catches SDK-specific footguns a generic reviewer misses. Findings link back to the exact docs page."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # SDK Guidance

diff --git a/pages/how-it-works/specialists.mdx b/pages/how-it-works/specialists.mdx
@@ -3,7 +3,7 @@ title: "Specialists"
 description: "logic, security, performance, tests — what each domain specialist catches, sample findings, and how models are selected."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Specialists
 

diff --git a/pages/how-it-works/synthesizer.mdx b/pages/how-it-works/synthesizer.mdx
@@ -3,7 +3,7 @@ title: "Synthesizer"
 description: "The synthesizer's four-stage pipeline: collect → cross-reference → calibrate → render. How four specialist streams become one coherent, believable review."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # Synthesizer
 

diff --git a/pages/how-it-works/the-dispatcher.mdx b/pages/how-it-works/the-dispatcher.mdx
@@ -3,7 +3,8 @@ title: "The Dispatcher"
 description: "One webhook, many pipelines. A single GitHub or Linear event is routed to the pipeline it deserves — so a cheap PR overview never waits behind the full four-specialist ensemble."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # The Dispatcher

diff --git a/pages/how-it-works/the-ensemble.mdx b/pages/how-it-works/the-ensemble.mdx
@@ -3,7 +3,7 @@ title: "The Ensemble"
 description: "Why Sigilix runs four domain specialists unified by a synthesizer rather than a single-generalist design — the architectural argument with concrete examples."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # The Ensemble
 

diff --git a/pages/how-it-works/verification.mdx b/pages/how-it-works/verification.mdx
@@ -3,7 +3,8 @@ title: "Verification & the Trust Ledger"
 description: "How findings are proven rather than asserted — evidence re-checking, a sealed execution sandbox that reproduces bugs, receipt-joining with your own CI, and the trust ledger that records how every finding earned its tier."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Verification & the Trust Ledger

diff --git a/pages/index.mdx b/pages/index.mdx
@@ -3,7 +3,8 @@ title: "Introduction"
 description: "Sigilix is a hosted GitHub App that runs a four-specialist ensemble on every PR, behind a believability pipeline that lets a finding post only once it earns it. Here's what it catches, how it's built, and why it's not just another AI reviewer."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 <div className="sig-docs-home-hero">

diff --git a/pages/integrations/github.mdx b/pages/integrations/github.mdx
@@ -3,7 +3,7 @@ title: "GitHub"
 description: "Sigilix's primary integration. Permissions, branch protection, required checks, and multi-repo install."
 ---
 
-import { Cards } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # GitHub
 

diff --git a/pages/integrations/gitlab.mdx b/pages/integrations/gitlab.mdx
@@ -3,7 +3,8 @@ title: "GitLab"
 description: "Connect a GitLab project in one click — Sigilix sets up the merge-request webhook and review token automatically, and the same review ensemble runs on every MR."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 
 # GitLab
 

diff --git a/pages/memory/compounding-advantage.mdx b/pages/memory/compounding-advantage.mdx
@@ -3,7 +3,8 @@ title: "The Compounding Advantage"
 description: "Sigilix tunes its own models — and your organization's accumulated context is the fuel they compound on. As learnings, earned context, semantic recall, and review memory build up per org, every subsequent review by the same tuned models is better-informed and more tailored to your codebase."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # The Compounding Advantage

diff --git a/pages/memory/conversational-learnings.mdx b/pages/memory/conversational-learnings.mdx
@@ -3,7 +3,8 @@ title: "Conversational Learnings"
 description: "Teach Sigilix a rule in plain language — reply to a finding with 'we use integer cents here' — and it records the rule, applies it judiciously in later reviews, and attributes it inline when it does."
 ---
 
-import { Callout, Cards, Steps } from 'nextra/components'
+import { Callout, Steps } from 'nextra/components'
+import { Cards } from '@/components/Cards'
 import { FeatureCards, FeatureCard } from '@/components/FeatureCards'
 
 # Conversational Learnings