Layer 1
The Compositional Rules
Phonetics & Grammar (Śikṣā & Vyākaraṇa)
1.1 · Visual Phonetics — The Atomic Primitives (Dhātus)
Every icon in Digital SanSkrit derives from irreducible visual phonemes — not arbitrary shapes, but semantic primitives with fixed meaning fields, analogous to Sanskrit roots that carry the core semantic charge.
| Phoneme | Parallel | Semantic Field | Specification |
|---|---|---|---|
| Circle ○ | Bindu | State, presence, node, entity | 2px stroke; perfect geometry; no fill = potential, fill = actualized |
| Square □ | Bhūmi | Container, boundary, scope, module | 2px stroke; 90° corners; rounded = soft, sharp = hard |
| Triangle △ | Agni / Śikhā | Direction, alert, transformation, priority | Up = ascending, Down = completed, Right = proceed |
| Line — | Rekhā | Connection, flow, dependency, sequence | 1px = optional · 2px = standard · 4px = critical |
| Arc ⌒ | Chandra | Cycle, return, iteration, pending | Open = incomplete, closed = complete cycle |
| Cross +/× | Kṣata | Termination, intersection, error, merge | Plus = additive merge · X = conflict / blocking |
Rule 1.1 — The Dhātu-Sūtra
No icon may introduce a new primitive without approval from the Principal Designer (the grammarian). All compound icons must decompose to these six roots.
Rule 1.2 — The Svara-Rule
Orientation carries meaning. A triangle pointing up (△) and down (▽) are distinct phonemes, not variants of the same icon.
1.2 · Morphology — Icon Construction (Samāsa)
Digital SanSkrit uses six compound types, each with strict compositional syntax.
1. Avyayībhāva — Adverbial / Modifier Prefix
A small badge (≤20% of base icon area) prepended to alter the base meaning without changing its core identity. Syntax: [Modifier] + [Base]. The base retains identity; the modifier adds modality.
| Badge | Meaning |
|---|---|
| Dot (•) | Active / current |
| Exclamation (!) | Error / alert |
| Check (✓) | Verified / complete |
| Clock (◷) | Pending / temporal |
| Lock (🔒) | Restricted / private |
2. Tatpuruṣa — Determinative / Attributive
A base icon qualified by a second icon that narrows its semantic scope. Syntax: [Qualifier] → [Base]. The base is the head; the qualifier specifies. Example: □ + 👤 = user-container.
3. Karmadhāraya — Descriptive / Appositional
Two icons of equal semantic weight fused into a single glyph where both modify each other. Syntax: [A] ≈ [B] with 50% overlap. Example: ⚡ + ○ = active-energy-state.
4. Dvigu — Numerical / Quantitative
A numerical indicator (stroke count, dot count, small numeral) modifying the base. Quantification without changing base identity. Example: ●●● + □ = triple-container.
5. Bahuvrīhi — Exocentric / Relational
The compound refers to something outside both components — a relationship or system property. Syntax: [A] ↔ [B]. Example: ○—○ = dependency. Neither circle is the meaning; the connection is.
6. Āmreḍita — Iterative / Reduplicative
Repetition of the same icon to indicate plurality, intensity, or distribution. Example: ○ ○ ○ = multiple states or distributed nodes.
1.3 · Syntax — Spatial Grammar (Vākya)
How icons relate in space carries grammatical meaning.
| Relation | Parallel | Meaning |
|---|---|---|
| Adjacency | Sāmāsika | Co-occurrence, grouping, shared context |
| Containment | Upamāna | Subordination, instance-of, scoped context |
| Connection | Sambandha | Causal link, dependency, data flow |
| Opposition | Virodha | Conflict, mutual exclusion, alternative |
| Sequence | Krama | Process, timeline, pipeline |
| Radiation | Maṇḍala | Hierarchy, hub-and-spoke, central control |
Rule 1.3 — The Sandhi-Rule
When two icons meet (adjacency or connection), their shared boundary must resolve visually — through overlap, gap, or fusion — never ambiguous touching. This is the euphonic combination of visual language.
1.4 · Semantics — Domain Ontology (Śāstra)
The Principal Designer defines the closed-system ontology — what concepts exist in the high-tech product domain and how they map to icon compounds.
| Concept | Glyph | Derivation |
|---|---|---|
| Task | □ | Atomic — square as unit of work |
| Milestone | ◇ | Derived — rotated square = significant checkpoint |
| Sprint | ⌒□⌒ | Bahuvrīhi — temporal bracket around work |
| Dependency | ○—▷○ | Bahuvrīhi — directional relationship |
| Blocker | ○×○ | Karmadhāraya — conflict between states |
| Review | ○◷ | Tatpuruṣa — state qualified by time |
| Deploy | △→□ | Avyayībhāva — directional action on container |
| Rollback | □←△ | Reverse deploy syntax |
Rule 1.4 — The Śāstra-Rule
The ontology is versioned. New concepts require a new sūtra explaining their derivation from existing dhātus. No orphan icons allowed.
Layer 2
The Training Methodology
Teacher–Student Lineage (Guru-Śiṣya Paramparā)
DesignOps training for Digital SanSkrit follows a graded fluency model — from recognition to composition to grammaticality judgment.
Stage 1 · Devanāgarī Recognition (Weeks 1–2)
Goal: sight-read the 6 dhātus and 20 most common compounds.
- Flashcard drilling: glyph → name concept → decompose to dhātus.
- Error highlighting: identify violations of the sandhi-rules.
- Speed tests: 50 glyphs in 2 minutes with 95% accuracy.
Deliverable: Certification as Śikṣā-vid — phonetics-knower.
Stage 2 · Samāsa Composition (Weeks 3–4)
Goal: build correct compounds from concept descriptions.
- Prompted construction: “Design a glyph for urgent-review-of-blocked-deployment.”
- Peer review pairs: Generator proposes, Synthesizer validates against sūtras.
- Red-team testing: apply compounds in ambiguous contexts to break them.
Deliverable: Certification as Samāsa-kāra — compound-maker.
Stage 3 · Vākya Arrangement (Weeks 5–6)
Goal: compose multi-icon sentences for dashboard and task-board layouts.
- Spatial grammar exercises: arrange 5–10 icons to represent a sprint workflow.
- Ambiguity resolution: defend the clearer of two valid arrangements via sandhi-rules.
- Cross-functional translation: measure comprehension without verbal explanation.
Deliverable: Certification as Vākya-vid — sentence-knower.
Stage 4 · Śāstra Authority (Ongoing)
Goal: Principal Designer level — ability to extend the language.
- Sūtra drafting for new dhātus or samāsa types.
- Ontology mapping of new product domain concepts.
- Governance: review Samāsa-kāra proposals; approve or reject with sūtra citations.
- Paramparā teaching: mentor two Śikṣā-vids to Śāstra level.
Deliverable: Title of Vyākaraṇa-ācārya — grammar-master.
Training Artifacts
| Artifact | Format | Purpose |
|---|---|---|
| Dhātu-Pāṭha | Figma file + printed cards | Reference for the 6 primitives with stroke specs |
| Samāsa-Kośa | Searchable database | All approved compounds with derivation trees |
| Sūtra-Saṅgraha | Markdown + plugin docs | Formal grammar rules with visual examples |
| Vyākhyā | Video + written | Commentary on the rationale behind each rule |
| Parīkṣā | Automated + peer-reviewed | Certification tests at each stage |
Layer 3
Technical Enforcement Tooling
Guardian of the Canon (Śāstra-Rakṣaka)
3.1 · Figma Plugin Architecture — The Digital SanSkrit Linter
Category A · Dhātu Validation (Primitive Integrity)
Every icon must decompose to the approved 6 primitives. Reject any custom SVG path not matching canonical primitive geometry. ERROR — blocks component publish.
Category B · Samāsa Validation (Compound Legality)
Compounds must follow one of the 6 samāsa types with correct syntax: modifier badges ≤20% base area; overlap percentages matching their samāsa type; no unapproved dhātu combinations. WARNING for drafts; ERROR when published to library.
Category C · Vākya Validation (Spatial Grammar)
Adjacent icons must resolve sandhi (no ambiguous 1px gaps). Connection lines must terminate at canonical anchor points. Containment must respect hierarchy — no circular containment.
3.2 · Plugin Feature Specification
| Feature | Implementation |
|---|---|
| Real-time linting | On-selection and on-change event hooks |
| Custom rule engine | JSON rule definitions for each sūtra |
| Auto-fix suggestions | One-click correction for common violations |
| Batch audit | Full-file scan with report generation |
| Token integration | Design tokens synced to canonical values (W3C export) |
| Version governance | Sūtra versioning with breaking-change detection |
| Usage analytics | Track active compounds; surface orphans |
3.3 · CI/CD Pipeline Integration
Figma File → SanSkrit Linter → Token Export → Code Generation → Platform Render
↓ ↓ ↓
[ERROR / WARN] [W3C JSON] [React / Swift / XML]
Block if ERROR semantic platform-specific
tokens icon librariesClosed system (internal tooling): linter runs in Figma only; no export. Open system (product surfaces): linter gates the token export pipeline; violations block release.
3.4 · Enforcement Severity Matrix
| Violation | Closed System | Open System |
|---|---|---|
| Unapproved dhātu | Block publish | Block token export |
| Illegal samāsa | Flag for review | Block token export |
| Sandhi ambiguity | Warning | Warning (auto-fix) |
| Ontology orphan | Block publish | Block token export |
| Accessibility failure | Warning | Block token export |
| Token mismatch | — | Block token export |
3.5 · Principal Designer Dashboard
| Widget | Function |
|---|---|
| Sūtra Registry | Active rules with version history and deprecation status |
| Dhātu Health | Usage frequency of each primitive; proposals for new dhātus |
| Samāsa Adoption | Heatmap of compound usage; identify orphans |
| Vākya Clarity Scores | Comprehension metrics from cross-functional testing |
| Paramparā Tracker | Certification pipeline by stage; mentoring queue |
| Breaking-Change Impact | Show which compounds a new sūtra would affect |
In summary
The Three Layers in Practice
| Layer | Parallel | Modern Equivalent | Output |
|---|---|---|---|
| Compositional Rules | Śikṣā · Vyākaraṇa · Śāstra | Token architecture, icon spec, ontology mapping | A formally defined visual language with generative capacity |
| Training Methodology | Guru-Śiṣya Paramparā | DesignOps certification with peer review and progressive mastery | Designers who read, write, and extend the language fluently |
| Technical Enforcement | Śāstra-Rakṣaka | Figma linter + CI/CD pipeline + governance dashboard | Automated prevention of language drift and degradation |
Digital SanSkrit succeeds when these three layers operate as a closed system internally — the Principal Designer controls the grammar, training produces fluent practitioners, and tooling enforces compliance. The open system exports only the rendered output to external platforms, never the grammar itself. This preserves linguistic integrity while enabling broad deployment.
एक भाषा, अनन्त रूप · One language, infinite forms.