---
id: "codex://object/codex-glyph-grammar"
archive_id: "codex-glyph-grammar"
slug: "codex-glyph-grammar"
url: "https://ndcodex.com/objects/codex-glyph-grammar/"
type: "codex"
title: "Codex Glyph Grammar: Symbol Generation Rules"
summary: "Object metadata becomes visual structure."
date_published: "2026-03-08T23:35:21.209Z"
date_modified: "2026-03-08T23:35:21.209Z"
status: "published"
visibility: "public"
language: "en-US"
axes: {}
themes:
  - "systems"
  - "architecture"
  - "methodology"
  - "structure"
  - "signal"
constellations: []
tags:
  - "systems"
  - "architecture"
  - "methodology"
  - "structure"
  - "signal"
keywords:
  - "Codex"
  - "systems"
  - "architecture"
  - "methodology"
  - "structure"
  - "signal"
author:
  id: "nathan-davis"
  name: "Nathan Davis"
  designation: "Archive Operator"
  role: "Archive Operator"
  handle: "@nathandavis"
  avatar: "/media/people/nathan-davis.jpg"
  bio: "Designer, builder, and curator of the Codex Archive."
contributors:
  - id: "nathan-davis"
    name: "Nathan Davis"
    designation: "Archive Operator"
    role: "Archive Operator"
    handle: "@nathandavis"
    avatar: "/media/people/nathan-davis.jpg"
    bio: "Designer, builder, and curator of the Codex Archive."
relations:
  - kind: "related"
    target: "codex://object/codex-glyph-system-first-emergence"
    slug: "codex-glyph-system-first-emergence"
    url: "https://ndcodex.com/objects/codex-glyph-system-first-emergence/"
  - kind: "related"
    target: "codex://object/codex-archive-system-v3-plus-notes"
    slug: "codex-archive-system-v3-plus-notes"
    url: "https://ndcodex.com/objects/codex-archive-system-v3-plus-notes/"
  - kind: "related"
    target: "codex://object/the-bones-hold-content-architecture"
    slug: "the-bones-hold-content-architecture"
    url: "https://ndcodex.com/objects/the-bones-hold-content-architecture/"
  - kind: "related"
    target: "codex://object/steel-elbow-flinchian"
    slug: "steel-elbow-flinchian"
    url: "https://ndcodex.com/objects/steel-elbow-flinchian/"
  - kind: "dependency"
    target: "codex://object/codex-glyph-system-first-emergence"
    slug: "codex-glyph-system-first-emergence"
    url: "https://ndcodex.com/objects/codex-glyph-system-first-emergence/"
media: []
---
This document defines the symbolic grammar used to generate Codex glyphs.

## Principle

Objects generate symbols.

front matter -> parameters -> glyph

## Base Geometry by Object Type

signal -> burst / rays / spark geometry
scroll -> spiral / unfolding paths
artifact -> shards / planes
fragment -> seed / broken loop
fieldlog -> measured marks
codex -> grid / frame / reference spine
nexus -> clustered orbit / relational ring

## Theme Modifiers

Themes modify base geometry.

fire -> angular sparks
water -> curved flows
signal -> node clusters
recursion -> spiral emphasis
city -> rectilinear grid bias
forest -> branching organic bias
grief -> interrupted lines

## Status Modifiers

draft -> partial closure
review -> balanced tension
published -> stabilized geometry
archived -> dimmed enclosure

## Deterministic Seed

Glyph variation derives from a deterministic seed.

seed = hash(object id)

This ensures the same object always produces the same glyph.

## Output

Current flow produces:

- hero glyph SVG

The same seed can later drive icon and monochrome variants without changing the object's mark.

## Application in Flow

1. Draft the object in `inbox/ready/`.
2. Generate the glyph from the draft metadata:

   `node scripts/generate-codex-glyph.mjs --source inbox/ready/<file>.md`

3. Add the emitted `/media/...svg` path to the object's `media` block when the glyph should ship with the post.
4. After review and explicit approval, publish through the normal hand-off:

   `node scripts/finalize-approved-ready.mjs --source inbox/ready/<file>.md --note "<approval reason>"`

The Codex becomes a system where each object bears a symbolic mark.